乐于分享
好东西不私藏

OpenClaw 4.26 这次更新,终于能接 QQ 了:从创建 Bot 到群聊可用,我把命令整理好了

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 放进国内关系链的人,这一步都很实际。

你今天先别想什么全自动运营、全自动客服、全自动群管家。

先把最小链路跑通:

  1. 创建 QQ Bot
  2. 记下 AppID 和 AppSecret
  3. 执行 openclaw channels add --channel qqbot --token "***"
  4. 补上 appId
  5. 重启 Gateway
  6. 先测私聊,再测群聊
  7. 群里先要求 @bot

很多事,先把门打开,比什么都重要。

以上,

———–划重点———-

如果你最近也在关注 AI、OpenClaw、Agents,想更快接触到互联网最前沿的新趋势、新玩法、新机会,那我还是很建议你去看看生财有术

很多真正有价值的信息,公开网上不是没有,而是出来得太晚、太碎、太浅。等你看到的时候,往往已经是二手、三手信息了。

而在高质量社群里,你更容易接触到一线实战者的真实反馈,看到项目是怎么跑通的,机会是怎么被发现的,方向是怎么被验证的。

这也是为什么,直到现在,生财依然是很多人获取 AI 和互联网高质量信息的重要入口。

你获得的不只是信息本身,更是一个持续更新的认知场和行动场。

如果你想少走弯路,想更早看到机会,想把自己放进真正有价值的信息环境里,现在确实是个不错的时间点。

目前可以免费体验 3 天(勇敢白嫖),不满意全额退款权益,几乎没有太大决策压力。

先进去看看,再决定要不要长期留下。

很多时候,人与人的差距,不是努力程度,而是你站在什么样的信息源旁边。

处理中…