OpenClaw配置QQ Bot（QQ机器人）

通过沙盒模式将OpenClaw接入QQ，核心流程是先在QQ开放平台创建机器人并完成沙箱配置，然后在部署了OpenClaw的服务器上安装QQ插件并完成对接。整个过程中，“沙盒模式”主要对应QQ开放平台的“沙箱配置”，用于在机器人正式发布前进行私聊测试。

整个过程主要分为以下五个步骤：

第一步：准备工作

在开始配置前，你需要先准备好以下资源和信息：

• 一个已部署的OpenClaw服务：你可以通过云厂商的一键部署包（如阿里云、腾讯云）快速搭建，并确保已配置好大模型的API Key（如阿里云百炼、Kimi等）。
• 服务器的公网IP地址：这是后续配置QQ机器人IP白名单的关键。
• 一个实名认证的QQ开放平台账号：注意，这个账号需要用邮箱单独注册，不能直接用QQ号登录。
• 一个用于测试的个人QQ号：这个QQ号将被添加到机器人的沙箱成员中。

第二步：在QQ开放平台创建机器人并获取凭证

1. 登录并创建机器人：登录QQ开放平台，进入“机器人”页面，点击“创建机器人”，填写名称、简介等信息后提交。
2. 获取核心凭证：创建成功后，进入机器人的“开发管理”页面，找到并妥善保存以下信息：
   AppID：机器人的唯一标识。
   AppSecret：机器人的密钥。注意： 这个密钥在首次查看或生成后仅显示一次，请务必立即复制保存好。
3. 配置IP白名单：在同一个“开发管理”页面，找到“IP白名单”设置，将你部署OpenClaw的服务器公网IP添加进去。这一步至关重要，否则机器人将无法与你的服务器通信。

第三步：配置沙箱环境

1. 进入沙箱配置：在机器人管理页面的左侧导航栏，找到并点击“开发” -> “沙箱配置”。
2. 添加测试成员：

• 在“消息列表配置”中，点击“添加成员”，输入你用于测试的个人QQ号。
• 系统会生成一个二维码，让你的测试QQ号扫码确认。完成后，这个QQ号就可以在私聊中搜索并添加你的机器人为好友了。
• 注意：根据QQ开放平台2026年的规则，沙箱环境目前仅支持私聊（C2C）和频道，暂时不支持添加QQ群进行群聊测试。

第四步：在OpenClaw服务端配置QQ对接

1. 登录服务器：通过SSH等方式登录到你部署OpenClaw的服务器。
2. 安装QQ插件（如需）：如果你使用的不是最新预装插件的镜像，需要手动安装。以常见的Docker部署方式为例，可以先进入OpenClaw的容器环境，然后使用git clone等命令安装QQ渠道插件（通常从GitHub仓库如 sliverp/qqbot 获取）。
3. 添加QQ通道：在服务器命令行中，使用OpenClaw的命令行工具（clawdbot或openclaw）添加QQ机器人通道。将上一步获取的AppID和AppSecret组合成”AppID:AppSecret”的格式填入命令。

# 示例命令
clawdbot channels add --channel qqbot --token "你的AppID:你的AppSecret"

执行后，配置即生效。

第五步：测试与验证

1. 重启网关服务：为了确保所有配置生效，建议重启OpenClaw的网关服务：

   clawdbot gateway restart

2. 开始聊天测试：打开手机QQ或PC QQ，找到你刚才添加的机器人好友，发送一条消息。如果机器人能正常回复你，就说明OpenClaw已经通过沙盒模式成功接入了QQ。

觉得文章有用，微信打赏一元。