メインコンテンツへスキップ
公式の QQ Open Platform Bot API を使用して、QQ（中国で最も人気のあるメッセージングアプリ）を LemonClaw インスタンスに接続します。このガイドは、ホスト型の Claw インスタンスとセルフホスト型の LemonClaw デプロイメントの両方に対応しています。

​
前提条件

​
セットアップガイド

1

QQ Bot アプリケーションを作成する

  1. QQ Open Platform にアクセスします
  2. ログインして Bot セクションに移動します
  3. Create Bot をクリックします
  4. Bot の情報（名前、アバター、説明）を入力します
  5. 審査のために提出します
2

認証情報を取得する

  1. 承認されたら、Bot の Development Settings に移動します
  2. AppID をコピーします
  3. AppSecret（クライアントシークレット）をコピーします
3

サンドボックスの設定（テスト用）

  1. Bot の設定で Sandbox Configuration に移動します
  2. 自分の QQ 番号をサンドボックスのホワイトリストに追加します
  3. これにより、本番公開前にテストが可能になります
本番審査に提出する前に、すべてが正常に動作することを確認するためにサンドボックスモードから開始してください。
4

LemonClaw WebUI を開く

  1. ホスト型の Claw を使用している場合は、Claw Dashboard に移動し、Open WebUI をクリックします
  2. LemonClaw をセルフホストしている場合は、自身の WebUI（例: http://your-ip:18789）を開き、トークンでサインインします
  3. WebUI で Settings → Channels に移動します
  4. QQ セクションを展開します
  5. AppID と AppSecret を貼り付けます
  6. Save をクリックします
5

チャットを開始する

  1. QQ で Bot を検索するか、フレンドとして追加します
  2. メッセージを送信します
  3. 最初のユーザーは自動的にオーナーとしてペアリングされます。コードは不要です！
  4. AI とのチャットを開始しましょう！

​
サポートされているメッセージタイプ

タイプ説明
C2C (Private)Bot へのダイレクトメッセージ
Group @mentionQQ グループ内で Bot を @メンションする
ChannelQQ チャンネル（频道）内のメッセージ

​
トラブルシューティング

現在の LemonClaw の QQ サポートは、ダイレクトメッセージとグループでの @bot イベントに限られます。@ なしの通常グループメッセージや QQ チャンネル会話にはまだ対応していません。
  • AppID と AppSecret が正しいか確認してください
  • テスト中の場合は、QQ 番号がサンドボックスのホワイトリストに含まれているか確認してください
  • Bot アプリケーションが承認されていることを確認してください
  • AppID を再確認してください。数字の文字列である必要があります
  • 正しい AppSecret を使用していることを確認してください（トークンではありません）