OpenClaw 本地安装与 Web UI 使用指南

配置的整体含义

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

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

第 4 步 选择模型来源（✅ Qwen）

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

选项如何理解？

怎么选比较合适？

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

这里极力推荐 Qwen，完全免费（有配合限制），快速搭建使用足够用。 👉 Qwen 配额限制说明

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

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

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

第 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 加'自动化小助手'，以及加哪些。

如何选？

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

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

🟡 不确定 / 想保持最简

• ☑ Skip for now

🔴 不建议一开始就开

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

按空格键先中需要的选项

第 8 步 Gateway 服务重启（✅ Restart）

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

怎么选？

• 选 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 

怎么选？

🎉 恭喜，你的 OpenClaw 已成功启动！

Web UI: http://127.0.0.1:18789/

到这里，OpenClaw 已完成安装、配置和首次唤醒。默认会自动打开浏览器访问 Web UI 地址，如没有自动打开跳转，可以将上面网址复制到浏览器中打开。 Gateway 正常运行，模型已接入，核心能力就绪。

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

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

三、OpenClaw 常用命令

1️⃣ 基础命令（最常用）

2️⃣ 配置与初始化

3️⃣ Gateway（网关服务）

4️⃣ TUI / Web UI

5️⃣ 日志与调试

✅ 新手最常用的 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