Tencent Yuanbao は Tencent の AI アシスタントプラットフォームです。OpenClaw チャンネル Plugin は Yuanbao ボットを WebSocket 経由で OpenClaw に接続し、ダイレクトメッセージやグループチャットで ユーザーとやり取りできるようにします。 ステータス: ボット DM + グループチャットで本番利用可能。WebSocket が唯一サポートされる接続モードです。Documentation Index
Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
Use this file to discover all available pages before exploring further.
クイックスタート
OpenClaw 2026.4.10 以降が必要です。 確認するにはopenclaw --versionを実行します。openclaw updateでアップグレードします。
認証情報を使って Yuanbao チャンネルを追加する
--token の値は、コロン区切りの appKey:appSecret 形式を使用します。Yuanbao アプリで、アプリケーション設定にロボットを作成すると取得できます。対話型セットアップ(代替)
対話型ウィザードも使用できます。アクセス制御
ダイレクトメッセージ
dmPolicy を設定して、誰がボットに DM できるかを制御します。
"pairing"- 不明なユーザーにはペアリングコードが送信されます。CLI で承認します"allowlist"-allowFromに記載されたユーザーのみチャットできます"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- 単一メッセージの最大文字数(デフォルト: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 許可リスト(ユーザー 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 認証とペアリングフロー
- グループ - グループチャットの動作とメンション制御
- チャンネルルーティング - メッセージのセッションルーティング
- セキュリティ - アクセスモデルと強化