元宝（Yuanbao）频道

腾讯元宝 AI 助手平台的 OpenClaw 频道插件，通过 WebSocket 连接元宝 bot，支持私信和群聊。需要 OpenClaw 2026.4.10 或以上版本。

快速设置

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

最小配置

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

访问控制

私信策略（dmPolicy）：

"open"（默认）：允许所有用户
"pairing"：未知用户收到配对码
"allowlist"：仅 allowFrom 中的用户
"disabled"：禁用所有私信

群聊：默认需要 @mention（requireMention: true），回复 bot 消息视为隐式 mention。

消息投递配置

{
  channels: {
    yuanbao: {
      outboundQueueStrategy: "merge-text",  // immediate | merge-text
      minChars: 2800,   // 缓冲到此字符数才发送
      maxChars: 3000,   // 超过此限制强制分割
      idleMs: 5000,     // 空闲超时后自动刷新（ms）
    },
  },
}

消息限制

单条消息最大 3000 字符（maxChars）
媒体上限 20MB（mediaMaxMb）
超出策略："split"（默认）或 "stop"

群聊历史上下文

{ channels: { yuanbao: { historyLimit: 100 } } }  // 默认 100，0 禁用

多账号

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

支持的消息类型

接收：文本、图片、文件、音频/语音、视频、贴纸、自定义元素

发送：文本（支持 Markdown）、图片、文件、音频、视频、贴纸

常用命令

/help、/status、/new、/stop、/restart、/compact

元宝支持原生 slash 命令菜单，Gateway 启动时自动同步。

故障排查

bot 不响应群聊：确认已 @mention bot，检查日志 openclaw logs --follow
bot 不接收消息：验证 appKey 和 appSecret，确认 Gateway 运行中
空回复：检查 AI 模型返回内容，可自定义 fallbackReply

Wiki AI

目录