OpenQQ 用于把 OpenClaw 接入 QQ，实现私聊和群内 @ 消息的 AI 自动回复。
主要能力：会话隔离，每个用户或群拥有独立对话历史，私聊会话 ID 为 qq-private-{user_openid}，群聊为 qq-group-{group_openid}；完善日志，使用中国时区、日志轮转并过滤敏感数据；WebSocket 自动重连与心跳；失败消息自动重试最多 2 次；收到 SIGTERM/SIGINT 时优雅关闭。
使用方式：先运行 npm run setup 初始化配置，再执行 npm install；然后编辑 ~/.openclaw/workspace/open-qq-config.json，填写从 QQ 开放平台获取的 appId、token、appSecret；最后 npm start 启动。其他命令包括 npm run health 健康检查、npm run logs 查看当日日志、npm run status 查看运行状态、npm run clean 清理 node_modules。
安全方面：不要把配置文件提交到版本控制，建议 chmod 600 ~/.openclaw/workspace/open-qq-config.json；程序使用 spawn 而非 exec 以防命令注入，会话 ID 仅允许字母数字和连字符。
常见问题：配置缺失可运行 npm run setup；凭据缺失需编辑配置文件；WebSocket 失败检查 Token 与网络；无回复可用 openclaw agent --message "test" 测试。项目为 MIT 许可，最新版本 v0.0.3。平台支持范围、计费与更多限制暂未提供。