元宝

Tencent Yuanbao は Tencent の AI アシスタントプラットフォームです。コミュニティによって保守されている openclaw-plugin-yuanbao Plugin は、Yuanbao ボットを WebSocket 経由で OpenClaw に接続し、ダイレクトメッセージとグループチャットを利用できるようにします。

ステータス: ボットの DM とグループチャットで本番利用可能です。サポートされる接続モードは WebSocket のみです。この Plugin は OpenClaw コアではなく Tencent Yuanbao チームによって外部カタログエントリとして保守されています。以下の設定と動作の詳細（インストールと汎用 CLI インターフェースを除く）は Plugin 独自のドキュメントに基づいており、OpenClaw コアのソースに照らして検証されていません。

クイックスタート

OpenClaw 2026.4.10 以降が必要です。openclaw --version で確認し、openclaw update でアップグレードしてください。

openclaw channels add --channel yuanbao --token "appKey:appSecret"

openclaw gateway restart

対話形式のセットアップ（代替方法）

openclaw channels login --channel yuanbao

プロンプトに従って App ID と App Secret を入力してください。

アクセス制御

ダイレクトメッセージ

channels.yuanbao.dm.policy:

ペアリング要求を承認します。

openclaw pairing list yuanbaoopenclaw pairing approve yuanbao <CODE>

グループチャット

channels.yuanbao.requireMention（デフォルトは true）: グループ内でボットが応答する前に @メンションを必須にします。ボット自身のメッセージへの返信は、暗黙のメンションとして扱われます。

設定例

基本セットアップ、オープンな DM ポリシー:

{  channels: {    yuanbao: {      appKey: "your_app_key",      appSecret: "your_app_secret",      dm: {        policy: "open",      },    },  },}

DM を特定のユーザーに制限します。

{  channels: {    yuanbao: {      appKey: "your_app_key",      appSecret: "your_app_secret",      dm: {        policy: "allowlist",        allowFrom: ["user_id_1", "user_id_2"],      },    },  },}

グループでの @メンション要件を無効にします。

{  channels: {    yuanbao: {      requireMention: false,    },  },}

送信配信の調整:

{  channels: {    yuanbao: {      outboundQueueStrategy: "merge-text",      minChars: 2800, // この文字数に達するまでバッファリング      maxChars: 3000, // この上限を超えたら強制的に分割      idleMs: 5000, // アイドルタイムアウト（ミリ秒）後に自動フラッシュ    },  },}

バッファリングせずに各チャンクを送信するには、outboundQueueStrategy: "immediate" を設定します。

よく使うコマンド

Yuanbao はネイティブのスラッシュコマンドメニューをサポートしています。Gateway の起動時に、コマンドがプラットフォームへ自動的に同期されます。

トラブルシューティング

グループチャットでボットが応答しない場合:

1. ボットがグループに追加されていることを確認します
2. ボットを @メンションしていることを確認します（デフォルトでは必須）
3. ログを確認します: openclaw logs --follow

ボットがメッセージを受信しない場合:

1. Yuanbao アプリでボットが作成され、承認されていることを確認します
2. appKey と appSecret が正しく設定されていることを確認します
3. Gateway が実行中であることを確認します: openclaw gateway status
4. ログを確認します: openclaw logs --follow

ボットが空の応答またはフォールバック応答を送信する場合:

1. AI モデルが有効なコンテンツを返しているか確認します
2. デフォルトのフォールバック応答: 「暂时无法解答，你可以换个问题问问我哦」
3. channels.yuanbao.fallbackReply でカスタマイズします

App Secret が漏洩した場合:

1. Yuanbao アプリで App Secret をリセットします
2. 設定内の値を更新します
3. Gateway を再起動します: openclaw gateway restart

高度な設定

複数アカウント

{  channels: {    yuanbao: {      defaultAccount: "main",      accounts: {        main: {          appKey: "key_xxx",          appSecret: "secret_xxx",          name: "Primary bot",        },        backup: {          appKey: "key_yyy",          appSecret: "secret_yyy",          name: "Backup bot",          enabled: false,        },      },    },  },}

送信 API で accountId が指定されていない場合に使用するアカウントは、defaultAccount で制御します。

メッセージ制限

• maxChars: 1 メッセージあたりの最大文字数（デフォルトは 3000）
• mediaMaxMb: メディアのアップロード／ダウンロード上限（デフォルトは 20 MB）
• overflowPolicy: メッセージが上限を超えた場合の動作。"split"（デフォルト）または "stop"

ストリーミング

Yuanbao はブロック単位のストリーミング出力をサポートしており、ボットは生成しながらテキストをチャンク単位で送信します。

{  channels: {    yuanbao: {      disableBlockStreaming: false, // ブロックストリーミングが有効（デフォルト）    },  },}

完全な応答を 1 件のメッセージとして送信するには、disableBlockStreaming: true を設定します。

グループチャット履歴のコンテキスト

{  channels: {    yuanbao: {      historyLimit: 100, // デフォルト: 100、無効にするには 0 を設定    },  },}

グループチャットの AI コンテキストに含める履歴メッセージ数を制御します。

返信先モード

{  channels: {    yuanbao: {      replyToMode: "first", // "off" | "first" | "all"（デフォルト: "first"）    },  },}

Markdown ヒントの挿入

デフォルトでは、モデルが応答全体を Markdown コードブロックで囲まないようにするため、ボットはシステムプロンプトへ指示を挿入します。

{  channels: {    yuanbao: {      markdownHintEnabled: true, // デフォルト: true    },  },}

デバッグモード

{  channels: {    yuanbao: {      debugBotIds: ["bot_user_id_1", "bot_user_id_2"],    },  },}

一覧に含まれるボット ID に対して、サニタイズされていないログ出力を有効にします。

マルチエージェントルーティング

bindings を使用して、Yuanbao の DM またはグループを異なるエージェントにルーティングします。

{  agents: {    list: [      { id: "main" },      { id: "agent-a", workspace: "/home/user/agent-a" },      { id: "agent-b", workspace: "/home/user/agent-b" },    ],  },  bindings: [    {      agentId: "agent-a",      match: {        channel: "yuanbao",        peer: { kind: "direct", id: "user_xxx" },      },    },    {      agentId: "agent-b",      match: {        channel: "yuanbao",        peer: { kind: "group", id: "group_zzz" },      },    },  ],}

• match.channel: "yuanbao"
• match.peer.kind: "direct"（DM）または "group"（グループチャット）
• match.peer.id: ユーザー ID またはグループコード

設定リファレンス

完全な設定: Gateway の設定

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

受信: テキスト、画像、ファイル、音声／ボイス、動画、ステッカー／カスタム絵文字、カスタム要素（リンクカード）。

送信: テキスト（Markdown）、画像、ファイル、音声、動画、ステッカー。

スレッドと返信: 引用返信（replyToMode で設定可能）。スレッド返信はプラットフォームでサポートされていません。

関連項目

• チャンネルの概要 - サポートされているすべてのチャンネル
• ペアリング - DM の認証とペアリングフロー
• グループ - グループチャットの動作とメンション制御
• チャンネルルーティング - メッセージのセッションルーティング
• セキュリティ - アクセスモデルと堅牢化