从 npm 安装到 QQ 收到第一条回复，共 12 步，每步都很短
需要 Node.js 22.5 或更高版本，打开「终端」检查：
v22.5.x 或更高就过关。低于 22.5 先去 nodejs.org 装新版。一条命令装好 qbot 命令行工具：
sudo 或配 npm prefix。QBot 让 Codex 干活，先装好 Codex 并登录。两行依次执行：
codex login status 确认。装完重开一个终端，确认命令能找到：
若提示 command not found，把 $(npm config get prefix)/bin 加进 PATH 后重开终端。
控制台是首次配置主入口，会自动建好配置目录和文件：
通过「扫码接入」获取你的专属凭据，填入「配置」这两项，然后点击右上角保存配置：
启动网关后用你的 QQ 给机器人发条消息，再到控制台拉取你的 OpenID：
用任意 QQ 号给机器人发条消息，在自动获取区域，依次点击 拉取 → 采用 → 测试：
私聊用 user_openid，群聊用 member_openid，都不是 QQ 号。
在运行 qbot start 的终端按 Ctrl+C 停止，再重新启动让白名单生效：
在启动日志里找这一行，出现就代表 QQ 网关已就绪：
qbot doctor 体检。用白名单里的账号给机器人发这条消息试试：
常用命令：/reset 清上下文、/new <任务> 开新会话、/stop 中断任务。
想让机器人在指定项目里读写代码，在控制台「配置设置」里填项目根目录，改完点右上角「保存配置」：
保存后自动热加载，无需重启网关。在 QQ 里就能用这些命令切换项目：
项目目录不是安全沙箱，所有白名单用户都能让 Codex 读写所选项目，只配可信用户。
打开控制台查看完整功能手册，了解 QBot 还能做什么：
还能：多机器人实例（qbot new <名字>）、附件回传、常驻局域网网页服务、流式回复、定时提醒等。