openclaw-zero-token/TEST_STEPS.md

测试步骤（完整版）

🎯 配置步骤

步骤 1：编译

目的：编译 TypeScript 代码为可执行的 JavaScript

npm install
npm run build

验证：

ls dist/index.mjs
# 应该看到编译后的文件

注意：如果修改了源代码，需要重新编译

---

步骤 2：打开浏览器调试

目的：提供浏览器环境（端口 9222）

./start-chrome-debug.sh

验证：

ps aux | grep "chrome.*9222" | grep -v grep
# 应该看到 Chrome 进程

---

步骤 3：登录各大网站（不含 DeepSeek）

目的：在 Chrome 调试浏览器中建立登录会话

重要：必须在 start-chrome-debug 启动的 Chrome 中登录（不是普通浏览器）。DeepSeek 在第 5 步单独处理

在 Chrome 中打开并登录以下平台：

1. 千问国际版 (Qwen International): https://chat.qwen.ai
2. 千问国内版 (Qwen CN): https://www.qianwen.com
3. Kimi: https://kimi.moonshot.cn
4. Claude: https://claude.ai
5. Doubao: https://www.doubao.com/chat/
6. ChatGPT: https://chatgpt.com
7. Gemini: https://gemini.google.com/app
8. Grok: https://grok.com
9. GLM Web (智谱清言): https://chatglm.cn
10. GLM 国际版: https://chat.z.ai

注意：Manus 使用 API Key 方式认证，不需要浏览器登录。API Key 获取地址：https://open.manus.im

---

步骤 4：配置 onboard

目的：为各平台配置认证信息

./onboard.sh webauth

操作：选择平台（如 deepseek-web），按提示完成认证

---

步骤 5：登录 DeepSeek

目的：在 Chrome 中登录 DeepSeek，并通过 onboard 捕获认证

1. 在 Chrome 中访问 https://chat.deepseek.com 并登录
2. 运行 ./onboard.sh webauth，选择 deepseek-web 完成凭证捕获

---

步骤 6：启动 server

目的：启动 Web UI 服务（端口 3001）

./server.sh start

验证：

./server.sh status
# 应该显示：Gateway 服务运行中

---

访问 Web UI

访问地址：

http://127.0.0.1:3001/#token=62b791625fa441be036acd3c206b7e14e2bb13c803355823

浏览器应该会自动打开，如果没有，手动访问上面的地址。

---

步骤 7：查看所有模型

关键规则（请务必注意）：

• /models 里显示的是已完成 onboard 配置的平台模型集合。
• 只有你在 ./onboard.sh webauth 中实际选择并完成认证的平台，才会写入 openclaw.json 并出现在最终模型列表中。
• 仅在浏览器里登录、但没有走完 onboard 的平台，不会出现在 /models。

在 Web UI 的聊天框中输入：

/models

预期结果：应该看到以下模型

claude-web/claude-sonnet-4-6
claude-web/claude-opus-4-6
claude-web/claude-haiku-4-6
doubao-web/doubao-seed-2.0
doubao-web/doubao-pro
chatgpt-web/gpt-4
chatgpt-web/gpt-4-turbo
chatgpt-web/gpt-3.5-turbo
qwen-web/qwen-max
qwen-web/qwen-plus
qwen-web/qwen-turbo
kimi-web/moonshot-v1-8k
kimi-web/moonshot-v1-32k
kimi-web/moonshot-v1-128k
gemini-web/gemini-pro
gemini-web/gemini-ultra
grok-web/grok-2
grok-web/grok-1
glm-web/glm-4-plus (GLM)
glm-web/glm-4-think (GLM)
manus-api/manus-1.6
manus-api/manus-1.6-lite

---

步骤 8：测试对话

操作：

1. 在 Web UI 中选择一个模型（如 claude-web/claude-sonnet-4-6）
2. 发送测试消息："你好，请介绍一下你自己"
3. 检查是否能正常收到回复

对每个平台重复测试：

• ✅ claude-web
• ✅ doubao-web
• ✅ chatgpt-web
• ✅ qwen-web
• ✅ kimi-web
• ✅ gemini-web
• ✅ grok-web
• ✅ deepseek-web
• ✅ glm-web (GLM)
• ✅ manus-api (需要 API Key)

---

📊 配置流程图

┌─────────────────────────────────────┐
│ 1. 编译                             │
│    npm install && npm run build     │
└──────────────┬──────────────────────┘
               ↓
