ClawdBot Web Dashboard 访问失败原因与修复方案

保存后重启 ClawdBot 服务。

2.3 修复方案二：SSH 端口转发（更安全，推荐生产环境）

直接在本地电脑终端执行：

ssh -N -L 7860:127.0.0.1:7860 user@your-server-ip 

然后在本地浏览器打开 http://localhost:7860。

3. Token 链接未正确使用：带 token 的 URL 被忽略

ClawdBot 启用了 token 认证机制，缺少 token 的 URL 会被拒绝访问。

3.1 如何获取有效 Token 链接？

在终端中运行：

clawdbot dashboard 

输出类似：

Dashboard URL: http://127.0.0.1:7860/?token=23588143fd1588692851f6cbe9218ec6b874bb859e775762 

必须完整复制整行链接，包括 ?token=... 部分。

3.2 进阶技巧：让 token 永久生效（可选）

若希望每次启动都用固定 token，可在配置中指定：

{
  "web": {
    "token": "my-super-secret-token-2026"
  }
}

4. vLLM 后端未就绪：Dashboard 已启动，但模型服务不可用

Web 界面依赖后端 vLLM 服务提供模型推理能力。如果 vLLM 未启动、端口冲突或模型加载失败，会出现'加载中…'或白屏。

4.1 如何快速验证 vLLM 是否就绪？

ClawdBot 自带诊断命令：

clawdbot models list 

正常输出应列出模型信息。若报错 Error: failed to connect to vLLM at http://localhost:8000/v1，说明服务未运行或地址配置错误。

4.2 检查 vLLM 配置是否匹配

打开 /app/clawdbot.json，确认 models.providers.vllm.baseUrl 与实际运行的 vLLM 地址一致：

"providers": {
  "vllm": {
    "baseUrl": "http://localhost:8000/v1",
    "apiKey": "sk-local",
    "api": "openai-responses"
  }
}

常见错误包括 localhost 与 127.0.0.1 不等价、端口不一致等。修复方法：统一改为 http://host.docker.internal:8000/v1（Docker 容器内访问宿主机）或实际 IP 地址。

4.3 一键启动 vLLM（以 Qwen3-4B 为例）

确保已安装 vLLM，可用以下命令快速拉起：

python -m vllm.entrypoints.api_server --model Qwen/Qwen3-4B-Instruct --dtype bfloat16 --tensor-parallel-size 1 --port 8000 --host 0.0.0.0 

启动成功后，再次运行 clawdbot models list 应能列出模型。

总结：4 步定位，1 次解决

按顺序排查可解决 90% 的问题：

1. 检查设备授权：运行 clawdbot devices list，若有 pending 条目，立即 approve。
2. 确认监听地址：运行 ss -tuln | grep :7860，若只绑定 127.0.0.1，则改配置 host: "0.0.0.0" 或用 SSH 转发。
3. 使用完整 Token 链接：必须运行 clawdbot dashboard 复制整条 URL，不能省略 ?token=...。
4. 验证 vLLM 后端连通性：运行 clawdbot models list，失败则检查 baseUrl 配置与 vLLM 实际运行状态。