> [README](../../project/README.ja.md) に戻る

# 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 オープンプラットフォームにはワンクリック作成エントリーが用意されています：

1. [QQ ボットクイック作成](https://q.qq.com/qqbot/openclaw/index.html) を開き、QR コードをスキャンしてログインする
2. システムが自動的にボットを作成するので、**App ID** と **App Secret** をコピーする
3. PicoClaw 設定ファイルに認証情報を入力する
4. `picoclaw gateway` を実行してサービスを起動する
5. QQ を開いてボットとの会話を始める

> App Secret は一度しか表示されません。すぐに保存してください。再度表示しようとすると強制的にリセットされます。
>
> クイックエントリーで作成したボットは作成者本人のみが使用でき、グループチャットには対応していません。グループチャット機能が必要な場合は、[QQ オープンプラットフォーム](https://q.qq.com/) でサンドボックスモードを設定してください。

### 手動セットアップ

1. QQ アカウントで [QQ オープンプラットフォーム](https://q.qq.com/) にログインし、開発者アカウントを登録する
2. QQ ボットを作成し、アバターと名前をカスタマイズする
3. ボット設定から **App ID** と **App Secret** を取得する
4. PicoClaw 設定ファイルに認証情報を入力する
5. `picoclaw gateway` を実行してサービスを起動する
6. QQ でボットを検索して会話を始める

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