Shell / BashAI大前端
OpenClaw 本地安装与 Web UI 使用指南
本文介绍 OpenClaw 在 macOS 环境下的本地安装与配置流程。通过终端执行安装脚本，选择快速启动模式，配置网关端口、模型来源（如 Qwen）及会话管理。支持通过 Web UI 进行交互，包含常用命令、服务启停及故障排查方法，帮助新手快速部署并投入使用。
本文介绍 OpenClaw 在 macOS 环境下的本地安装与配置流程。通过终端执行安装脚本，选择快速启动模式，配置网关端口、模型来源（如 Qwen）及会话管理。支持通过 Web UI 进行交互，包含常用命令、服务启停及故障排查方法，帮助新手快速部署并投入使用。
在开始之前，请先确认你的环境。
请根据你的系统，阅读对应的安装部分即可，后续配置与使用步骤完全一致。
在 Terminal 中执行：
curl -fsSL https://openclaw.ai/install.sh | bash
执行后的结果如下：
安装完成后，会自动启动新手引导，如下图：
这些信息是安装与首次启动说明
当你第一次运行
openclaw，终端里会看到这一大段'很吓人'的 ASCII 画和安全提示。别慌，它主要在做三件事：告诉你这是个很强但也很危险的工具；提醒你不要不懂就直接上线；给你一套最低限度的安全建议；强制风险确认（你必须明确表示：'我知道它很强，也知道有风险'）
这一步必须选择 'Yes'（使用键盘左右键切换选项）。
| 选项 | 含义 | 适合谁 |
|---|---|---|
| QuickStart | 使用推荐的默认配置先跑起来，细节之后再用 openclaw configure调整 | 第一次使用 / 想快速体验 |
| Manual | 手动逐项配置所有选项 | 对配置和安全有经验的用户 |
这一步我们选择 'QuickStart'，选择会出提示如下信息：
| 配置项 | 含义 | 对你意味着什么 |
|---|---|---|
Gateway port: 18789 | OpenClaw 网关监听的端口 | 本机通过该端口访问 |
Gateway bind: 127.0.0.1 | 只绑定本地回环地址 | 只能本机访问，外网连不上 |
Gateway auth: Token | 使用 Token 认证 | 每个请求都需要凭证 |
Tailscale exposure: Off | 不通过 Tailscale 暴露 | 不会自动对外可访问 |
| Direct to chat channels | 直接接入聊天渠道 | 消息直达，不走复杂中转 |
配置的整体含义
只在本机开放、需要认证、不自动暴露到网络。
也就是说：适合第一次跑起来测试默认是'关着门用'的安全模式不会一启动就暴露在公网
这一步是在选择 OpenClaw 使用哪家模型服务，以及如何完成认证。
选项如何理解？
| 选项类型 | 含义 |
|---|---|
| OpenAI / Anthropic / Google 等 | 直接使用官方模型服务 |
| MiniMax / Qwen / Moonshot / GLM | 国内模型厂商 |
| OpenRouter / Vercel AI Gateway | 多模型聚合 / 代理网关 |
| Copilot | 使用已有 Copilot 授权 |
| Synthetic | 本地或测试用的模拟模型 |
| Skip for now | 暂不配置模型 |
怎么选比较合适？
这里极力推荐 Qwen，完全免费（有配合限制），快速搭建使用足够用。 👉 Qwen 配额限制说明
这里我们用 Qwen 的模型，可根据实际情况自行选择
| 选项 | 含义 |
|---|---|
| Qwen OAuth | 通过阿里云官方 OAuth 授权登录 |
| Back | 返回上一步 |
授权成功后，提示如下图：
选择要使用的模型，默认就好。
这一步是在告诉我们：OpenClaw 现在'接到哪里说话'，以及这些聊天渠道是怎么工作的。不是必须立刻配。
此次我们使用 WebUI 对话，因此我们跳过这一步，后面再配置即可。
这一步是在讲 OpenClaw'现在能干多少活'，以及问要不要现在就把能力补齐。
Skills = OpenClaw 可以使用的能力 / 工具集合 比如：读文件、跑命令、调用 API、搜索、写代码等。
Skills status:
Eligible: 3 当前环境下，只有 3 个技能满足条件，可以直接用 Missing requirements: 46 有 46 个技能因为缺依赖 / 没配置 / 权限不足，暂时不可用 （比如没装工具、没授权、没开启） Blocked by allowlist: 0 没有技能被你主动'禁止'
Configure skills now? (recommended)
这是在问你：要不要现在就帮你把可用技能配置好？ Yes 安装必要依赖 引导你启用常用能力 新手更省事 No 以后再配 OpenClaw 仍然能用，但'能干的事很少'
我们本次先将 OpenClaw 安装好，技能配置会在后续文章中详细讲解。
这一步是在问你要不要给 OpenClaw 加'自动化小助手'，以及加哪些。
| Hook | 用途 | 是否推荐 |
|---|---|---|
| 🚀 boot-md | 启动时加载一段初始化说明（如使用说明、约定） | ✅ 新手可选 |
| 📝 command-logger | 记录你执行过的命令 | ⚠️ 调试用 |
| 💾 session-memory | 在特定命令时保存会话上下文 | ✅ 很实用 |
如何选？
🟢 新手推荐（安全、实用）
🟡 不确定 / 想保持最简
🔴 不建议一开始就开
按空格键先中需要的选项
这一步其实是两个独立但连续的确认：① Hooks 已配置完成，② Gateway 服务怎么处理。
| 选项 | 含义 | 什么时候选 |
|---|---|---|
| Restart（推荐） | 重启现有 Gateway | 升级后 / 正常情况 |
| Reinstall | 删除后重新安装 Gateway | Gateway 异常或损坏 |
| Skip | 什么都不做 | 暂时不打算启动 |
怎么选？
这是'最后一步：你准备用什么方式正式启动（孵化）你的 OpenClaw 代理'。
1️⃣ Missing Control UI assets（不用慌）
Missing Control UI assets. Build them with
pnpm ui:build
意思是：
👉 新手 可以完全忽略
2️⃣ Optional apps（可选客户端）
macOS / iOS / Android app
这是在告诉你：
👉 CLI / Web / TUI 已够用
3️⃣ Control UI（当前可用入口）
Web UI: http://127.0.0.1:18789/ Web UI (with token): http://127.0.0.1:18789/?token=... Gateway: reachable
说明：
👉 本地安全可用，未暴露外网
4️⃣ Start TUI（官方强烈推荐）
Start TUI (best option!) This is the defining action that makes your agent you.
意思是：
👉 这是个性和安全边界的核心步骤
5️⃣ Token 说明（你现在只要知道一件事）
Gateway token = Gateway + Web UI 的通行证
6️⃣ 最后的问题：How do you want to hatch your bot?
● Hatch in TUI (recommended) ○ Open the Web UI ○ Do this later
怎么选？
| 选项 | 什么时候选 |
|---|---|
| Hatch in TUI ⭐ | 第一次用，强烈推荐 |
| Open the Web UI | 想用网页操作 |
| Do this later | 先装好，暂时不用 |
Web UI: http://127.0.0.1:18789/
到这里，OpenClaw 已完成安装、配置和首次唤醒。默认会自动打开浏览器访问 Web UI 地址，如没有自动打开跳转，可以将上面网址复制到浏览器中打开。 Gateway 正常运行，模型已接入，核心能力就绪。
此时 WebUI 中的的问答内容都会在刚刚安装时用的终端中显示。
此时也可关闭命令行终端，并不会影响浏览器中 WebUI 的使用。
| 命令 | 作用说明 |
|---|---|
openclaw | 查看 OpenClaw 是否安装成功 |
openclaw version | 查看当前版本 |
which openclaw | 查看可执行文件路径 |
openclaw help | 查看命令帮助 |
| 命令 | 作用说明 |
|---|---|
openclaw setup | 启动首次配置（onboarding） |
openclaw configure | 交互式修改配置 |
openclaw config get <key> | 查看指定配置项 |
openclaw config set <key> <value> | 设置配置项 |
openclaw config edit | 直接编辑配置文件 |
| 命令 | 作用说明 |
|---|---|
openclaw gateway start | 启动 Gateway |
openclaw gateway stop | 停止 Gateway |
openclaw gateway restart | 重启 Gateway |
openclaw gateway status | 查看 Gateway 状态 |
| 命令 | 作用说明 |
|---|---|
openclaw tui | 启动终端交互界面（推荐） |
openclaw dashboard | 打开 Web UI |
openclaw dashboard --no-open | 输出 Web UI 链接但不自动打开 |
| 命令 | 作用说明 |
|---|---|
openclaw logs | 查看运行日志 |
openclaw logs --follow | 实时跟踪日志 |
openclaw doctor --verbose | 输出详细诊断信息 |
openclaw setup
openclaw doctor
openclaw tui
openclaw gateway status
openclaw dashboard
rm /opt/homebrew/bin/openclaw
rm -rf ~/.openclaw
请按下面顺序逐项检查（90% 的问题都在这里）：
1️⃣ 确认 Gateway 服务是否正在运行
在任意终端中执行：
openclaw gateway status
running
→ Gateway 正常，继续检查下一步running
→ 执行：openclaw gateway start
2️⃣ 确认访问地址是否正确
默认地址为：
http://127.0.0.1:18789/
注意事项：
127.0.0.1（不是 localhost、不是局域网 IP）18789，除非你在配置中手动改过3️⃣ 确认端口未被占用或拦截
如有疑问，可重新启动 Gateway：
openclaw gateway restart
4️⃣ 浏览器问题排查（少数情况）
在本文的安装与启动流程下：通常不会发生任何影响。
原因是：
你可以随时重新打开一个新的终端，通过：
openclaw gateway status
来确认当前运行状态。
通常只发生在以下情况之一：
openclaw gateway stop
解决方式通常是：
openclaw gateway start
或：
openclaw gateway restart
可以，而且是设计上就允许反复修改的。
常用方式包括：
openclaw configure
或：
openclaw config edit
说明：
不需要。
healtch 是首次唤醒和设定 agent 行为的过程
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online
基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML 转 Markdown 互为补充。 在线工具，Markdown 转 HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML 转 Markdown在线工具，online