openclaw-plugin-yuanbao Plugin は、Yuanbao ボットを WebSocket 経由で OpenClaw に接続し、ダイレクトメッセージとグループチャットに対応します。
ステータス: ボットの DM とグループチャットで本番利用可能です。WebSocket が唯一サポートされる接続モードです。この Plugin は Tencent Yuanbao チームが外部カタログエントリとしてメンテナンスしており、OpenClaw コアによるメンテナンスではありません。以下の設定/動作の詳細(インストールと汎用 CLI サーフェスを除く)は Plugin 独自のドキュメントに基づくもので、OpenClaw コアソースに対して検証されていません。
クイックスタート
OpenClaw 2026.4.10 以降が必要です。openclaw --version で確認し、openclaw update でアップグレードします。
認証情報を使って Yuanbao チャネルを追加する
--token はコロン区切りの appKey:appSecret を使用します。アプリケーション設定でボットを作成し、Yuanbao アプリからこれらを取得します。対話形式のセットアップ(代替)
アクセス制御
ダイレクトメッセージ
channels.yuanbao.dm.policy:
| 値 | 動作 |
|---|---|
open(デフォルト) | すべてのユーザーを許可 |
pairing | 不明なユーザーにはペアリングコードを返し、CLI で承認する |
allowlist | allowFrom に含まれるユーザーだけがチャット可能 |
disabled | すべての DM を無効化 |
グループチャット
channels.yuanbao.requireMention(デフォルト true): グループ内でボットが応答する前に @メンションを必須にします。ボット自身のメッセージへの返信は暗黙のメンションとして扱われます。
設定例
基本セットアップ、オープンな DM ポリシー:outboundQueueStrategy: "immediate" を設定します。
よく使うコマンド
| コマンド | 説明 |
|---|---|
/help | 利用可能なコマンドを表示 |
/status | ボットのステータスを表示 |
/new | 新しいセッションを開始 |
/stop | 現在の実行を停止 |
/restart | OpenClaw を再起動 |
/compact | セッションコンテキストを圧縮 |
トラブルシューティング
ボットがグループチャットで応答しない場合:- ボットがグループに追加されていることを確認します
- ボットを @メンションしていることを確認します(デフォルトで必須)
- ログを確認します:
openclaw logs --follow
- Yuanbao アプリでボットが作成され、承認されていることを確認します
appKeyとappSecretが正しく設定されていることを確認します- Gateway が実行中であることを確認します:
openclaw gateway status - ログを確認します:
openclaw logs --follow
- AI モデルが有効なコンテンツを返しているか確認します
- デフォルトのフォールバック返信: “暂时无法解答,你可以换个问题问问我哦”
channels.yuanbao.fallbackReplyでカスタマイズします
- Yuanbao アプリで App Secret をリセットします
- 設定内の値を更新します
- Gateway を再起動します:
openclaw gateway restart
高度な設定
複数アカウント
defaultAccount は、送信 API が accountId を指定しない場合に使用されるアカウントを制御します。
メッセージ制限
maxChars: 単一メッセージの最大文字数(デフォルト3000)mediaMaxMb: メディアのアップロード/ダウンロード制限(デフォルト20MB)overflowPolicy: メッセージが制限を超えた場合の動作、"split"(デフォルト)または"stop"
ストリーミング
Yuanbao はブロックレベルのストリーミング出力をサポートします。ボットは生成中にテキストをチャンク単位で送信します。disableBlockStreaming: true を設定します。
グループチャット履歴コンテキスト
Reply-to モード
| 値 | 動作 |
|---|---|
off | 引用返信しない |
first | 受信メッセージごとに最初の返信だけを引用する(デフォルト) |
all | すべての返信を引用する |
Markdown ヒント注入
デフォルトでは、ボットはモデルが返信全体を Markdown コードブロックで囲まないようにする system-prompt 指示を注入します。デバッグモード
マルチエージェントルーティング
Yuanbao の DM またはグループを別々のエージェントにルーティングするには、bindings を使用します。
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 | グループで @メンションを必須にする | true |
channels.yuanbao.overflowPolicy | 長いメッセージの処理(split または stop) | split |
channels.yuanbao.replyToMode | グループの reply-to 戦略(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 | モデルがコンテンツを返さない場合のフォールバック返信 | 暂时无法解答,你可以换个问题问问我哦 |
channels.yuanbao.markdownHintEnabled | Markdown の折り返し防止指示を注入 | true |
channels.yuanbao.debugBotIds | デバッグ許可リストのボット ID(サニタイズなしログ) | [] |
サポートされるメッセージ種別
受信: テキスト、画像、ファイル、音声/ボイス、動画、スタンプ/カスタム絵文字、カスタム要素(リンクカード)。 送信: テキスト(Markdown)、画像、ファイル、音声、動画、スタンプ。 スレッドと返信: 引用返信(replyToMode で設定可能)。スレッド返信はプラットフォームでサポートされていません。
関連
- チャネル概要 - サポートされているすべてのチャネル
- ペアリング - DM 認証とペアリングフロー
- グループ - グループチャットの動作とメンションゲート
- チャネルルーティング - メッセージのセッションルーティング
- セキュリティ - アクセスモデルと強化