AI Skill 大全

QQ 官方机器人配置

从创建机器人到接入 AI 的完整配置流程,含 IP 白名单和常见故障排查。

功能与用途

完整走一遍:先在 QQ 机器人平台扫码登录、完成开发者实名认证、创建机器人,记下 AppID 和 AppSecret——注意 AppSecret 只显示一次必须立刻保存。然后配置 IP 白名单,家庭宽带需要公网 IP 并处理动态变化问题。接着在配置文件里填入 QQ 频道配置,部署机器人程序,用脚本启动并查看日志。常见问题也给了排查方案,比如错误 11298 表示 IP 不在白名单,收不到消息通常是事件权限没开。

适用场景

  • 官方机器人初次建联配置:指导在官方平台完成实名与机器人创建,正确记录凭证并配置OpenClaw的通道参数。
  • 公网与动态IP白名单调试:获取当前网络公网IP并写入控制台白名单,解决11298错误及宽带IP变动导致的鉴权中断。
  • 消息事件监听与权限排查:排查机器人无法收发群聊或私聊消息的故障,配置正确的WebSocket长连接与Intents权限位。
  • 守护进程部署与日志运维:使用后台守护脚本启动机器人服务,实时监控WebSocket连接心跳与AI回复消息队列。

适用人群

  • 开发者
  • 技术爱好者
  • 创业者

使用步骤

  1. 到 QQ 机器人平台扫码登录并完成开发者实名认证。
  2. 创建机器人并立即保存 AppID 与 AppSecret(AppSecret 只显示一次)。
  3. 获取公网 IP 并配置到控制台的 IP 白名单。
  4. 在配置文件中填入 QQ 频道配置,部署并启动机器人程序,查看日志确认。

开始使用

将需求和 Skill 名称发送给已连接 SkillPX MCP 的 AI 助手,核对适用工具和安装要求。

查看 MCP 接入说明

技术信息

分类
编程
适用工具
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
  • 读取用户主动提供的内容

同类 Skill