openclaw-plugin-yuanbao 插件通过 WebSocket 将腾讯元宝机器人连接到 OpenClaw,以支持私信和群聊。
**状态:**已可用于生产环境中的机器人私信和群聊。WebSocket 是唯一受支持的连接模式。此插件由腾讯元宝团队作为外部目录条目维护,而非由 OpenClaw 核心维护;以下配置/行为详情(安装和通用 CLI 接口除外)来自插件自身的文档,尚未根据 OpenClaw 核心源代码进行验证。
快速开始
需要 OpenClaw 2026.4.10 或更高版本。使用openclaw --version 检查;使用 openclaw update 升级。
1
使用你的凭据添加腾讯元宝渠道
--token 使用以冒号分隔的 appKey:appSecret。在应用设置中创建机器人后,可从腾讯元宝应用获取这些凭据。2
重启 Gateway 网关以应用更改
交互式设置(替代方式)
访问控制
私信
channels.yuanbao.dm.policy:
批准配对请求:
群聊
channels.yuanbao.requireMention(默认 true):机器人在群组中响应前需要被 @提及。回复机器人自己的消息将视为隐式提及。
配置示例
基本设置,开放私信策略:outboundQueueStrategy: "immediate" 可在不缓冲的情况下发送每个分块。
常用命令
腾讯元宝支持原生斜杠命令菜单;Gateway 网关启动时,命令会自动同步到平台。
故障排查
机器人在群聊中没有响应:- 确认机器人已添加到群组
- 确认你 @提及了机器人(默认必需)
- 检查日志:
openclaw logs --follow
- 确认机器人已在腾讯元宝应用中创建并获批准
- 确认
appKey和appSecret配置正确 - 确认 Gateway 网关正在运行:
openclaw gateway status - 检查日志:
openclaw logs --follow
- 检查 AI 模型是否返回有效内容
- 默认回退回复:“暂时无法解答,你可以换个问题问问我哦”
- 使用
channels.yuanbao.fallbackReply自定义
- 在腾讯元宝应用中重置 App Secret
- 更新配置中的值
- 重启 Gateway 网关:
openclaw gateway restart
高级配置
多个账户
accountId 时,defaultAccount 控制使用哪个账户。
消息限制
maxChars:单条消息的最大字符数(默认3000)mediaMaxMb:媒体上传/下载限制(默认20MB)overflowPolicy:消息超过限制时的行为,"split"(默认)或"stop"
流式传输
腾讯元宝支持分块级流式输出;机器人会在生成文本时分块发送。disableBlockStreaming: true 可在一条消息中发送完整回复。
群聊历史上下文
引用回复模式
Markdown 提示注入
默认情况下,机器人会注入一条系统提示词指令,防止模型将整个回复包裹在 Markdown 代码块中。调试模式
多智能体路由
使用bindings 将腾讯元宝私信或群组路由到不同智能体:
match.channel:"yuanbao"match.peer.kind:"direct"(私信)或"group"(群聊)match.peer.id:用户 ID 或群组代码
配置参考
完整配置:Gateway 配置支持的消息类型
**接收:**文本、图片、文件、音频/语音、视频、贴纸/自定义表情、自定义元素(链接卡片)。 **发送:**文本(Markdown)、图片、文件、音频、视频、贴纸。 **话题串和回复:**引用回复(可通过replyToMode 配置);平台不支持话题串回复。