OpenClaw 实战 #02-1：新手一把过（原Clawdbot ）保姆级安装教程-Mac版
本文是上一篇《OpenClaw 是什么》的实操篇。
如果你已经了解 OpenClaw 的定位，这一篇只做一件事：
带你一步步把 OpenClaw在本地跑起来，并通过 Web UI 正常使用。
为了尽量降低上手门槛，本文 不配置任何聊天平台（Slack / WhatsApp 等），
所有操作都在 本地终端 + 浏览器 Web UI 中完成。
🧰 一、安装前准备
在开始之前，请先确认你的环境。
💻 支持的操作系统
- macOS（Intel / Apple Silicon）
- Windows 10 / Windows 11（64 位）👉 Windows 安装
请根据你的系统，阅读对应的安装部分即可，
后续配置与使用步骤完全一致。
🎯 完成本文后你将得到什么？
完成本文所有步骤后，你将可以：
- 在本地成功运行 OpenClaw
- 在浏览器中打开 OpenClaw 的 Web UI
- 直接通过网页与 OpenClaw 对话和使用它
💻 二、安装 OpenClaw（原Clawdbot）
第1步 在线安装 OpenClaw
在 Terminal 中执行：
curl -fsSL https://openclaw.ai/install.sh |bash执行后的结果如下：
第2步 确认提示 （✅ Yes）
安装完成后，会自动启动新手引导，如下图：
这些信息是安装与首次启动说明
当你第一次运行openclaw，终端里会看到这一大段“很吓人”的 ASCII 画和安全提示。
别慌，它主要在做 三件事：告诉你：这是个很强但也很危险的工具提醒你：不要不懂就直接上线给你一套最低限度的安全建议强制风险确认（你必须明确表示：“我知道它很强，也知道有风险”）
这一步必须选择 “Yes”（使用键盘左右键切换选项）。
第3步 引导模式选择（✅ QuickStart）
| 选项 | 含义 | 适合谁 |
|---|---|---|
| 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 | 直接接入聊天渠道 | 消息直达，不走复杂中转 |
配置的整体含义
只在本机开放、需要认证、不自动暴露到网络。
也就是说：适合第一次跑起来测试默认是“关着门用”的安全模式不会一启动就暴露在公网
第4步 选择模型来源（✅ Qwen）
这一步是在选择 OpenClaw 使用哪家模型服务，以及如何完成认证。
选项如何理解？
| 选项类型 | 含义 |
|---|---|
| OpenAI / Anthropic / Google 等 | 直接使用官方模型服务 |
| MiniMax / Qwen / Moonshot / GLM | 国内模型厂商 |
| OpenRouter / Vercel AI Gateway | 多模型聚合 / 代理网关 |
| Copilot | 使用已有 Copilot 授权 |
| Synthetic | 本地或测试用的模拟模型 |
| Skip for now | 暂不配置模型 |
怎么选比较合适？
- 第一次用 / 想省事 → 选你已经有 Key 的厂商
- 需要多模型切换 → OpenRouter / Gateway 类
- 只想先装好 → Skip for now（之后再配）
这里极力推荐Qwen，完全免费（有配合限制），快速搭建使用足够用。
👉 Qwen 配额限制说明
这里我们用Qwen的模型，可根据实际情况自行选择
| 选项 | 含义 |
|---|---|
| Qwen OAuth | 通过阿里云官方 OAuth 授权登录 |
| Back | 返回上一步 |
授权成功后，提示如下图：
选择要使用的模型，默认就好。
第5步 选择对话渠道（✅ Skip for now）
这一步是在告诉我们：OpenClaw 现在“接到哪里说话”，以及这些聊天渠道是怎么工作的。不是必须立刻配。
此次我们使用WebUI对话，因此我们跳过这一步，后面再配置即可。
第6步 配置工具集（✅ No）
这一步是在讲 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安装好，技能配置会在后续文章中详细讲解。
第7步 添加自动化小助手(✅ session-memory ✅ boot-md)
这一步是在问你要不要给 OpenClaw 加“自动化小助手”，以及加哪些。
| Hook | 用途 | 是否推荐 |
|---|---|---|
| 🚀 boot-md | 启动时加载一段初始化说明（如使用说明、约定） | ✅ 新手可选 |
| 📝 command-logger | 记录你执行过的命令 | ⚠️ 调试用 |
| 💾 session-memory | 在特定命令时保存会话上下文 | ✅ 很实用 |
如何选？
🟢 新手推荐（安全、实用）
- ☑ session-memory
- ☑ boot-md（可选）
🟡 不确定 / 想保持最简
- ☑ Skip for now
🔴 不建议一开始就开
- command-logger
除非你在调试或排查问题（可能涉及隐私 / 日志量）
按空格键先中需要的选项
第8步 Gateway 服务重启（✅ Restart）
这一步其实是两个独立但连续的确认：
① Hooks 已配置完成，② Gateway 服务怎么处理。
| 选项 | 含义 | 什么时候选 |
|---|---|---|
| Restart（推荐） | 重启现有 Gateway | 升级后 / 正常情况 |
| Reinstall | 删除后重新安装 Gateway | Gateway 异常或损坏 |
| Skip | 什么都不做 | 暂时不打算启动 |
怎么选？
- 选 Restart
- 只有：
- Gateway 起不来
- 行为异常
- 配置严重乱了
才需要 Reinstall
第9步 选择启动方式（✅ Hatch in TUI ）
这是“最后一步：你准备用什么方式正式启动（孵化）你的 OpenClaw 代理”。
1️⃣ Missing Control UI assets（不用慌）
Missing Control UI assets. Build them with pnpm ui:build意思是：
- Web 控制界面的前端资源还没编译
- 不影响使用
- 只有你想用 Web UI 时才需要
👉 新手 可以完全忽略
2️⃣ Optional apps（可选客户端）
macOS / iOS / Android app 这是在告诉你：
- OpenClaw 还有原生 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 说明：
- Gateway 已启动
- 本机可以访问 Web UI
- 带 token 的链接 = 已登录直达链接
👉 本地安全可用，未暴露外网
4️⃣ Start TUI（官方强烈推荐）
Start TUI (best option!) This is the defining action that makes your agent you. 意思是：
- TUI = 终端交互界面
- 这是第一次“唤醒”你的 agent
- 会让你：
- 设定角色
- 约束行为
- 告诉它你想让它“成为什么样的助手”
👉 这是个性和安全边界的核心步骤
5️⃣ Token 说明（你现在只要知道一件事）
Gateway token = Gateway + Web UI 的通行证 - Web UI / API 都靠它鉴权
- 本地文件和浏览器会各存一份
- 一般 不用你手动操作
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 | 先装好，暂时不用 |
🎉 恭喜，你的 OpenClaw 已成功启动！
Web UI: http://127.0.0.1:18789/
到这里，OpenClaw 已完成安装、配置和首次唤醒。默认会自动打开浏览器访问Web UI地址，如没有自动打开跳转，可以将上面网址复制到浏览器中打开。
Gateway 正常运行，模型已接入，核心能力就绪。
此时WebUI中的的问答内容都会在刚刚安装时用的终端中显示。
此时也可关闭命令行终端，并不会影响浏览器中WebUI的使用。
三、OpenClaw 常用命令
1️⃣ 基础命令（最常用）
| 命令 | 作用说明 |
|---|---|
openclaw | 查看 OpenClaw 是否安装成功 |
openclaw version | 查看当前版本 |
which openclaw | 查看可执行文件路径 |
openclaw help | 查看命令帮助 |
2️⃣ 配置与初始化
| 命令 | 作用说明 |
|---|---|
openclaw setup | 启动首次配置（onboarding） |
openclaw configure | 交互式修改配置 |
openclaw config get <key> | 查看指定配置项 |
openclaw config set <key> <value> | 设置配置项 |
openclaw config edit | 直接编辑配置文件 |
3️⃣ Gateway（网关服务）
| 命令 | 作用说明 |
|---|---|
openclaw gateway start | 启动 Gateway |
openclaw gateway stop | 停止 Gateway |
openclaw gateway restart | 重启 Gateway |
openclaw gateway status | 查看 Gateway 状态 |
4️⃣ TUI / Web UI
| 命令 | 作用说明 |
|---|---|
openclaw tui | 启动终端交互界面（推荐） |
openclaw dashboard | 打开 Web UI |
openclaw dashboard --no-open | 输出 Web UI 链接但不自动打开 |
5️⃣ 日志与调试
| 命令 | 作用说明 |
|---|---|
openclaw logs | 查看运行日志 |
openclaw logs --follow | 实时跟踪日志 |
openclaw doctor --verbose | 输出详细诊断信息 |
✅ 新手最常用的 5 条命令（记住这几个就够）
openclaw setup openclaw doctor openclaw tui openclaw gateway status openclaw dashboard 四、卸载 / 清理（macOS 示例）
rm /opt/homebrew/bin/openclaw rm -rf ~/.openclaw 太好了，那我就直接帮你把「五、常见问题（新手必看）」这一整节按你当前真实运行模型重写。
下面内容可以 整体替换你原来的「五、常见问题（新手必看）」，不需要读者再自行判断前后台差异。
五、常见问题
Q1：Web UI 打不开？
请按下面顺序逐项检查（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️⃣ 确认端口未被占用或拦截
- macOS / Linux：确认没有防火墙或安全软件拦截本地端口
- Windows：确认 Defender / 安全软件未阻止本地服务监听
如有疑问，可重新启动 Gateway：
openclaw gateway restart 4️⃣ 浏览器问题排查（少数情况）
- 尝试无痕窗口
- 尝试换一个浏览器
- 清除该地址的缓存 / Cookie
Q2：关闭最初安装时使用的终端，会发生什么？
在本文的安装与启动流程下：通常不会发生任何影响。
原因是：
- OpenClaw 的 Gateway 服务以后台守护进程方式运行
- 关闭用于安装 / 配置的终端：
- ❌ 不会终止 Gateway
- ❌ 不会影响 Web UI
- ❌ 不需要重新 hatch
你可以随时重新打开一个新的终端，通过：
openclaw gateway status 来确认当前运行状态。
Q3：什么时候 Web UI 会真的“突然打不开”？
通常只发生在以下情况之一：
- 你手动执行了：
openclaw gateway stop - 系统重启，且 Gateway 未设置为自动启动
- 端口被其他程序占用或被安全软件拦截
- 配置文件被手动改坏（少见）
解决方式通常是：
openclaw gateway start 或：
openclaw gateway restart Q4：之后还能修改配置吗？会不会影响现在的使用？
可以，而且是设计上就允许反复修改的。
常用方式包括：
openclaw configure 或：
openclaw config edit 说明：
- 修改配置 不会破坏已安装的 OpenClaw
- 大部分配置修改后，重启 Gateway 即可生效
- 不需要重新 setup / hatch
Q5：我需要每次都重新 healtch 吗？
不需要。
healtch是首次唤醒和设定 agent 行为的过程- 完成一次后：
- Gateway 会独立运行
- Web UI 可直接使用
- 只有在：
- 你想重新定义 agent 角色
- 或进行重大行为/安全策略调整
时，才需要再次 healtch
🙌 写在最后：一起把 OpenClaw 玩明白
如果你已经跟着本文 成功在本地跑起了 OpenClaw，并打开了 Web UI，
欢迎在评论区 回一个「已跑起来」或截图描述一下你的效果👇
我会优先回复这些评论。
如果你在安装或配置过程中 遇到任何卡点（哪怕只是一个报错、一句看不懂的提示），
直接把终端输出或你卡住的那一步写在评论里，我会尽量帮你一起排查。
🤔 也欢迎你在评论区告诉我：
- 你是 macOS 还是 Windows？
- 这次是 第一次接触 OpenClaw，还是从 Clawdbot 时代过来的？
- 你更想看下一篇写什么？
- 🔧 Skills / 工具能力怎么配
- 🧠 Agent 行为和安全边界怎么设
- 🌐 Web UI / API 深度用法
- 🚀 真正“能干活”的实战场景
你的评论会 直接决定下一篇文章的选题方向。
⭐ 如果这篇文章帮你省下了折腾时间
- 点个 👍 赞，让我知道这类实操文值得继续写
- 点个 ⭐ 收藏，后面配置 / 排坑 / 进阶可以随时翻出来用
后续我会继续把 OpenClaw 从「跑起来」写到「真正能干活」。
