OpenClaw 是一个完全本地运行的个人 AI 助手，后端基于 vLLM 推理，前端提供简洁的 Web 控制台。它不依赖任何云服务、不上传数据、不需要注册账号，所有操作都在你自己的设备上完成。很多人第一次启动 OpenClaw 后，浏览器打开 http://localhost:7860 却提示“无法连接”或白屏，这是因为 OpenClaw 内置了设备授权机制——默认拒绝未授权访问。
这正是 devices list 和 approve 两条基础命令的核心作用：让你手动确认并放行当前设备。只有走完这两步，你才能真正进入控制台，和本地模型对话、上传文件、管理历史记录。本文将手把手带你掌握这两条命令的完整用法、执行时机、常见错误以及避坑技巧，让你彻底告别“页面打不开”的困扰。
文章导航
1. OpenClaw 设备授权机制：为什么需要 devices list 和 approve
OpenClaw 的设计理念是“安全第一、控制权归用户”。它把本地 Web 服务默认限制在 127.0.0.1，且要求每台首次访问的设备都必须经过显式授权。这种机制类似手机微信的“登录确认”，但更轻量、更适合本地部署场景。
- 不授权：浏览器只能收到“Device not approved”的提示，无法加载任何界面。
- 授权后：该设备永久获得访问权限（除非手动撤销），后续刷新页面直接进入控制台。
devices list 和 approve 正是实现这一机制的两把钥匙：
– devices list：列出所有正在等待授权的设备请求。
– approve：根据设备 ID 批准指定请求。
这两条命令必须在 OpenClaw 服务已启动的前提下使用，且操作顺序固定：先 list 再 approve。
2. 前置准备：确保 OpenClaw 服务正常运行
在学习命令之前，先确认服务已就绪。推荐使用官方 Docker 镜像一键部署：
docker run -d --name openclaw \
-p 7860:7860 -p 18780:18780 \
-v ~/.openclaw:/app/.openclaw \
-v ~/openclaw-workspace:/app/workspace \
--restart=unless-stopped \
openclaw/openclaw:latest
启动后查看日志确认无误：
docker logs -f openclaw
看到类似以下输出即表示成功：
🦞 OpenClaw 2026.2.1-1 (a1b2c3d) — Gateway ready on ws://localhost:18780
Web UI available at http://localhost:7860
此时 OpenClaw 已在后台运行，vLLM 后端加载默认 Qwen3-4B 模型，Web 服务监听 7860 端口。
3. 详细解析：openclaw devices list 命令
3.1 命令作用
openclaw devices list 用于列出当前所有待授权的设备请求。每当你用浏览器首次访问 http://localhost:7860 时，前端会向后端发送一个设备注册请求，后端生成一条 pending 状态记录。这条命令就是把这些记录打印出来，供你查看并决定是否批准。
3.2 使用时机
- 服务启动后，浏览器首次访问 http://localhost:7860（哪怕只看到白屏也要访问）。
- 访问后立即执行此命令（建议在 30 分钟内，超时后请求会自动失效）。
3.3 正确执行步骤
- 打开浏览器，输入 http://localhost:7860 并回车（必须先触发请求）。
- 切换到终端，执行：
openclaw devices list
- 正常输出示例：
🦞 OpenClaw 2026.2.1-1 (a1b2c3d)
ID: a1b2c3d4-e5f6-7890-g1h2-i3j4k5l6m7n8
Status: pending
Created At: 2026-02-01 14:22:31
IP Address: 127.0.0.1
User Agent: Mozilla/5.0 (X11; Linux x86_64) Chrome/121.0.0.0
关键字段解释：
– ID：一长串 UUID，必须完整复制用于后续 approve。
– Status：pending 表示待批准；approved 表示已通过。
– IP Address：通常为 127.0.0.1（本地访问）。
– User Agent：浏览器标识，可帮助你确认是自己的设备。
3.4 常见问题及解决方案
| 问题现象 | 可能原因 | 解决方法 |
|---|---|---|
| 输出为空列表 | 浏览器未真正发起请求 | 确认已访问 http://localhost:7860；关闭广告拦截插件；检查是否被防火墙阻止 |
| 只显示旧的已批准设备 | 新请求被浏览器缓存拦截 | 强制刷新页面（Ctrl+Shift+R）；或换隐身模式重新访问 |
| 报错 “config path not found” | CLI 未找到配置文件 | 确保 ~/.clawdbot 目录存在且有 clawdbot.json 文件 |
4. 详细解析：openclaw devices approve 命令
4.1 命令作用
openclaw devices approve <device-id> 用于批准指定 ID 的设备请求。批准后，该设备立即获得完整访问权限，可加载控制台界面、切换模型、上传文件等。
4.2 正确执行步骤
- 从
devices list输出中完整复制 ID（包括横杠）。 - 执行命令（替换为实际 ID）：
openclaw devices approve a1b2c3d4-e5f6-7890-g1h2-i3j4k5l6m7n8
- 成功输出示例：
🦞 OpenClaw 2026.2.1-1 (a1b2c3d)
Device approved successfully.
Approved device: a1b2c3d4-e5f6-7890-g1h2-i3j4k5l6m7n8
Dashboard is now fully accessible at http://localhost:7860
- 返回浏览器，按 Ctrl+Shift+R 强制刷新，即可进入完整控制台。
4.3 常见错误及避坑指南
| 错误提示 | 原因分析 | 正确处理方式 |
|---|---|---|
| “device not found” | ID 复制错误或已超时 | 重新执行 devices list 获取最新 ID；确保在 30 分钟内完成操作 |
| “invalid device id format” | ID 复制不完整（缺横杠或多余空格） | 完整复制，不要手动输入；建议用鼠标选中后右键复制 |
| 批准后仍白屏 | 浏览器缓存未清除 | 强制刷新（Ctrl+Shift+R）；或清除站点缓存；或换隐身模式重新访问 |
| 命令无反应或卡住 | ClawdBot 服务异常 | 执行 clawdbot status 检查服务状态；必要时 clawdbot restart 重启服务 |
4.4 进阶操作：撤销授权与批量管理
- 撤销已授权设备：
openclaw devices revoke <device-id>
- 列出所有已授权设备（含历史）：
openclaw devices list --all
- 清空所有授权（谨慎使用）：
openclaw devices revoke --all
这些命令适合多设备场景（如笔记本+手机同时访问）或定期清理。
5. 完整实操流程：从启动到进入控制台只需 3 分钟
- 启动 OpenClaw 服务（docker run …）。
- 浏览器访问 http://localhost:7860（触发请求）。
- 终端执行
openclaw devices list，复制 pending 设备的 ID。 - 执行
openclaw devices approve <ID>。 - 浏览器强制刷新，进入控制台。
- （可选）执行
openclaw dashboard获取带 token 的安全链接，用于远程访问。
6. 远程访问场景：结合 dashboard 命令安全连接
如果你在服务器或树莓派上部署，想从另一台设备访问：
openclaw dashboard
输出会包含：
– 一次性 token（24 小时有效）
– SSH 端口转发命令示例
结合 SSH 隧道 + token，即可在公网环境下安全访问本地 OpenClaw，无需暴露端口。
7. 为什么掌握这两条命令就等于掌握了 OpenClaw 的核心？
devices list 和 approve 虽然看似简单，但它们是 OpenClaw 安全模型的基石。掌握它们，你就拥有了：
– 完全控制谁能访问你的 AI 助手
– 快速诊断“页面打不开”的根本原因
– 灵活管理多设备、多用户的访问权限
– 为后续模型切换、文件上传、Telegram 集成打下基础
当你熟练使用这两条命令后，OpenClaw 就真正从“黑盒工具”变成了“可控资产”。后续无论换更大模型、接入 Ollama、部署到边缘设备，这些基础操作都通用。
现在就打开终端，启动 OpenClaw，试试这两条命令吧——几分钟后，你就拥有了一个完全属于自己的本地 AI 工作站。
延展阅读：
Zotero联合DeepSeek，如何自动帮你读文献？Zotero联合DeepSeek有什么功能优势？
抖音dou+投多长时间效果最好？什么时间段适合投放？抖音Dou+投放攻略：最佳时长与黄金时间段全解析
2025年AI智能客服行业趋势分析：哪些平台更有前景？DeepSeek EQ引擎91.2%准确率领跑、全渠道/自适应/情感化技术矩阵解析！
