更新时间：2026-03-11

适配版本：预装 centos-stream9 OpenClaw及以上版本的新网云主机应用镜像

一、前置准备工作

正式配置前需完成以下两项准备，缺一不可：

1.  拥有完成实名认证的腾讯 QQ 账号；

2.  已购买新网云主机，且主机预装 OpenClaw 镜像。

二、接入 QQ

2.1 注册并认证 QQ 开放平台

1.  前往 QQ 开放平台，不可直接用 QQ 账号登录，需点击「注册」，输入邮箱创建账号（一个邮箱仅能注册一个，建议用公共 / 企业邮箱），设置 8 位及以上、含数字 + 字母（区分大小写）的登录密码；

2.  首次注册后，按指引设置超级管理员：填写姓名、身份证号、手机号并完成验证码验证，输入超级管理员 QQ 号，用该手机号绑定的手机 QQ 扫码验证，验证后该 QQ 号为账号最高权限管理员；

3.  选择主体类型（本文以「个人」为例），填写主体信息并完成人脸认证：使用超级管理员姓名绑定的手机 QQ 扫码人脸识别，审核通过后完成 QQ 开放平台入驻。

2.2 创建 QQBot 机器人

1.  登录 QQ 开放平台，进入机器人板块，点击「创建机器人」（单账号可创建多个）；

2.  按要求填写机器人信息，填写完成后点击「确认」，进入机器人管理页面：

● 名称：4-30 个字符（1 个中文字 = 2 个字符），需先检测名称可用性；

● 头像：上传 png/bmp/jpeg/jpg 格式图片，无政治敏感、色情内容；

● 描述：限 120 个字。

2.3 获取 AppID 和 AppSecret

1.  在 QQ 机器人管理页面的「开发管理」板块，找到AppID（机器人 ID）和AppSecret（机器人密钥）；

2.  分别点击复制，将两个参数保存至记事本 / 备忘录（注意数据安全，勿泄露）；

3.  重要提示：AppSecret 不支持明文保存，首次查看后若遗忘，需重新生成；本教程创建的 QQ 机器人无需发布上架。

2.4 配置 IP 白名单

1.  登录新网云主机产品控制台，复制部署 OpenClaw 的云主机公网 IP 地址（注意保护，勿对外暴露）；

2.  返回 QQ 机器人开发管理页面，在「IP 白名单」输入框中添加该公网 IP，点击「保存」；

3.  关键提示：提审及上线前 IP 白名单不可为空；若与机器人对话提示「该机器人去火星了，稍后再试吧」，优先排查 IP 白名单配置是否正确。

2.5 沙箱配置

1.  2026 年 1 月 31 日后 QQ 开放平台暂不支持 QQ 群配置，仅支持单独聊天配置，在 QQ 机器人开发管理的「沙箱配置」板块，选择「在消息列表配置（单独聊天场景）」；

2.  点击「添加成员」，设置成员角色（管理员 / 普通成员），添加后使用该成员的 QQ 扫码确认添加机器人；

3.  扫码成功后，该成员的 QQ 消息列表中将出现机器人节点，机器人进入沙箱测试环境；

4.  可选操作：可继续添加更多成员，所有成员均需通过 QQ 扫码完成机器人添加。

三、为 OpenClaw 配置模型和通道

3.1进入claw设置页面

通过http://IP:18789/ 打开openclaw管理界面，点击右上角设置-claw设置；

3.2 模型配置

1.  已获取有效的 API Key（从对应大模型平台申请，如 OpenAI 官网、UCloud UModelVerse 控制台）

2.  OpenClaw 网关已启动（openclaw gateway status 确认状态为 running）

3.  通过终端命令引导配置，无需手动改文件，步骤如下：：

执行模型配置命令：openclaw models add

按终端提示逐步填写（以 OpenAI 兼容接口为例）

配置完成后，终端会提示 Model [名称] added successfully，执行以下命令生效：openclaw gateway restart

3.3 通道配置（QQ）

4.  通道类型选择QQ，在输入框中填写前文保存的QQApp ID和App Secret；

5.  点击确定并确认操作，等待数十秒完成配置；

6.  配置完成后查看通道状态，确保QQ通道显示运行中。

四、与 QQ 机器人进行交互

7.  完成上述模型配置和通道配置后，即可在 QQ 端与接入 OpenClaw 的 QQ 机器人进行互动；

8.  重要限制：目前仅支持单独聊天场景，群聊配置暂被 QQ 开放平台限制。