mirror of https://github.com/sipeed/picoclaw.git synced 2026-06-12 18:08:54 +00:00

Files

T

Cytown 667fc85d54 refactor(config): make config.Channel to multiple instance support

add new field type to Channel struct
config.channels refactor to channel_list
update config version to 3
update the docs

2026-04-13 22:21:21 +08:00

2.8 KiB

Raw Blame History

README に戻る

QQ

PicoClaw は QQ オープンプラットフォームの公式 Bot API を通じて QQ をサポートします。

設定

{
  "channel_list": {
    "qq": {
      "enabled": true,
      "type": "qq",
      "app_id": "YOUR_APP_ID",
      "app_secret": "YOUR_APP_SECRET",
      "allow_from": []
    }
  }
}

フィールド	型	必須	説明
enabled	bool	はい	QQ チャンネルを有効にするかどうか
app_id	string	はい	QQ ボットアプリケーションの App ID
app_secret	string	はい	QQ ボットアプリケーションの App Secret
allow_from	array	いいえ	許可するユーザーIDのリスト。空の場合はすべてのユーザーを許可

セットアップ手順

クイックセットアップ（推奨）

QQ オープンプラットフォームにはワンクリック作成エントリーが用意されています：

QQ ボットクイック作成を開き、QR コードをスキャンしてログインする
システムが自動的にボットを作成するので、App ID と App Secret をコピーする
PicoClaw 設定ファイルに認証情報を入力する
picoclaw gateway を実行してサービスを起動する
QQ を開いてボットとの会話を始める

App Secret は一度しか表示されません。すぐに保存してください。再度表示しようとすると強制的にリセットされます。

クイックエントリーで作成したボットは作成者本人のみが使用でき、グループチャットには対応していません。グループチャット機能が必要な場合は、QQ オープンプラットフォームでサンドボックスモードを設定してください。

手動セットアップ

QQ アカウントで QQ オープンプラットフォームにログインし、開発者アカウントを登録する
QQ ボットを作成し、アバターと名前をカスタマイズする
ボット設定から App ID と App Secret を取得する
PicoClaw 設定ファイルに認証情報を入力する
picoclaw gateway を実行してサービスを起動する
QQ でボットを検索して会話を始める

開発段階ではサンドボックスモードを有効にし、テストユーザーとグループをサンドボックスに追加してデバッグすることを推奨します。

2.8 KiB Raw Blame History

QQ

設定

セットアップ手順

クイックセットアップ（推奨）

手動セットアップ

2.8 KiB

Raw Blame History