mirror of
https://github.com/sipeed/picoclaw.git
synced 2026-06-12 18:08:54 +00:00
Cytown
667fc85d54
add new field type to Channel struct config.channels refactor to channel_list update config version to 3 update the docs
56 lines
2.8 KiB
Markdown
56 lines
2.8 KiB
Markdown
> [README](../../../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 でボットを検索して会話を始める
|
|
|
|
> 開発段階ではサンドボックスモードを有効にし、テストユーザーとグループをサンドボックスに追加してデバッグすることを推奨します。
|