Yuanbao

Tencent Yuanbao は Tencent の AI アシスタントプラットフォームです。OpenClaw チャンネル Plugin は Yuanbao ボットを WebSocket 経由で OpenClaw に接続し、ダイレクトメッセージやグループチャットで ユーザーとやり取りできるようにします。

ステータス: ボット DM + グループチャットで本番利用可能。WebSocket が唯一サポートされる接続モードです。

# クイックスタート

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 を入力します。

# アクセス制御

# ダイレクトメッセージ

dmPolicy を設定して、誰がボットに DM できるかを制御します。

• "pairing" - 不明なユーザーにはペアリングコードが送信されます。CLI で承認します
• "allowlist" - allowFrom に記載されたユーザーのみチャットできます
• "open" - すべてのユーザーを許可します（デフォルト）
• "disabled" - すべての DM を無効にします

ペアリングリクエストを承認する:

openclaw pairing list yuanbao
openclaw pairing approve yuanbao <CODE>

# グループチャット

メンション要件（channels.yuanbao.requireMention）:

• true - @mention を必須にします（デフォルト）
• false - @mention なしで応答します

グループチャットでボットのメッセージに返信すると、暗黙的なメンションとして扱われます。

# 設定例

# オープンな 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"],
      },
    },
  },
}

# グループで @mention 要件を無効にする

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

# アウトバウンドメッセージ配信を最適化する

{
  channels: {
    yuanbao: {
      // Send each chunk immediately without buffering
      outboundQueueStrategy: "immediate",
    },
  },
}

# merge-text 戦略を調整する

{
  channels: {
    yuanbao: {
      outboundQueueStrategy: "merge-text",
      minChars: 2800, // buffer until this many chars
      maxChars: 3000, // force split above this limit
      idleMs: 5000, // auto-flush after idle timeout (ms)
    },
  },
}

# よく使うコマンド

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

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

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

1. ボットがグループに追加されていることを確認します
2. ボットを @mention していることを確認します（デフォルトで必須）
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 で 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,
        },
      },
    },
  },
}

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

# メッセージ制限

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

# ストリーミング

Yuanbao はブロックレベルのストリーミング出力をサポートしています。有効にすると、ボットは生成しながらテキストをチャンク単位で送信します。

{
  channels: {
    yuanbao: {
      disableBlockStreaming: false, // block streaming enabled (default)
    },
  },
}

完全な返信を 1 つのメッセージで送信するには、disableBlockStreaming: true を設定します。

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

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

{
  channels: {
    yuanbao: {
      historyLimit: 100, // default: 100, set 0 to disable
    },
  },
}

# 返信先モード

グループチャットで返信する際に、ボットがメッセージを引用する方法を制御します。

{
  channels: {
    yuanbao: {
      replyToMode: "first", // "off" | "first" | "all" (default: "first")
    },
  },
}

# Markdown ヒントの注入

デフォルトでは、ボットは AI モデルが返信全体を markdown コードブロックで囲まないように、システムプロンプトへ指示を注入します。

{
  channels: {
    yuanbao: {
      markdownHintEnabled: true, // default: true
    },
  },
}

# デバッグモード

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

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

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

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 認証とペアリングフロー
• グループ - グループチャットの動作とメンション制御
• チャンネルルーティング - メッセージのセッションルーティング
• セキュリティ - アクセスモデルと強化