对 ClawdBot Web Dashboard 无法访问的问题，梳理了四种常见原因及解决方案。首先检查设备授权状态，若为 pending 需手动 approve；其次确认服务监听地址，默认仅绑定 127.0.0.1，远程访问需修改配置或 SSH 转发；第三确保使用包含 token 的完整链接访问；最后验证 vLLM 后端是否就绪及配置匹配。按此顺序排查可解决大部分部署问题。
ClawdBot 是一个你可以在自己设备上运行的个人 AI 助手，本应用使用 vLLM 提供后端模型能力。它不像云端服务那样需要注册账号、等待排队或担心隐私泄露，而是一个真正属于你自己的本地化智能中枢——能对话、能推理、能调用工具、还能通过 Web 界面直观管理所有功能。
但很多用户在首次部署后会遇到同一个问题：打开浏览器输入 http://localhost:7860 或类似地址，页面却显示'无法访问此网站''连接被拒绝''空白页'甚至直接 404。这不是模型没跑起来，也不是代码写错了，而是 ClawdBot 的 Web Dashboard 有一套：它默认不对外暴露，也不自动放行任何访问请求。就像家门装了智能门锁，钥匙得亲手配、访客得亲自确认。
本文聚焦于实际部署中导致访问失败的 4 种高频原因，并给出对应的修复方案——全部基于真实终端操作和配置文件修改，不依赖猜测，不绕弯子。
ClawdBot 的 Web 控制台采用设备配对机制（Device Pairing），首次访问时，前端会向后端发起一个认证请求，该请求不会自动通过，而是进入 pending 状态。此时 Dashboard 页面加载失败，但后端其实已正常运行。
在终端中执行：
clawdbot devices list
如果输出中包含类似以下内容，且状态为 pending，就说明问题在此：
ID Status Created At Last Seen d1a2b3c4 pending 2026-01-24 14:22:03 -
注意：这个命令必须在 ClawdBot 进程正在运行的前提下执行。如果提示
command not found，请先确认是否已正确安装并激活环境。
复制上面输出中的 ID（如 d1a2b3c4），执行批准命令：
clawdbot devices approve d1a2b3c4
成功后你会看到类似提示：
Device d1a2b3c4 approved. You may now access the dashboard.
此时刷新浏览器，Dashboard 即可正常加载。
这是 ClawdBot 的隐私保护设计。它默认不信任任何未经验证的客户端连接，避免本地服务被局域网内其他设备意外访问或扫描。你完全掌控谁可以连上你的 AI 助手——就像给路由器后台加了一道二次确认。
ClawdBot 默认将 Web UI 绑定在 127.0.0.1:7860，这意味着它仅接受本机回环访问。如果你是在远程服务器（如云主机、树莓派）上部署，然后从自己电脑的浏览器访问 http://服务器 IP:7860，就会失败——因为服务根本没监听那个 IP。
执行以下命令查看当前监听地址：
ss -tuln | grep :7860
如果输出只有：
tcp LISTEN 0 5 127.0.0.1:7860 0.0.0.0:* users:(("clawdbot",pid=1234,fd=10))
说明它只监听 127.0.0.1，不响应外部请求。
编辑配置文件 /app/clawdbot.json（或 ~/.clawdbot/clawdbot.json）：
{
"web": {
"host": "0.0.0.0",
"port": 7860,
"enableCors": true
}
}
注意："host": "0.0.0.0" 表示监听所有网络接口；"enableCors": true 允许跨域请求（否则前端资源可能加载失败）。
保存后重启 ClawdBot 服务（如使用 Docker，则 docker restart clawdbot）。
无需改配置，直接在本地电脑终端执行：
ssh -N -L 7860:127.0.0.1:7860 user@your-server-ip
然后在本地浏览器打开 http://localhost:7860 即可。这种方式不暴露服务到公网，所有流量经 SSH 加密隧道传输，安全性更高。
ClawdBot 的 Dashboard 启用了 token 认证机制，每次启动都会生成一个一次性访问令牌（token）。即使服务已运行、地址也正确，缺少 token 的 URL 仍会被拒绝访问。
在终端中运行：
clawdbot dashboard
你会看到类似输出：
Dashboard URL: http://127.0.0.1:7860/?token=23588143fd1588692851f6cbe9218ec6b874bb859e775762
这个完整链接才是有效的。只访问 http://127.0.0.1:7860 是不行的。
http://127.0.0.1:7860 后手动拼接 tokenDashboard URL: 后的链接，包括 ?token=... 部分clawdbot dashboard 获取新链接若希望每次启动都用固定 token，可在配置中指定：
{
"web": {
"token": "my-super-secret-token-2026"
}
}
这样生成的链接就是 http://127.0.0.1:7860/?token=my-super-secret-token-2026，便于书签收藏或自动化脚本调用。
ClawdBot 的 Web 界面本身轻量，但它严重依赖后端 vLLM 服务提供模型推理能力。如果 vLLM 未启动、端口冲突、模型加载失败，Dashboard 虽然能打开，但会出现'加载中…''模型不可用''Connection refused'等提示，甚至白屏。
ClawdBot 自带诊断命令：
clawdbot models list
正常输出应类似：
Model Input Ctx Local Auth Tags vllm/Qwen3-4B-Instruct-2507 text 195k yes yes default
如果报错如 Error: failed to connect to vLLM at http://localhost:8000/v1，说明 vLLM 服务未运行或地址配置错误。
打开 /app/clawdbot.json，确认 models.providers.vllm.baseUrl 与你实际运行的 vLLM 地址一致：
"providers": {
"vllm": {
"baseUrl": "http://localhost:8000/v1",
"apiKey": "sk-local",
"api": "openai-responses"
}
}
常见错误：
http://127.0.0.1:8000/v1，但配置写成了 http://localhost:8000/v1（在某些容器环境中二者不等价）8080），但配置仍是 8000localhost修复方法：统一改为 http://host.docker.internal:8000/v1（Docker 容器内访问宿主机）或实际 IP 地址。
如果你尚未启动 vLLM，可用以下命令快速拉起（确保已安装 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，应能列出模型。
Web Dashboard 打不开？别急着重装、别盲目查日志。按下面这个顺序快速排查，90% 的问题都能当场解决：
→ 运行 clawdbot devices list，若有 pending 条目，立即 approve
→ 运行 ss -tuln | grep :7860，若只绑定 127.0.0.1，则改配置 host: "0.0.0.0" 或用 SSH 转发
→ 必须运行 clawdbot dashboard 复制整条 URL，不能省略 ?token=...
→ 运行 clawdbot models list，失败则检查 baseUrl 配置与 vLLM 实际运行状态
这四步不是理论推演，而是从上百次真实部署反馈中提炼出的最小可行路径。它们不依赖经验、不考验耐心，只要照着命令敲，就能看到 Dashboard 真正亮起来。
你不需要成为系统管理员，也不必读懂每一行 JSON。ClawdBot 的设计哲学是：强大，但不复杂；安全，但不繁琐；本地，但不封闭。
现在，关掉这篇指南，打开终端，输入第一条命令——你的个人 AI 助手，只差一次 approve。
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online
基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online
解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具，curl 转代码在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML 转 Markdown 互为补充。 在线工具，Markdown 转 HTML在线工具，online