安装 OpenClaw 的 QQ 机器人插件并不复杂,主要就是在 OpenClaw 的运行环境中,通过终端执行一条安装命令
安装 OpenClaw 的 QQ 机器人插件并不复杂,主要就是在 OpenClaw 的运行环境中,通过终端执行一条安装命令。整个过程可以分为三步,我来帮你梳理一下:
🛠️ 第一步:安装 QQ 机器人插件
在你的 OpenClaw 运行环境(比如本地电脑或云服务器)的终端中,直接运行以下命令即可完成插件安装:
openclaw plugins install @sliverp/qqbot@latest 这条命令会从官方渠道拉取并安装最新的 QQ 机器人插件 。
🔑 第二步:配置机器人凭证(AppID 和 AppSecret)
插件安装好后,需要将它和你在 QQ 开放平台创建的机器人“绑定”起来,这步是关键。
- 获取凭证:首先,你需要登录 QQ 开放平台,在你的机器人应用管理后台的“开发管理”模块里,找到并记录下 AppID 和 AppSecret(机器人密钥)。这两个是机器人的唯一身份凭证,请务必妥善保管 。
添加通道:在终端中执行以下命令,将你获取到的 AppID 和 AppSecret 替换进去,完成通道配置:
openclaw channels add--channel qqbot --token"你的AppID:你的AppSecret"例如,如果你的 AppID 是 123456,AppSecret 是 abcdefg,那么命令就是 openclaw channels add --channel qqbot --token "123456:abcdefg" 。
🚀 第三步:重启服务并验证
配置完成后,需要重启 OpenClaw 的网关服务,让新配置生效:
openclaw gateway restart 之后,你就可以在手机 QQ 上找到你创建的机器人,给它发送消息,看看它是否能智能地回应你。如果一切顺利,恭喜你,接入成功!
✨ 一些小提示
- IP 白名单:为了安全,QQ 开放平台通常要求配置 IP 白名单。你需要将运行 OpenClaw 的服务器公网 IP 地址,添加到机器人后台的“IP 白名单”中,否则机器人可能无法正常工作 。
- 沙箱配置:新创建的机器人一般处于“沙箱环境”,你需要在该环境中添加测试成员的 QQ 号,这些被授权的账号才能与机器人对话 。
- 模型配置:别忘了提前为 OpenClaw 配置好可调用的 AI 模型(如阿里云百炼),这是机器人能够智能回复的基础 。
如果在配置过程中遇到什么问题,比如命令执行报错或者机器人没有反应,随时可以再问我,我们一起看看怎么解决。