三条命令把 QQ 接入 OpenClaw 小龙虾:最简安装教程 + 一个必改的安全设置
为什么要用 QQ 接入?
图01: 腾讯云免费安装小龙虾
最近小龙虾(OpenClaw)在国内火得有点离谱。腾讯云的工程师在深圳南山总部大厦楼下摆摊,帮路人免费安装 OpenClaw 小龙虾。还有很多地方出现了付费帮人安装 OpenClaw 小龙虾的上门服务,一次有 500 块钱,甚至有 1000 块钱。
但装上之后呢?要和小龙虾沟通、操纵它干活,目前最常用的方式是 Telegram 或 Discord。问题是,这两个软件对国内用户来说访问不太方便,配置门槛也不低。
在国内,大家最熟悉的社交软件当然是 QQ 和微信。所以腾讯 QQ 团队推出了 QQ Bot,可以直接连接 OpenClaw,让你用 QQ 就能操控小龙虾。
图02: QQ-BOT接入小龙虾
这篇文章就是一篇纯安装教程:三步 + 三条命令,从 0 到跑通。最后我还会讲一个必须做的安全设置——不做的话,任何人都可能通过你的 Bot 控制你的电脑。
你不需要懂技术原理,跟着做就行。
前提条件
在开始之前,请确认你已经具备以下条件:
一台已安装 OpenClaw 的电脑(Mac / Linux / Windows 均可)
一个 QQ 账号(手机上能正常登录 QQ)
OpenClaw 已经能正常运行(如果你还没装过 OpenClaw,请先参考《OpenClaw 完全新手教程》完成安装)
第一步:在 QQ 开放平台创建机器人
用手机 QQ 扫码登录 QQ Bot 网页。
登录后授权,系统会引导你进入 QQ 开放平台。在这个平台里,你可以创建属于自己的机器人。
操作步骤:
点击「创建机器人」
填写机器人的名称、简介
上传头像(可选)
点击确认
创建完成后,系统会生成两个关键信息:
APP ID
APP Secret
⚠️ APP Secret 只会显示一次,请务必复制保存好,后面配置会用到。
第二步:执行三条命令,把 QQ 接入 OpenClaw
机器人创建好后,接下来只需要在终端执行三条命令,就能完成接入。
命令 1:安装 QQ Bot 插件
打开终端,复制粘贴以下命令执行:
openclaw plugins install @sliverp/qqbot@latest
系统会自动下载并安装 QQ Bot 插件。等待安装完成即可。
命令 2:添加 QQ Channel
继续在终端执行:
openclaw channels add --channel qqbot --token "<Your token>"
按照提示,选择添加 QQ 渠道,输入你刚才保存的 APP ID 和 APP Secret。
命令 3:重启小龙虾
openclaw gateway restart
重启完成后,回到 QQ,刷新好友列表——你会发现多了一个机器人。
现在你可以直接给它发消息测试:
你好,请做个自我介绍。
如果它开始响应,说明配置成功了 🎉
第三步:体验小龙虾的能力
通过 QQ,你可以让小龙虾帮你做很多事情,比如:
读取本地文件:让它帮你查找、整理电脑上的文档
做数据分析:给它一份数据,让它帮你分析、出图表
打开浏览器:让它帮你搜索信息、访问网页
执行电脑操作:自动化日常任务
基本上,你在 Telegram 里能让小龙虾做的事,大部分也可以通过 QQ 来完成。
图03: QQ远程控制小龙虾
三个重要注意事项
1. 斜杠命令兼容性
小龙虾支持很多斜杠命令(比如 /model 切换模型、/status 查看状态等)。
QQ 版目前支持一些基础斜杠命令,但比较复杂的命令暂时还不完全兼容。如果某个命令在 QQ 里没有反应,那么你可以尝试用自然语言向它下命令。
2. Session 共享问题
这个稍微技术一点,但你需要知道:
QQ Bot 使用的是 OpenClaw 主 Agent 的对话 Session,而不是独立 Session。
这意味着:
你在 QQ 里的对话和主 Session 是共享的
如果你在 QQ 里执行非常复杂的任务,如果挂住了主Agent,可能会影响所有的Session任务,甚至影响稳定性
相比之下,Telegram 等渠道通常每个会话都有独立 Session,互不干扰。
这是目前 QQ 插件的一个限制,后续版本应该会改进。
3. 安全设置(最重要!)
这是整篇文章最关键的部分,请一定要做。
打开 OpenClaw 的配置文件 openclaw.json(通常在 ~/.openclaw/ 目录下)。
在 QQ Bot 的配置里,有一个参数,allowFrom:
"qqbot": {
"enabled": true,
"allowFrom": [
"*"
],
"appId": "<Your App ID>",
"clientSecret": "<Your App Secret>"
}
默认值是 *,意思是:任何人在 QQ 上给你的 Bot 发消息,系统都会当成主人发送的指令来执行。
这个风险有多大?想象一下:
别人把你的 Bot 加为好友 → 他可以给你的小龙虾下指令
别人把你的 Bot 拉进群 → 群里所有人都能控制你的电脑
他们可以读取你的文件、执行命令、甚至操作你的系统
解决办法很简单:把 allowFrom 从 * 改成你自己的 QQ 用户 OpenID。
你的 OpenID 在哪里找?
打开
~/.openclaw/qqbot/data/目录里面会有一个 JSON 文件,记录了你的用户身份信息
找到你的 OpenID,复制出来
然后把配置改成:
"allowFrom": "<Your OpenID>"
保存后,重启 OpenClaw Gateway:
openclaw gateway restart
重启后再测试:只有你本人发消息,Bot 才会响应。其他人发消息不会被执行。
总结:入门用 QQ,进阶用 Telegram/Discord
QQ 接入 OpenClaw 小龙虾的最大价值,就三个字:门槛低。
不需要科学上网
不需要配置复杂的 Telegram Bot
三条命令跑通,用最熟悉的聊天工具直接上手
但它目前也有一些限制:复杂斜杠命令支持不完整、Session 共享可能影响资源占用。
所以我的建议是:
别一上来就追求最复杂的配置。先让它在你手里真正跑起来、干起活来,这才是最重要的。
我是范凯说AI。我会持续用最接地气的方式,把 OpenClaw / 小龙虾讲清楚,教到你真的用起来。





