Documentation Index
Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt
Use this file to discover all available pages before exploring further.
Yuanbao
Tencent Yuanbao は Tencent の AI アシスタントプラットフォームです。OpenClaw チャネル Plugin は Yuanbao ボットを WebSocket 経由で OpenClaw に接続し、ダイレクトメッセージやグループチャットを通じてユーザーとやり取りできるようにします。 ステータス: ボット DM とグループチャットで本番利用可能。WebSocket が唯一サポートされる接続モードです。クイックスタート
OpenClaw 2026.4.10 以上が必要です。 確認するにはopenclaw --versionを実行してください。openclaw updateでアップグレードできます。
認証情報を使って Yuanbao チャネルを追加する
--token の値はコロン区切りの appKey:appSecret 形式を使用します。これらは Yuanbao アプリでアプリケーション設定内にロボットを作成することで取得できます。対話型セットアップ(代替)
対話型ウィザードも使用できます。アクセス制御
ダイレクトメッセージ
ボットに DM できるユーザーを制御するにはdmPolicy を設定します。
"pairing"— 不明なユーザーはペアリングコードを受け取り、CLI で承認します"allowlist"—allowFromに listed されているユーザーのみチャットできます"open"— すべてのユーザーを許可します(デフォルト)"disabled"— すべての DM を無効にします
グループチャット
メンション要件(channels.yuanbao.requireMention):
true— @mention を必須にします(デフォルト)false— @mention なしで応答します
設定例
オープン DM ポリシーの基本セットアップ
DM を特定のユーザーに制限する
グループで @mention 要件を無効にする
送信メッセージ配信を最適化する
merge-text 戦略を調整する
よく使うコマンド
| コマンド | 説明 |
|---|---|
/help | 利用可能なコマンドを表示します |
/status | ボットのステータスを表示します |
/new | 新しいセッションを開始します |
/stop | 現在の実行を停止します |
/restart | OpenClaw を再起動します |
/compact | セッションコンテキストを圧縮します |
Yuanbao はネイティブのスラッシュコマンドメニューをサポートしています。コマンドは Gateway 起動時にプラットフォームへ自動的に同期されます。
トラブルシューティング
ボットがグループチャットで応答しない
- ボットがグループに追加されていることを確認します
- ボットを @mention していることを確認します(デフォルトで必須)
- ログを確認します:
openclaw logs --follow
ボットがメッセージを受信しない
- ボットが Yuanbao アプリで作成され、承認されていることを確認します
appKeyとappSecretが正しく設定されていることを確認します- Gateway が実行中であることを確認します:
openclaw gateway status - ログを確認します:
openclaw logs --follow
ボットが空の返信またはフォールバック返信を送信する
- AI モデルが有効な内容を返しているか確認します
- デフォルトのフォールバック返信は次のとおりです: “暂时无法解答,你可以换个问题问问我哦”
channels.yuanbao.fallbackReplyでカスタマイズします
App Secret が漏えいした
- YuanBao APP で App Secret をリセットします
- 設定内の値を更新します
- Gateway を再起動します:
openclaw gateway restart
高度な設定
複数アカウント
defaultAccount は、送信 API が accountId を指定しない場合に使用されるアカウントを制御します。
メッセージ制限
maxChars— 1 件のメッセージの最大文字数(デフォルト:3000文字)mediaMaxMb— メディアのアップロード/ダウンロード制限(デフォルト:20MB)overflowPolicy— メッセージが制限を超えた場合の動作:"split"(デフォルト)または"stop"
ストリーミング
Yuanbao はブロックレベルのストリーミング出力をサポートしています。有効にすると、ボットは生成中のテキストをチャンク単位で送信します。disableBlockStreaming: true を設定します。
グループチャット履歴コンテキスト
グループチャットで AI コンテキストに含める履歴メッセージ数を制御します。返信先モード
グループチャットで返信時にボットがメッセージを引用する方法を制御します。| 値 | 動作 |
|---|---|
"off" | 引用返信しません |
"first" | 受信メッセージごとに最初の返信のみ引用します(デフォルト) |
"all" | すべての返信を引用します |
Markdown ヒント注入
デフォルトでは、AI モデルが返信全体を markdown コードブロックで囲まないように、ボットがシステムプロンプトへ指示を注入します。デバッグモード
特定のボット ID に対してサニタイズされていないログ出力を有効にします。マルチエージェントルーティング
bindings を使用して Yuanbao の DM またはグループを別々のエージェントへルーティングします。
match.channel:"yuanbao"match.peer.kind:"direct"(DM)または"group"(グループチャット)match.peer.id: ユーザー ID またはグループコード
設定リファレンス
完全な設定: Gateway 設定| 設定 | 説明 | デフォルト |
|---|---|---|
channels.yuanbao.enabled | チャネルを有効/無効にします | true |
channels.yuanbao.defaultAccount | 送信ルーティング用のデフォルトアカウント | default |
channels.yuanbao.accounts.<id>.appKey | App Key(署名とチケット生成に使用) | — |
channels.yuanbao.accounts.<id>.appSecret | App Secret(署名に使用) | — |
channels.yuanbao.accounts.<id>.token | 事前署名済みトークン(自動チケット署名をスキップ) | — |
channels.yuanbao.accounts.<id>.name | アカウント表示名 | — |
channels.yuanbao.accounts.<id>.enabled | 特定のアカウントを有効/無効にします | true |
channels.yuanbao.dm.policy | DM ポリシー | open |
channels.yuanbao.dm.allowFrom | DM allowlist(ユーザー ID リスト) | — |
channels.yuanbao.requireMention | グループで @mention を必須にします | true |
channels.yuanbao.overflowPolicy | 長いメッセージの処理(split または stop) | split |
channels.yuanbao.replyToMode | グループの返信先戦略(off、first、all) | first |
channels.yuanbao.outboundQueueStrategy | 送信戦略(merge-text または immediate) | merge-text |
channels.yuanbao.minChars | Merge-text: 送信をトリガーする最小文字数 | 2800 |
channels.yuanbao.maxChars | Merge-text: メッセージあたりの最大文字数 | 3000 |
channels.yuanbao.idleMs | Merge-text: 自動フラッシュ前のアイドルタイムアウト(ms) | 5000 |
channels.yuanbao.mediaMaxMb | メディアサイズ制限(MB) | 20 |
channels.yuanbao.historyLimit | グループチャット履歴コンテキストのエントリ数 | 100 |
channels.yuanbao.disableBlockStreaming | ブロックレベルのストリーミング出力を無効にします | false |
channels.yuanbao.fallbackReply | AI が内容を返さない場合のフォールバック返信 | 暂时无法解答,你可以换个问题问问我哦 |
channels.yuanbao.markdownHintEnabled | markdown の囲み防止指示を注入します | true |
channels.yuanbao.debugBotIds | デバッグ許可リストのボット ID(サニタイズなしログ) | [] |
サポートされるメッセージタイプ
受信
- ✅ テキスト
- ✅ 画像
- ✅ ファイル
- ✅ 音声 / ボイス
- ✅ 動画
- ✅ ステッカー / カスタム絵文字
- ✅ カスタム要素(リンクカードなど)
送信
- ✅ テキスト(markdown サポートあり)
- ✅ 画像
- ✅ ファイル
- ✅ 音声
- ✅ 動画
- ✅ ステッカー
スレッドと返信
- ✅ 引用返信(
replyToModeで設定可能) - ❌ スレッド返信(プラットフォームでサポートされていません)
関連
- チャネル概要 — サポートされているすべてのチャネル
- ペアリング — DM 認証とペアリングフロー
- グループ — グループチャットの動作とメンションゲーティング
- チャネルルーティング — メッセージのセッションルーティング
- セキュリティ — アクセスモデルと強化