本文是上一篇《OpenClaw 是什么》的实操篇。
如果你已经了解 OpenClaw 的定位，这一篇只做一件事：
带你一步步把 OpenClaw在本地跑起来，并通过 Web UI 正常使用。

为了尽量降低上手门槛，本文 不配置任何聊天平台（Slack / WhatsApp 等），
所有操作都在 本地终端 + 浏览器 Web UI 中完成。

在开始之前，请先确认你的环境。

💻 支持的操作系统

• macOS（Intel / Apple Silicon）
• Windows 10 / Windows 11（64 位）👉 Windows 安装

🎯 完成本文后你将得到什么？

完成本文所有步骤后，你将可以：

• 在本地成功运行 OpenClaw
• 在浏览器中打开 OpenClaw 的 Web UI
• 直接通过网页与 OpenClaw 对话和使用它

在 Terminal 中执行：

curl -fsSL https://openclaw.ai/install.sh | bash

执行后的结果如下：

安装完成后，会自动启动新手引导，如下图：

这些信息是安装与首次启动说明

当你第一次运行 openclaw，终端里会看到这一大段“很吓人”的 ASCII 画和安全提示。
别慌，它主要在做 三件事：

1. 告诉你：这是个很强但也很危险的工具
2. 提醒你：不要不懂就直接上线
3. 给你一套最低限度的安全建议
4. 强制风险确认（你必须明确表示：“我知道它很强，也知道有风险”）

这一步必须选择 “Yes”（使用键盘左右键切换选项）。

这一步我们选择 “QuickStart”，选择会出提示如下信息：

配置的整体含义

只在本机开放、需要认证、不自动暴露到网络。

也就是说：

• 适合第一次跑起来测试
• 默认是“关着门用”的安全模式
• 不会一启动就暴露在公网

这一步是在选择 OpenClaw 使用哪家模型服务，以及如何完成认证。

选项如何理解？

怎么选比较合适？

• 第一次用 / 想省事 → 选你已经有 Key 的厂商
• 需要多模型切换 → OpenRouter / Gateway 类
• 只想先装好 → Skip for now（之后再配）

这里我们用Qwen的模型，可根据实际情况自行选择

授权成功后，提示如下图：

选择要使用的模型，默认就好。

这一步是在告诉我们：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 加“自动化小助手”，以及加哪些。

如何选？

🟢 新手推荐（安全、实用）

• ☑ session-memory
• ☑ boot-md（可选）

🟡 不确定 / 想保持最简

• ☑ Skip for now

🔴 不建议一开始就开

• command-logger
  除非你在调试或排查问题（可能涉及隐私 / 日志量）
  
  
  
  

按空格键先中需要的选项

这一步其实是两个独立但连续的确认：
① Hooks 已配置完成，② Gateway 服务怎么处理。

怎么选？

• 选 Restart
• 只有：

• Gateway 起不来
• 行为异常
• 配置严重乱了
  才需要 Reinstall
  
  
  
  

这是“最后一步：你准备用什么方式正式启动（孵化）你的 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

怎么选？

Web UI: http://127.0.0.1:18789/

此时WebUI中的的问答内容都会在刚刚安装时用的终端中显示。

此时也可关闭命令行终端，并不会影响浏览器中WebUI的使用。

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️⃣ 确认端口未被占用或拦截

• macOS / Linux：确认没有防火墙或安全软件拦截本地端口
• Windows：确认 Defender / 安全软件未阻止本地服务监听

如有疑问，可重新启动 Gateway：

openclaw gateway restart

4️⃣ 浏览器问题排查（少数情况）

• 尝试无痕窗口
• 尝试换一个浏览器
• 清除该地址的缓存 / Cookie

在本文的安装与启动流程下：通常不会发生任何影响。

原因是：

• OpenClaw 的 Gateway 服务以后台守护进程方式运行
• 关闭用于安装 / 配置的终端：

• ❌ 不会终止 Gateway
• ❌ 不会影响 Web UI
• ❌ 不需要重新 hatch

你可以随时重新打开一个新的终端，通过：

openclaw gateway status

来确认当前运行状态。

通常只发生在以下情况之一：

• 你手动执行了：

openclaw gateway stop

• 系统重启，且 Gateway 未设置为自动启动
• 端口被其他程序占用或被安全软件拦截
• 配置文件被手动改坏（少见）

解决方式通常是：

openclaw gateway start

或：

openclaw gateway restart

可以，而且是设计上就允许反复修改的。

常用方式包括：

openclaw configure

或：

openclaw config edit

说明：

• 修改配置 不会破坏已安装的 OpenClaw
• 大部分配置修改后，重启 Gateway 即可生效
• 不需要重新 setup / hatch

不需要。

• healtch 是首次唤醒和设定 agent 行为的过程
• 完成一次后：

• Gateway 会独立运行
• Web UI 可直接使用

• 只有在：

• 你想重新定义 agent 角色
• 或进行重大行为/安全策略调整
  时，才需要再次 healtch
  
  
  
  

如果你已经跟着本文 成功在本地跑起了 OpenClaw，并打开了 Web UI，
欢迎在评论区 回一个「已跑起来」或截图描述一下你的效果👇
我会优先回复这些评论。

如果你在安装或配置过程中 遇到任何卡点（哪怕只是一个报错、一句看不懂的提示），
直接把终端输出或你卡住的那一步写在评论里，我会尽量帮你一起排查。

🤔 也欢迎你在评论区告诉我：

• 你是 macOS 还是 Windows？
• 这次是 第一次接触 OpenClaw，还是从 Clawdbot 时代过来的？
• 你更想看下一篇写什么？

• 🔧 Skills / 工具能力怎么配
• 🧠 Agent 行为和安全边界怎么设
• 🌐 Web UI / API 深度用法
• 🚀 真正“能干活”的实战场景

你的评论会 直接决定下一篇文章的选题方向。

⭐ 如果这篇文章帮你省下了折腾时间

• 点个 👍 赞，让我知道这类实操文值得继续写
• 点个 ⭐ 收藏，后面配置 / 排坑 / 进阶可以随时翻出来用

后续我会继续把 OpenClaw 从「跑起来」写到「真正能干活」。