Channels 导读

Yuanbao:消息从哪扇门跑进来

Yuanbao 像一扇接消息的门。你要看清门铃装在哪、钥匙交给谁、什么人能进来,以及门口最容易被绊一跤的是哪块砖。原文最响的一记鼓点,其实是:Tencent Yuanbao is Tencent's AI assistant platform. The OpenClaw 消息通道 新本领插件 connects Yu…。

先讲这一页到底在解决什么

Yuanbao:消息从哪扇门跑进来

Yuanbao 像一扇接消息的门。你要看清门铃装在哪、钥匙交给谁、什么人能进来,以及门口最容易被绊一跤的是哪块砖。原文最响的一记鼓点,其实是:Tencent Yuanbao is Tencent's AI assistant platform. The OpenClaw 消息通道 新本领插件 connects Yu…。

原文共 28 节,先看 Start Here 路径:/channels/yuanbao 查看官方原文

第一站

快速启动像给机器人发一张“元宝门票”

这页要求 OpenClaw 2026.4.10 或以上。版本太旧时,先更新再配通道。

openclaw --version

先看自己是不是新版本,像进门前检查票是不是今天能用。

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

appKeyappSecret 中间用冒号连起来,像把门牌号和暗号一起交给 OpenClaw。

openclaw channels login --channel yuanbao

如果不想一次写完整命令,也可以走互动向导,让它一步步问你 App ID 和 App Secret。

openclaw gateway restart

配好后要重启 Gateway,新的元宝门口才会正式开始值班。

第二站

私聊门口有四种守门方式

dm.policy 决定谁能直接和机器人说话。默认是 open,也就是都能来。

open

全部放行

适合公开机器人,但也要注意别让陌生流量太随便进来。

pairing

先领号码牌

陌生人先拿配对码,你审核后再继续聊。

allowlist

只认名单

只有 allowFrom 里写到的人可以进门。

disabled

关掉私聊

如果只想处理群聊或暂时停用私聊,就把这扇门锁上。

第三站

群聊默认要 @,这是为了不让机器人乱插话

元宝群聊里,默认 requireMention: true。别人直接回复机器人的消息,也算一种隐含 @。

requireMention: true

像课堂上先举手叫机器人,它才回答,不会听到任何一句话都冲出来。

requireMention: false

如果你明确想让它不用 @ 也响应,可以关掉这个要求,但群里会更容易热闹过头。

historyLimit

这是给群聊带多少历史消息。默认 100 条,设成 0 就是不带历史。

replyToMode

决定回群聊时要不要引用消息:不引用、只引用第一条,或每条都引用。

第四站

长回复不是硬塞一大坨,而是按策略分段送出

元宝通道很在意消息大小和发送节奏,因为平台对单条消息和媒体都有上限。

outboundQueueStrategy: "merge-text"

像先把短句攒成一段再送,默认更适合读长回答。

outboundQueueStrategy: "immediate"

像生成一点就立刻发一点,适合希望更快看到动静的场景。

maxChars / mediaMaxMb

一个管文字单条最多多少字,另一个管媒体包裹最大能有多重。

disableBlockStreaming

默认会块级流式输出;打开这个禁用项后,就等完整回复写完再一次发。

第五站

排查问题时,先按“钥匙、门、喊没喊名字”来查

元宝这页的故障排查,其实可以缩成几个很直白的问题。

机器人没收到消息

检查元宝应用里的机器人是否创建并通过审核,appKeyappSecret 是否写对,Gateway 是否在运行。

群里没反应

先确认机器人在群里,再确认有没有 @ 它,最后看 openclaw logs --follow

回复为空或走兜底话术

先看模型有没有真的返回内容;默认兜底句是“暂时无法解答,你可以换个问题问问我哦”。

App Secret 泄漏

不要犹豫:在元宝应用里重置 secret,更新配置,然后重启 Gateway。

最后总结

把 Yuanbao 这页压成一句话

元宝通道就是给 OpenClaw 接上一台腾讯元宝机器人:拿好 appKey:appSecret,守好私聊和群聊规则,再按消息长度和流式策略把回复稳稳送出去。