OpenClaw是一个完全本地运行的个人 AI 助手框架，支持多平台消息渠道、本地大模型推理、可视化控制面板和丰富的扩展功能。很多用户在首次部署后，最容易卡住的环节就是设备授权——浏览器打开页面却显示空白或“Device not approved”，执行 openclaw devices approve 又提示找不到设备或命令无效。
本文重点解决 “devices approve 怎么排错” 这个最常见痛点，同时系统化梳理 OpenClaw 的基础命令与进阶用法，帮助你从新手快速进阶到熟练掌控本地 AI 助手。
文章导航
1. OpenClaw 核心机制：为什么需要 devices approve？
OpenClaw 的设计理念是“数据永不出本地、控制权永远在你手中”。为此，它默认开启了严格的设备白名单机制：
- 只有明确批准的设备才能访问 Web 控制面板：端口 7860 或 18780。
- 首次访问时，前端会向后端发送一条设备注册请求，生成一条 pending 状态的记录。
- 你必须通过 CLI 命令手动批准这条记录，才能解锁完整界面。
这不是 bug，而是刻意为之的安全设计，防止局域网内其他设备未经许可访问你的 AI 助手。
理解了这个机制，90% 的 “approve 失败” 问题就迎刃而解了。
2. 部署后必做的三件事（缺一不可）
在排错之前，先确认你的部署流程没有遗漏：
- 正确启动服务
使用官方推荐的 docker-compose.yml，挂载 ~/.openclawd 目录，确保配置持久化。 - 必须先用浏览器访问一次
访问 http://localhost:7860（或对应端口），哪怕页面是白的，也一定要打开。这一步才会触发设备注册请求。 - 所有 CLI 命令在宿主机执行
绝不要进入容器内部执行 openclaw 命令，容器内的 CLI 无法读取宿主机的配置。
3. 基础命令全解析：从零到上手
3.1 devices list —— 查看待批准设备（最常用）
openclaw devices list
正常输出示例：
ID Status Created At IP User Agent
a1b2c3d4-e5f6-7890-g1h2-i3j4k5l6m7n8 pending 2026-02-01 18:30:45 127.0.0.1 Mozilla/5.0 ...
- 如果输出为空 → 说明浏览器从未成功发起注册请求。
- 如果显示 pending → 可以进入下一步 approve。
3.2 devices approve —— 批准设备（核心命令）
openclaw devices approve a1b2c3d4-e5f6-7890-g1h2-i3j4k5l6m7n8
注意：参数是 list 命令输出的完整 ID，不能写成 “request” 或其他字符串。
成功后提示：
Device approved successfully.
此时回到浏览器强制刷新（Ctrl+Shift+R），即可看到完整控制面板。
3.3 dashboard —— 获取带 token 的安全访问链接（远程必备）
openclaw dashboard
输出示例：
Dashboard URL: http://127.0.0.1:7860/?token=xxxxxx
建议使用 SSH 隧道远程访问：
ssh -N -L 7860:127.0.0.1:7860 user@your-server-ip
远程部署时必须使用带 token 的链接，否则会提示 unauthorized。
4. devices approve 排错全攻略（99% 问题在此解决）
以下是真实用户遇到频率最高的前 6 类问题，按出现概率排序：
| 序号 | 现象描述 | 根本原因 | 一键解决方法 |
|---|---|---|---|
| 1 | devices list 返回空 | 浏览器未触发注册请求 | 重新打开 http://localhost:7860（确保不是 https），关闭广告拦截插件后重试 |
| 2 | approve 提示 “device not found” | 使用了错误 ID 或在容器内执行命令 | 在宿主机执行 devices list，复制完整 ID 重试 |
| 3 | 批准后页面仍白屏 | 浏览器缓存旧状态 | 强制刷新 Ctrl+Shift+R，或直接使用 dashboard 命令生成的带 token 链接访问 |
| 4 | CLI 命令提示 “config file not found” | 配置路径错误或未挂载 ~/.clawdbot | 检查 docker-compose volumes 是否正确挂载，或指定 CLAWDBOT_CONFIG_PATH 环境变量 |
| 5 | 远程服务器上 dashboard 无 GUI 提示 | 在无图形界面的服务器直接执行 dashboard | 复制输出的 SSH 隧道命令，在本地执行后再打开本地 localhost:7860 |
| 6 | 多次 approve 后仍提示未授权 | 多次访问生成了多条 pending 记录，只批准了一条 | 执行 devices list 批准所有 pending 记录 |
5. 进阶命令：让 OpenClaw 更听话
掌握基础三命令后，可以进一步解锁更多功能：
5.1 models list —— 查看已注册模型状态
openclaw models list
输出关键字段说明：
– LocalAuth: yes → 表示成功连接本地 vLLM/Ollama
– Context → 显示上下文窗口大小
5.2 config show —— 查看当前生效配置
openclaw config show
可快速确认配置路径、模型 providers、web 端口等是否正确。
5.3 restart —— 平滑重启服务（推荐）
openclaw restart
比 docker compose restart 更优雅，会保留当前会话状态。
5.4 logs —— 查看实时日志（排错神器）
openclaw logs -f
或指定行数：
openclaw logs --tail 100 | grep -i error
6. 模型配置进阶：让本地 Qwen3 真正跑起来
授权成功只是第一步，模型连接才是灵魂。
推荐配置方式（编辑 ~/.openclaw/openclaw.json）：
{
"models": {
"mode": "merge",
"providers": {
"vllm": {
"baseUrl": "http://localhost:8000/v1",
"apiKey": "sk-local",
"api": "openai-responses",
"models": [
{
"id": "Qwen3-4B-Instruct-2507",
"name": "Qwen3-4B本地版"
}
]
}
}
}
}
关键点：
– baseUrl 必须是 http://localhost:8000/v1（容器内视角）
– 在 Web UI 中对应填写 http://host.docker.internal:8000/v1
修改后执行：
openclaw restart
openclaw models list
看到 LocalAuth: yes 即成功。
7. 完整操作流程速查
- 启动服务 → docker compose up -d
- 浏览器访问 http://localhost:7860（必须）
- openclaw devices list → 复制 ID
- openclaw devices approve [ID]
- 强制刷新页面 → 进入控制台
- 配置模型 → 编辑 openclaw.json → openclaw restart
- openclaw models list 验证连接
- 开始聊天！
8. 掌握命令，就是掌握本地 AI 的主动权
OpenClaw 的命令设计极其简洁，却足够强大。devices list、approve、dashboard 这三条命令解决 95% 的新手问题，而 models list、config show、logs 等进阶命令能让你精准定位任何异常。
当你熟练掌握这些命令时，你会发现：本地 AI 助手不再是“黑盒”，而是一个完全透明、可控、可调试的个人智能基础设施。
现在就打开终端，执行 openclaw devices list，看看你的设备是否已经在等待批准吧！
延展阅读：
抖音dou+怎么投放效果最好？如何制作优质视频？Dou+精准投放实战手册来啦！
