README に戻る

QQ

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

設定

json

{
  "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 でボットを検索して会話を始める

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