QClaw在手机QQ上可用需完成五步：一、扫码注册开发者账号；二、创建机器人并保存Token；三、用三条命令绑定OpenClaw；四、手机QQ添加机器人好友；五、发送指令验证交互正常。
如果您已在电脑端完成 openclaw 环境部署，但尚未在手机 qq 上启用 qclaw 机器人，则可能是由于机器人未创建、token 未正确绑定或频道配置未生效。以下是实现 qclaw 在手机 qq 上可用的具体操作步骤：
一、扫码注册并登录开发者账号
QClaw 的使用前提是拥有 QQ 开放平台的开发者身份。该身份需通过手机 QQ 扫码完成实名认证与账号绑定，确保后续机器人可被平台识别与授权。
1、在 PC 浏览器中打开 QClaw 专用入口：https://q.qq.com/qqbot/openclaw/login.html。
2、使用已实名的手机 QQ 扫描页面右侧二维码，完成快捷登录（若未实名，请先在手机 QQ 设置中完成实名认证）。
3、勾选《QQ 开放平台开发者协议》，点击「同意」，系统自动完成开发者账号注册与绑定。
二、创建 QClaw 专属 QQ 机器人
每个开发者账号可创建最多 5 个独立机器人，用于不同用途。创建过程不涉及代码编写，仅需一次点击即可生成唯一 AppID、AppSecret 及 Token。
1、登录成功后，页面将跳转至控制台，找到显眼的「创建机器人」按钮并单击。
2、在弹出窗口中为机器人设置名称（如“我的龙虾助手”）与头像，点击「确定」。
3、创建完成后，页面立即显示机器人详情，包括AppID、AppSecret 和 Token；请务必复制并安全保存 Token，后续绑定不可再次查看。
三、执行三条命令完成 OpenClaw 绑定
该步骤将机器人接入本地或远程运行的 OpenClaw 实例，使手机 QQ 发出的消息能被正确解析并执行任务。必须在已安装 OpenClaw CLI 的终端环境中操作。
1、执行插件安装命令：openclaw plugins install @sliverp/qqbot@latest。
2、执行频道绑定命令（注意替换引号内内容）：openclaw channels add --channel qqbot --token "你的实际Token"。
3、执行网关重启命令以加载新配置：openclaw gateway restart。
四、在手机 QQ 中添加并启动机器人
绑定成功后，机器人将以独立联系人形式出现在手机 QQ 好友列表中，无需额外安装客户端或切换应用，直接发起聊天即可触发交互。
1、打开手机 QQ，进入「消息」页，点击右上角「+」→「添加好友」→「搜索 QQ 号/手机号」。
2、输入机器人详情页中显示的机器人 QQ 号（非 AppID），该号码通常为纯数字且长度为 10–11 位。
3、发送好友申请，等待系统自动通过（无需对方手动确认）；通过后，机器人头像即出现在好友列表顶部。
4、点击机器人头像进入聊天窗口，发送任意文字（如“你好”），若收到回复则表示 QClaw 已就绪。
五、验证与基础交互测试
为确认全流程无误，需通过最小可行指令验证消息通路、模型调用及响应返回是否正常。此阶段不依赖复杂功能，仅测试端到端链路完整性。
1、在手机 QQ 与机器人聊天窗口中，发送指令：/status（部分部署版本支持）或“你现在能做什么？”。
2、观察是否在 5 秒内收到结构化响应，例如包含“正在运行”“模型已加载”等字样。
3、发送一条含 Markdown 格式的请求，例如：“请用表格列出今日天气与穿衣建议”，确认格式渲染与内容生成均正常。
