QQ 官方机器人配置
从创建机器人到接入 AI 的完整配置流程,含 IP 白名单和常见故障排查。
功能与用途
完整走一遍:先在 QQ 机器人平台扫码登录、完成开发者实名认证、创建机器人,记下 AppID 和 AppSecret——注意 AppSecret 只显示一次必须立刻保存。然后配置 IP 白名单,家庭宽带需要公网 IP 并处理动态变化问题。接着在配置文件里填入 QQ 频道配置,部署机器人程序,用脚本启动并查看日志。常见问题也给了排查方案,比如错误 11298 表示 IP 不在白名单,收不到消息通常是事件权限没开。
适用场景
- 官方机器人初次建联配置:指导在官方平台完成实名与机器人创建,正确记录凭证并配置OpenClaw的通道参数。
- 公网与动态IP白名单调试:获取当前网络公网IP并写入控制台白名单,解决11298错误及宽带IP变动导致的鉴权中断。
- 消息事件监听与权限排查:排查机器人无法收发群聊或私聊消息的故障,配置正确的WebSocket长连接与Intents权限位。
- 守护进程部署与日志运维:使用后台守护脚本启动机器人服务,实时监控WebSocket连接心跳与AI回复消息队列。
适用人群
- 开发者
- 技术爱好者
- 创业者
使用步骤
- 到 QQ 机器人平台扫码登录并完成开发者实名认证。
- 创建机器人并立即保存 AppID 与 AppSecret(AppSecret 只显示一次)。
- 获取公网 IP 并配置到控制台的 IP 白名单。
- 在配置文件中填入 QQ 频道配置,部署并启动机器人程序,查看日志确认。
开始使用
将需求和 Skill 名称发送给已连接 SkillPX MCP 的 AI 助手,核对适用工具和安装要求。
技术信息
- 分类
- 编程
- 适用工具
- Codex、Claude Code、OpenClaw、Hermes、国内 Agent
- 使用难度
- 进阶
- 版本
- 1.0.0
- 最近更新
- 2026-05-18
- 文件数
- 3
- 安装包大小
- 自动生成 ZIP
- 安全检查
- 基础检查通过
配置并管理QQ官方机器人,支持身份认证、IP白名单设置、Webhook/WebSocket连接及OpenClaw AI集成。
使用前准备
- QQ 号(建议使用小号)
- 可访问的公网 IP(家庭宽带需处理动态 IP)
- 服务器或本地机器,以及已安装的宿主环境
依赖与权限
- APP_SECRET
- 读取用户主动提供的内容