Skip to main content
Tencent Yuanbao 是腾讯的 AI 助手平台。由社区维护的 openclaw-plugin-yuanbao 插件通过 WebSocket 将腾讯元宝机器人连接到 OpenClaw,以支持私信和群聊。 **状态:**已可用于生产环境中的机器人私信和群聊。WebSocket 是唯一受支持的连接模式。此插件由腾讯元宝团队作为外部目录条目维护,而非由 OpenClaw 核心维护;以下配置/行为详情(安装和通用 CLI 接口除外)来自插件自身的文档,尚未根据 OpenClaw 核心源代码进行验证。

快速开始

需要 OpenClaw 2026.4.10 或更高版本。使用 openclaw --version 检查;使用 openclaw update 升级。
1

使用你的凭据添加腾讯元宝渠道

--token 使用以冒号分隔的 appKey:appSecret。在应用设置中创建机器人后,可从腾讯元宝应用获取这些凭据。
2

重启 Gateway 网关以应用更改

交互式设置(替代方式)

按照提示输入你的 App ID 和 App Secret。

访问控制

私信

channels.yuanbao.dm.policy 批准配对请求:

群聊

channels.yuanbao.requireMention(默认 true):机器人在群组中响应前需要被 @提及。回复机器人自己的消息将视为隐式提及。

配置示例

基本设置,开放私信策略:
将私信限制为特定用户:
禁用群组中的 @提及要求:
调整出站传递:
设置 outboundQueueStrategy: "immediate" 可在不缓冲的情况下发送每个分块。

常用命令

腾讯元宝支持原生斜杠命令菜单;Gateway 网关启动时,命令会自动同步到平台。

故障排查

机器人在群聊中没有响应:
  1. 确认机器人已添加到群组
  2. 确认你 @提及了机器人(默认必需)
  3. 检查日志:openclaw logs --follow
机器人未收到消息:
  1. 确认机器人已在腾讯元宝应用中创建并获批准
  2. 确认 appKeyappSecret 配置正确
  3. 确认 Gateway 网关正在运行:openclaw gateway status
  4. 检查日志:openclaw logs --follow
机器人发送空回复或回退回复:
  1. 检查 AI 模型是否返回有效内容
  2. 默认回退回复:“暂时无法解答,你可以换个问题问问我哦”
  3. 使用 channels.yuanbao.fallbackReply 自定义
App Secret 泄露:
  1. 在腾讯元宝应用中重置 App Secret
  2. 更新配置中的值
  3. 重启 Gateway 网关:openclaw gateway restart

高级配置

多个账户

当出站 API 未指定 accountId 时,defaultAccount 控制使用哪个账户。

消息限制

  • maxChars:单条消息的最大字符数(默认 3000
  • mediaMaxMb:媒体上传/下载限制(默认 20 MB)
  • overflowPolicy:消息超过限制时的行为,"split"(默认)或 "stop"

流式传输

腾讯元宝支持分块级流式输出;机器人会在生成文本时分块发送。
设置 disableBlockStreaming: true 可在一条消息中发送完整回复。

群聊历史上下文

控制群聊的 AI 上下文中包含多少条历史消息。

引用回复模式

Markdown 提示注入

默认情况下,机器人会注入一条系统提示词指令,防止模型将整个回复包裹在 Markdown 代码块中。

调试模式

为列出的机器人 ID 启用未经清理的日志输出。

多智能体路由

使用 bindings 将腾讯元宝私信或群组路由到不同智能体:
  • match.channel"yuanbao"
  • match.peer.kind"direct"(私信)或 "group"(群聊)
  • match.peer.id:用户 ID 或群组代码

配置参考

完整配置:Gateway 配置

支持的消息类型

**接收:**文本、图片、文件、音频/语音、视频、贴纸/自定义表情、自定义元素(链接卡片)。 **发送:**文本(Markdown)、图片、文件、音频、视频、贴纸。 **话题串和回复:**引用回复(可通过 replyToMode 配置);平台不支持话题串回复。

相关内容