跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客GitHub 精选镜像工具UI配色美学隐私政策关于联系
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
Shell / BashAI

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

综述由AI生成OpenClaw 是一款本地运行的智能体工具。在 macOS 系统下通过终端脚本安装 OpenClaw 的全过程，包括环境准备、在线安装命令执行、新手引导配置（如模型选择 Qwen、跳过聊天渠道集成）、Gateway 服务启动及 Web UI 访问。同时提供了常用命令行操作参考及常见问题排查方法，帮助用户快速完成本地部署并启用 Web 界面进行交互。

LinuxPan发布于 2026/2/7更新于 2026/5/2323 浏览
OpenClaw 本地安装与 Web UI 使用指南（macOS）

本文是 OpenClaw 的实操篇，旨在带你一步步把 OpenClaw 在本地跑起来，并通过 Web UI 正常使用。

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

🧰 一、安装前准备

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

💻 支持的操作系统
  • macOS（Intel / Apple Silicon）
  • Windows 10 / Windows 11（64 位）

请根据你的系统，阅读对应的安装部分即可，后续配置与使用步骤完全一致。

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

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

  • 在本地成功运行 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: 18789OpenClaw 网关监听的端口本机通过该端口访问
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 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删除后重新安装 GatewayGateway 异常或损坏
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

目录

  1. 🧰 一、安装前准备
  2. 💻 支持的操作系统
  3. 🎯 完成本文后你将得到什么？
  4. 💻 二、安装 OpenClaw（原 Clawdbot）
  5. 第 1 步 在线安装 OpenClaw
  6. 第 2 步 确认提示（✅ Yes）
  7. 第 3 步 引导模式选择（✅ QuickStart）
  8. 第 4 步 选择模型来源（✅ Qwen）
  9. 第 5 步 选择对话渠道（✅ Skip for now）
  10. 第 6 步 配置工具集（✅ No）
  11. 第 7 步 添加自动化小助手 (✅ session-memory ✅ boot-md)
  12. 第 8 步 Gateway 服务重启（✅ Restart）
  13. 第 9 步 选择启动方式（✅ Hatch in TUI ）
  14. 🎉 恭喜，你的 OpenClaw 已成功启动！
  15. 三、OpenClaw 常用命令
  16. 1️⃣ 基础命令（最常用）
  17. 2️⃣ 配置与初始化
  18. 3️⃣ Gateway（网关服务）
  19. 4️⃣ TUI / Web UI
  20. 5️⃣ 日志与调试
  21. ✅ 新手最常用的 5 条命令（记住这几个就够）
  22. 四、卸载 / 清理（macOS 示例）
  23. 五、常见问题
  24. Q1：Web UI 打不开？
  25. Q2：关闭最初安装时使用的终端，会发生什么？
  26. Q3：什么时候 Web UI 会真的“突然打不开”？
  27. Q4：之后还能修改配置吗？会不会影响现在的使用？
  28. Q5：我需要每次都重新 healtch 吗？
  • 💰 8折买阿里云服务器限时8折了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 🤖 一键搭建Deepseek满血版了解详情
  • 一键打造专属AI 智能体了解详情
极客日志微信公众号二维码

微信扫一扫，关注极客日志

微信公众号「极客日志V2」，在微信中扫描左侧二维码关注。展示文案：极客日志V2 zeeklog

更多推荐文章

查看全部
  • OpenClaw 是一个开源的、面向具身智能（Embodied AI）与机器人操作研究的多模态大模型框架
  • Ubuntu 服务器安装 KingbaseES V009R002C012 数据库指南
  • 微信 AI 群聊机器人本地搭建教程
  • OpenClaw 部署指南：Coding Plan 配置、CC Switch 与飞书机器人接入
  • FPGA 任意角度图像旋转原理与实现
  • Tesla K80 显卡 llama.cpp CUDA 优化实战
  • openEuler 系统安装 Docker 容器完整教程
  • MacBook 上如何正确安装 nvm 和 Node.js
  • Scan2CAD 教程：AI 驱动扫描图像转 CAD 模型
  • Spring 基于注解配置的 AOP 使用与声明式事务控制
  • LTX-2.3：开源音视频生成新标杆，单模型同步输出视频与音频
  • Visual Studio 使用 GitHub Copilot 与 IntelliCode 辅助编码
  • 前端流式输出技术详解：原理与实战
  • PRIDE-PPPAR 多 GNSS 精密单点定位软件安装配置指南
  • Spring MVC 全面详解：Java Web 开发框架
  • Stable Diffusion 微调教程：基于 Dreambooth 与 LoRA
  • AutoGPT 结合 Python 实现 AI 智能体自动化任务
  • 手持激光雷达 TG30 Cartographer 建图实操记录
  • 前端部署后浏览器访问报 MIME 类型错误排查
  • Python 爬虫实战：反爬绕过与数据解析常见问题总结

相关免费在线工具

  • RSA密钥对生成器

    生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online

  • Mermaid 预览与可视化编辑

    基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online

  • 随机西班牙地址生成器

    随机生成西班牙地址（支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选），支持数量快捷选择、显示全部与下载。 在线工具，随机西班牙地址生成器在线工具，online

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online

  • Base64 文件转换器

    将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online

  • Markdown转HTML

    将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML转Markdown 互为补充。 在线工具，Markdown转HTML在线工具，online