OpenClaw 4.26 这次更新,终于能接 QQ 了:从创建 Bot 到群聊可用,我把命令整理好了
一篇可以直接照着做的 OpenClaw 接入 QQ Bot 实操稿:从 QQ 开放平台创建 Bot,到 OpenClaw 渠道接入、群聊配置、Gateway 重启和常见踩坑,一次讲清。
大家好,我是 One,
兄弟们,OpenClaw 这次更新里,有个点很多人可能一眼就划过去了:
QQ Bot。
但我说实话,这东西不该被划过去。
因为这不是“又多一个渠道”。
这是 OpenClaw 开始继续往国内这种现成聊天场景里钻了。
你如果只是自己本地玩玩 Agent,可能会觉得一般。
但你只要在做下面这些事,这个更新就很现实:
-
社群问答 -
群内助手 -
私聊接待 -
内容分发 -
图片、语音、文件收发 -
把 Agent 塞进你已经有人的地方
很多工具不是死在能力不够。
是死在 没有入口。
而 QQ 这种入口,你别笑,直到今天都还有大量老社群、垂类群、关系链在用。
所以这篇我不写成新闻复读。
我直接把 从创建 Bot 到群聊可用 这条最小链路给你捋顺。

一、先说结论:这次 QQ Bot 真正值钱的,不是“能聊”,而是“能进场景”
我先把结论摊开。
OpenClaw 这次的 QQ Bot,不是做了个只能回两句的聊天壳子。
文档里给的信息其实很明确,它支持:
-
私聊 -
群聊 @消息 -
guild 频道消息 -
图片、语音、视频、文件
而且它还是 bundled plugin。
这句话别看轻。
它的意思是:正常新版 OpenClaw,不需要你再额外装一个 QQ 渠道插件。
很多人最烦的不是配置本身,而是配置前还要先过一层插件安装、版本兼容、依赖冲突。
现在这层少了,落地门槛就低很多。

二、第一步:先去 QQ 开放平台把 Bot 建出来
这一步没什么花活。
去 QQ Open Platform,扫码登录,创建 Bot。
你最终要拿到两个东西:
-
AppID -
AppSecret
这里我先提醒你一个很容易翻车的点:
AppSecret 不是一直摆在那儿给你慢慢看的。
文档里明确写了,你如果离开页面没保存,后面可能就得重新生成。
所以别一边开着页面,一边去刷别的教程。
先把这俩东西记好,再继续往下走。
三、第二步:把 QQ 渠道加进 OpenClaw
最小命令其实很简单:
openclaw channels add --channel qqbot --token "***"
这里这个 token,对应的就是你的 AppSecret。
但注意,只有 AppSecret 还不够。
AppID 也得已经在配置里,或者通过环境变量给进去。
如果你更习惯直接看配置,最小写法长这样:
{ "channels": { "qqbot": { "enabled": true, "appId": "YOUR_APP_ID", "clientSecret": "YOUR_APP_SECRET" } }}
如果你准备长期跑,secret 最好别明文硬写死。
文档也支持走文件方式,能少留一个明文口子就少留一个。
四、第三步:配完别瞎猜,先重启 Gateway
很多人一配完配置,最喜欢干的一件事就是:
直接开聊。
然后发现没反应,就开始怀疑配置、怀疑渠道、怀疑人生。
先做这个:
openclaw gateway restart
然后再查状态:
openclaw gateway statusopenclaw --version
这几条命令一点都不炫。
但说白了,排错的时候,炫没用。
确认版本、确认 Gateway、确认配置生效,才有用。

五、第四步:想让它在群里可用,重点不是群名,是 Group OpenID
这块特别容易搞错,我单独拎出来讲。
QQ Bot 的群聊配置,用的不是你平时看到的群名字。
而是:QQ group OpenID。
一个最小示例我给你贴一下:
{ "channels": { "qqbot": { "groupPolicy": "allowlist", "groups": { "*": { "requireMention": true, "historyLimit": 50, "toolPolicy": "restricted" }, "GROUP_OPENID": { "name": "Release room", "requireMention": false, "ignoreOtherMentions": true, "historyLimit": 20, "prompt": "Keep replies short and operational." } } } }}
这里你重点盯四个地方:
-
requireMention -
historyLimit -
toolPolicy -
ignoreOtherMentions
如果你刚开始接,我建议默认先开 requireMention: true。
别上来就让它在群里自由发挥。
先要求 @bot 再回复,安全很多,也稳很多。
六、为什么这事不是“又一个机器人”,而是你的 Agent 终于有了国内入口
很多人会问,这和以前那些群机器人有啥区别?
区别不在“它能不能回消息”。
区别在于:它背后接的是 OpenClaw。
也就是说,它不只是一个固定话术壳子。
理论上它还能继续接:
-
工具 -
Agent 配置 -
任务流 -
多模态输入 -
文件处理
所以这事真正值钱的地方,不是 QQ 多了个机器人。
而是:你的 Agent 终于能进一个更接近国内真实使用场景的入口。
七、几个最容易踩的坑,我直接给你列出来
1)别把 AppSecret 搞丢了
这个前面说过,离开页面没存好,后面可能要重新生成。
2)群配置认的是 OpenID,不是群名
这是最常见误区,很多人就卡在这。
3)刚接入时,默认先走 @提及模式
不要一上来就全自动回复,先稳住边界。
4)先测私聊,再测群聊
私聊通了,再去测群。不然你很难分清,到底是渠道没通、权限不对,还是群策略没配好。
5)先上测试群,别一把梭哈上生产群
尤其你群里已经有客户、有用户、有合作方的时候,这一步别偷懒。
最后一句:别把这事看小了,很多 Agent 最缺的不是脑子,是入口
很多人现在看 Agent,还停留在模型、功能、排行榜那一层。
但真开始干活的人,关心的是另一件事:
这玩意儿到底怎么进场景。
OpenClaw 这次把 QQ Bot 补上,我觉得意义不在“又多支持一个渠道”。
而在:它在继续往真实聊天入口里长。
对做私域的人、做社群的人、想把 Agent 放进国内关系链的人,这一步都很实际。
你今天先别想什么全自动运营、全自动客服、全自动群管家。
先把最小链路跑通:
-
创建 QQ Bot -
记下 AppID和AppSecret -
执行 openclaw channels add --channel qqbot --token "***" -
补上 appId -
重启 Gateway -
先测私聊,再测群聊 -
群里先要求 @bot
很多事,先把门打开,比什么都重要。
以上,
———–划重点———-
如果你最近也在关注 AI、OpenClaw、Agents,想更快接触到互联网最前沿的新趋势、新玩法、新机会,那我还是很建议你去看看生财有术。
很多真正有价值的信息,公开网上不是没有,而是出来得太晚、太碎、太浅。等你看到的时候,往往已经是二手、三手信息了。
而在高质量社群里,你更容易接触到一线实战者的真实反馈,看到项目是怎么跑通的,机会是怎么被发现的,方向是怎么被验证的。
这也是为什么,直到现在,生财依然是很多人获取 AI 和互联网高质量信息的重要入口。
你获得的不只是信息本身,更是一个持续更新的认知场和行动场。
如果你想少走弯路,想更早看到机会,想把自己放进真正有价值的信息环境里,现在确实是个不错的时间点。
目前可以免费体验 3 天(勇敢白嫖),不满意全额退款权益,几乎没有太大决策压力。
先进去看看,再决定要不要长期留下。
很多时候,人与人的差距,不是努力程度,而是你站在什么样的信息源旁边。

处理中…
夜雨聆风