┌─────────────────────────────────────┐
│ 2. 打开浏览器调试                   │
│    ./start-chrome-debug.sh          │
└──────────────┬──────────────────────┘
               ↓
┌─────────────────────────────────────┐
│ 3. 登录各大网站（不含 DeepSeek）     │
│    (千问、Kimi 等，DeepSeek 在第 5 步)│
└──────────────┬──────────────────────┘
               ↓
┌─────────────────────────────────────┐
│ 4. 配置 onboard                     │
│    ./onboard.sh webauth             │
└──────────────┬──────────────────────┘
               ↓
┌─────────────────────────────────────┐
│ 5. 登录 DeepSeek                    │
│    (Chrome 登录 + onboard 捕获)     │
└──────────────┬──────────────────────┘
               ↓
┌─────────────────────────────────────┐
│ 6. 启动 server                      │
│    ./server.sh start                │
└──────────────┬──────────────────────┘
               ↓
┌─────────────────────────────────────┐
│ 打开 Web UI → http://127.0.0.1:3001 │
│ 输入 /models → 测试对话             │
└─────────────────────────────────────┘

---

🔧 故障排查

问题 1：端口冲突

症状：Gateway 启动失败，提示端口被占用

解决：

# 查找占用 3001 端口的进程
lsof -i :3001

# 关闭进程
kill <PID>

# 或者强制关闭
./server.sh stop

问题 2：Chrome 调试浏览器未启动

症状：onboard 提示无法连接浏览器

解决：

# 检查 Chrome 是否运行
ps aux | grep "chrome.*9222"

# 重新启动
./start-chrome-debug.sh

问题 3：认证失败

症状：测试对话时提示认证错误

解决：

1. 确保在 Chrome 调试浏览器中已登录
2. 重新运行 ./onboard.sh webauth 配置认证
3. 检查 cookie 是否正确

问题 4：模型列表为空

症状：/models 命令没有显示模型

解决：

# 重启 Gateway
./server.sh restart

# 检查配置文件
cat .openclaw-zero-state/openclaw.json | jq '.models.providers | keys'

# 查看日志
tail -f /tmp/openclaw-zero-gateway.log

问题 5：glm-intl-web 认证或 API 错误

症状：glm-intl-web 返回 Authentication expired、API 500/401 等错误。

说明：

• 国际版 https://chat.z.ai/ 的请求链路与 glm-web(chatglm.cn) 不同，接口可能随前端版本变化。
• 当前实现已切换为优先复用浏览器页面（UI 驱动）以提高稳定性。

排查建议：

# 1) 确保调试浏览器与登录状态
./start-chrome-debug.sh

# 2) 重新授权 glm-intl-web
./onboard.sh webauth

# 3) 使用抓包脚本分析真实请求（脚本已迁移到 test/）
node test/fix-glm-intl-api.js

---

📝 快速命令参考

# 首次使用：安装依赖并编译
npm install
npm run build

# 关闭系统 Gateway
openclaw gateway stop

# 启动 Chrome 调试
./start-chrome-debug.sh

# 配置认证
./onboard.sh webauth

# 启动本地 Gateway
./server.sh start

# 查看状态
./server.sh status

# 重启 Gateway
./server.sh restart

# 停止 Gateway
./server.sh stop

# 查看日志
tail -f /tmp/openclaw-zero-gateway.log

# 检查配置
cat .openclaw-zero-state/openclaw.json | jq '.models.providers | keys'

# 检查认证
cat .openclaw-zero-state/agents/main/agent/auth-profiles.json | jq '.profiles | keys'

---

🧪 调试脚本位置

根目录下的 GLM 调试脚本已统一迁移到 test/：

• test/fix-glm-intl-api.js：自动发送测试消息并抓取请求/响应
• test/debug-glm-intl-api.js：持续监听 intl API 请求
• test/debug-glm-requests.js：拦截并打印 POST 请求
• test/capture-glm-api.js：CDP/Fetch 级抓包
• test/quick-debug-glm.js：快速连通性调试
• test/direct-capture.js：WebSocket 直连抓包

---

✅ 测试完成标志

• ✅ 所有 10 个平台都能在 /models 中看到
• ✅ 每个平台都能成功发送消息并收到回复
• ✅ 流式响应正常工作（逐字显示）
• ✅ 没有认证错误或 API 错误

---

祝测试顺利！🚀