安装 OpenClaw 的 QQ 机器人插件并不复杂，主要就是在 OpenClaw 的运行环境中，通过终端执行一条安装命令

06 Apr 2026 — 2 min read

安装 OpenClaw 的 QQ 机器人插件并不复杂，主要就是在 OpenClaw 的运行环境中，通过终端执行一条安装命令。整个过程可以分为三步，我来帮你梳理一下：

在你的 OpenClaw 运行环境（比如本地电脑或云服务器）的终端中，直接运行以下命令即可完成插件安装：

openclaw plugins install @sliverp/qqbot@latest

这条命令会从官方渠道拉取并安装最新的 QQ 机器人插件。

插件安装好后，需要将它和你在 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 模型（如阿里云百炼），这是机器人能够智能回复的基础。

如果在配置过程中遇到什么问题，比如命令执行报错或者机器人没有反应，随时可以再问我，我们一起看看怎么解决。