OpenClaw 是一款真正“本地优先”的个人 AI 助手解决方案。它把大语言模型推理、代理能力、聊天界面、多设备配对等功能整合到一个可控、可扩展的系统中。无论你是想在 Mac mini 上打造私人贾维斯，还是在云服务器上跑 32B 模型网关，或者只是本地快速体验 Web 聊天界面，OpenClaw 的 dashboard（控制台 / Web UI）都是最直观、最常用的入口。
今天这篇教程重点解决一个核心痛点：怎样最快把 OpenClaw Web UI 点亮并正常使用。我们会从零开始讲清楚启动流程、常见卡点、授权配对、模型接入、日常操作，一步不跳。
文章导航
OpenClaw 是什么？为什么它的 dashboard 这么受欢迎
OpenClaw 不是单纯的聊天机器人，也不是另一个需要你自己写 Dockerfile 的推理框架。它更像一个“AI 操作系统网关”：
- 后端支持多种模型提供商：vLLM、Ollama、OpenAI 兼容 API、Qwen、智谱、MiniMax 等
- 前端提供现代化的浏览器控制台：Control UI / Dashboard
- 支持多设备配对、节点管理、技能扩展、Webhook 回调
- 强调隐私：所有推理和对话默认留在本地或你控制的服务器
很多人第一次听说 OpenClaw 是因为它能非常方便地跑 Qwen 系列模型，同时又自带好用的 Web 界面。相比纯命令行工具或只有 API 的项目，它的 dashboard 把 80% 的日常操作都放到了鼠标点击层面——这正是它快速流行起来的原因。
快速启动 OpenClaw Web UI 的三种主流路径对比
| 路径 | 适合人群 | 启动命令核心 | 预计首次可用时间 | 难度 | 推荐指数 |
|---|---|---|---|---|---|
| clawdbot dashboard 直达（本地最快） | 想立刻聊天、不想配对复杂节点 | clawdbot dashboard | 30秒–2分钟 | ★☆☆☆☆ | ★★★★★ |
| clawdbot onboard 一键向导 | 新手完整部署、想配置技能和渠道 | clawdbot onboard | 3–10分钟 | ★★☆☆☆ | ★★★★☆ |
| devices list + approve + dashboard | 远程服务器 / 多设备 / 卡授权时 | 三条命令组合 | 2–5分钟 | ★★★☆☆ | ★★★★☆ |
下面我们按最快路径 → 完整路径 → 排错路径的顺序详细走一遍。
路径一：最快启动——直接用 openclaw dashboard 命令（推荐新手首选）
前提：你已经完成OpenClaw CLI 安装（Node.js ≥22 环境）
- 终端执行
openclaw dashboard - 观察输出，通常会显示类似内容：
🦞 OpeClaw 2026.1.24-3
Dashboard URL: http://127.0.0.1:18789/?token=xxxxxxxxxx...
Or open: http://localhost:18789/ - 浏览器直接访问输出的 http://localhost:18789/?token=xxx（带 token 参数）
- 如果看到登录/欢迎界面，输入 “Hello” 或 “你好”，OpenClaw 会引导你设置昵称和 bot 名字，之后即可正常聊天。
小技巧：
– 每次执行 openclaw dashboard 都会生成新的 token（有效期一般 24 小时）。
– 如果你嫌每次复制 token 麻烦，可以用 --no-open 参数只输出 URL 不自动打开浏览器：openclaw dashboard --no-open
路径二：完整一键部署——用 openclaw onboard 向导（强烈推荐第一次使用）
这条命令会帮你完成大部分初始化工作，包括网关启动、模型提供商选择、技能安装等。
执行：
openclaw onboard
# 或带后台服务安装（推荐长期使用）
openclaw onboard --install-daemon
向导会依次询问：
- 是否安装后台服务（daemon） → 建议 Yes，服务会开机自启
- 网关端口 → 默认 18789，冲突再改
- 模型提供商 → 推荐先选 Qwen（国内免费额度多）或 Ollama（本地模型）
- 是否安装默认技能包 → Yes
- 是否开启浏览器自动化等高级功能 → 根据需求
完成后会提示 Dashboard 地址，操作同上。
onboard 完成后常用验证命令
| 命令 | 作用 |
|---|---|
| clawdbot status | 查看网关、dashboard 是否运行正常 |
| clawdbot health | 健康检查 |
| clawdbot doctor | 环境诊断 + 常见问题建议 |
路径三：远程服务器 / 多设备场景必备——devices list + approve 授权流程
这是最容易卡住新手的地方，尤其在 VPS、云主机、Docker 部署时经常出现“disconnected (1008): device identity required / pairing required”。
标准三步授权流程：
- 先确保网关已经在运行（onboard 或 gateway start 已执行）
- 在浏览器访问 http://localhost:18789/（或远程隧道后的地址），此时通常会显示未授权或连接失败
- 回到服务器终端，依次执行：
openclaw devices list
输出示例：ID Status LastSeen IP
a1b2c3d4-e5f6-7890-g1h2-i3j4k5l6m7n8 pending 2026-02-01 14:30:22 127.0.0.1 - 复制 pending 的那条 ID，执行批准：
openclaw devices approve a1b2c3d4-e5f6-7890-g1h2-i3j4k5l6m7n8
成功后输出：Device approved. You may now access the dashboard. - 刷新浏览器 → Web UI 应该正常加载
远程访问额外步骤（云服务器常用）
在本地电脑执行 SSH 端口转发：
ssh -N -L 18789:127.0.0.1:18789 user@你的服务器IP
然后在本机浏览器打开：
http://localhost:18789/?token=xxxx（token 从服务器 openclaw dashboard 获得）
dashboard 界面功能速览（2026 年最新版）
| 区域 / 菜单 | 主要功能 | 实用场景 |
|---|---|---|
| Chat | 核心对话窗口，支持多轮上下文、文件上传 | 日常聊天、写邮件、改代码、总结文档 |
| Models / Providers | 配置模型源、切换默认模型、测试连通性 | 接入 Ollama、本地 vLLM、云 API |
| Config / Settings | token 管理、网关参数、技能开关 | 修改端口、开启 webhook、调整超时 |
| Devices / Nodes | 查看/批准/拒绝设备配对 | 多台电脑/手机共用一个 ClawdBot |
| Sessions / History | 聊天记录管理、导出 Markdown | 回顾对话、整理知识库 |
| Health / Logs | 实时状态、显存占用、请求日志 | 排查慢、OOM、连接中断 |
常见卡点 & 一分钟解决方案汇总
| 现象 | 可能原因 | 快速修复命令 / 操作 |
|---|---|---|
| disconnected (1008): device identity required | 未批准设备 | clawdbot devices list → approve |
| 页面白屏 / 502 | 网关没启动或端口冲突 | clawdbot status → clawdbot gateway –port 其他端口 |
| token 无效 / 过期 | token 已失效 | 重新执行 clawdbot dashboard 获取新 token |
| 模型列表为空 / 无法回复 | 未配置模型提供商 | 进入 Config → Models → 添加 Ollama / Qwen 等 |
| 远程访问连不上 | 没做端口转发或防火墙拦截 | ssh -L 转发 + 检查云服务器安全组放行 18789 |
结语：从零到可用，你其实只差 3–5 分钟
无论你是本地快速试用，还是云上长期部署，OpenClaw Web UI 的启动核心永远围绕这三件事：
- 让网关跑起来：onboard / gateway start
- 拿到有效 token：dashboard 命令
- 完成设备授权：devices approve
做完这三步，你就拥有了一个隐私可控、响应迅速、可自由扩展的个人 AI 中控台。可以聊天、写代码、总结文档、对接飞书/钉钉/企业微信、跑本地 32B 模型……所有操作都在一个现代化的浏览器界面里完成。
现在打开终端，试试下面任一命令吧：
openclaw dashboard
# 或
openclaw onboard
几分钟后，你很可能就会和自己的 OpenClaw 说上第一句话。
延展阅读：
Cursor每月需花费140元？Cursor免费试用额度用完之后该怎么办？cursor+deepseek-r1让你继续免费使用AI编程！
