OpenClaw �� 腾讯元宝接入小龙虾,3分钟搞定.

前几天我在刷 OpenClaw 的官方文档，翻到社区插件那一页，发现腾讯元宝团队居然给 OpenClaw 做了一个官方插件。

没错，就是那个跟豆包打擂台的元宝——腾讯的亲儿子 AI 助手平台。它的团队亲自写了一个 OpenClaw 插件，让你能把 OpenClaw 的 AI 能力直接接入元宝机器人里。

这意味着什么？你手机上用元宝聊天的那个机器人，背后跑的是你自己配置的 OpenClaw。你想让它用哪个模型就用哪个模型，想给它装什么 skill 就装什么 skill，全由你说了算。

今天这篇就手把手教你把它接上。

元宝插件是什么

简单说，这是一个「通道插件」。OpenClaw 本身只是一个 AI 大脑，它需要通道才能跟外面的世界交互——微信是一个通道，QQ是一个通道，元宝也是一个通道。

这样腾讯家的齐全了，全是官网出的插件，维护、更新肯定有保障。

元宝插件做的事情就是，在 OpenClaw 和元宝机器人之间搭一座 WebSocket 长连接的桥。用户跟元宝机器人发的每条消息，都会通过 WebSocket 实时传到 OpenClaw，OpenClaw 处理后把回复传回去。

整个过程是这样

手机元宝APP → 元宝机器人 → WebSocket → OpenClaw → AI模型 → 原路返回

注意，它只支持 WebSocket 连接模式，不走 HTTP 回调。好处是实时性高，不需要公网 IP，手机上就能跑。

第一步，在元宝 APP 里关联机器人

打开元宝 APP，点「派」页面，点左上角「我的bot」点「创建bot」,最后点「关联OpenClaw」（不同版本入口名可能略有差异）。有三种方式可供选择，我是Windows PowerShell安装的小龙虾，就选择了第二种方式。

复制方式二里面的：AppID 和 AppSecret。

把这两串字符复制下来保存好，后面要用。

第二步，安装元宝插件

OpenClaw 2026.4.10 以上版本才能用这个插件。先检查版本

openclaw --version

版本不对就升级

openclaw update

然后安装插件，一行命令

openclaw plugins install openclaw-plugin-yuanbao

第三步，配置通道

把从元宝 APP 拿到的 AppID 和 AppSecret，用冒号拼在一起传到 OpenClaw

openclaw channels add --channel yuanbao --token "appid:appsecret"

注意格式——冒号前面是 AppID，后面是 AppSecret，中间不能有空格。

如果你不喜欢命令行，也可以用交互式向导

openclaw channels login --channel yuanbao

跟着提示输入 App ID 和 App Secret 就行。

配置完之后重启一下

openclaw gateway restart

搞定。现在你的元宝机器人就已经接上 OpenClaw 了，发消息试试看。

你可能想调的配置

默认配置能用，但用久了你会发现有些细节想调。我把常用的几个列出来。

私聊权限控制

默认所有人都能给你的机器人发私聊。想限制的话

{"channels":{"yuanbao":{"appKey":"你的key","appSecret":"你的secret","dm":{"policy":"allowlist","allowFrom":["user_id_1","user_id_2"]}}}}

policy 有四种选择

• • open——所有人都能聊（默认）
• • allowlist——只有白名单里的人能聊
• • pairing——陌生人发消息会被要求输入配对码，你在后台审核通过才能聊
• • disabled——关闭所有私聊

群聊 @ 要求

默认情况下，机器人在群里必须被人 @ 才会回复。想让它看到每条消息都回

{"channels":{"yuanbao":{"requireMention":false}}}

不过说实话，群聊里建议保持 true，不然机器人太吵了。

消息发送策略

元宝支持两种发消息的方式

immediate——生成一个字就发一个字，实时流式输出。merge-text——攒一批字再发，减少消息条数，体验更像真人打字。

默认是 merge-text，如果你想要实时感

{"channels":{"yuanbao":{"outboundQueueStrategy":"immediate"}}}

禁掉 Markdown 代码块包裹

有些模型回复的时候喜欢把整段话包在 ``` 代码块里，在元宝里很怪。元宝插件默认会注入提示词让模型别这么干，但如果你的模型不听劝，确认一下这个开关是打开的

{"channels":{"yuanbao":{"markdownHintEnabled":true}}}

你可能遇到的坑

第一个，机器人不回消息。

先确认网关在跑——openclaw gateway status。再确认 App Key 和 App Secret 没写错——去元宝 APP 里重新复制一遍。最后看日志——openclaw logs --follow，里面有详细的错误信息。

第二个，群里 @ 了也不回。

默认要求 @ 才回复。先确认你确实 @ 了。再看群聊历史消息数量有没有超限——默认只取最近 100 条作为上下文，如果超过这个数，可能你的 @ 消息被截掉了。

第三个，机器人回复「暂时无法解答，你可以换个问题问问我哦」。

这是元宝插件的默认兜底回复。出现这个说明 AI 模型没返回有效内容。检查你的模型配置是否正确、API key 是否过期。

第四个，App Secret 泄露了。

去元宝 APP 里重置 Secret，更新配置文件，重启网关。三步搞定。

写在最后

腾讯元宝团队亲自给 OpenClaw 做插件这事，本身就挺有意思的。一个大厂的 AI 产品团队，愿意花时间给开源社区做适配，说明 OpenClaw 的生态确实在往好的方向发展。

而且从技术角度看，这个插件的质量不错。WebSocket 长连接、流式输出、群聊管理、多账号、权限控制，该有的功能都有，文档也写得清楚。

如果你手机里正好有元宝 APP，试试把它跟 OpenClaw 接上。把自己的 AI 助手放进元宝里，想怎么玩就怎么玩。

以上，既然看到这里了，如果觉得不错，随手点个赞、在看、转发三连吧～

谢谢你看我的文章，我们，下次再见。

文章内容基于OpenClaw版本2026.5.7。