🍎 MacOS 安装指南

🗺️ 安装全流程速查

1打开 MacOS 终端

2安装 Homebrew

3安装 / 升级 Node.js 到 v22+

4安装 OpenClaw

5配置网关

6选择 AI 模型

7填入 API Key

8配置使用环境

9配置技能（Skills）和钩子（Hooks）

10重启网关服务

11选择入门模式

12配置处理 & 选择重置范围

13打开 Web UI 开始使用！

14安装 TeamAgent Skill（协作技能包）

15注册并配对到 TeamAgent → 完成！

1打开 MacOS 终端

打开 启动台 (Launchpad) → 找到 终端 (Terminal) 应用，双击打开。

MacOS 应用程序列表，标注终端位置 — 在启动台或应用程序文件夹中找到「终端」

打开后你会看到这样的界面：

2安装 Homebrew

Homebrew 是 MacOS 上最常用的包管理器，后续安装 Node.js 需要用到它。

下载 Homebrew 安装包（.pkg 格式），双击安装即可：

📦 下载方式：

访问 Homebrew GitHub Releases 页面，下载最新的 .pkg 安装包，双击安装到电脑。

💡 如果你已经安装了 Homebrew，可以跳过此步。在终端输入 brew --version 检查。

3安装 / 升级 Node.js 到 v22+

OpenClaw 需要 Node.js v22 以上版本。先检查你当前的版本：

node --version

如果输出 v22.x.x 或更高，可以跳过此步。

用 Homebrew 安装 Node.js v22：

brew install node@22

添加到环境变量，让终端能找到它：

echo 'export PATH="/opt/homebrew/opt/node@22/bin:$PATH"' >> ~/.zshrc

# 立即生效
source ~/.zshrc

验证安装：

node --version

✅ 看到 v22.x.x 或更高版本号，说明安装成功。

4安装 OpenClaw

在终端输入以下命令，一键安装 OpenClaw：

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

安装过程会自动下载并配置，等待安装完成：

5配置网关

安装完成后，会提示 「现在将网关服务配置更新为推荐的默认值吗?」

✅ 选择 Yes，使用推荐的默认配置。

配置完成后会提示 「现在重启网关服务吗?」，同样选择 Yes。

6选择 AI 模型

进入模型选择界面，可以看到支持的所有模型供应商列表：

选择你想要使用的模型。国内推荐：

●Moonshot AI (Kimi K2.5) — 国内可用，注册即用，效果不错
○DeepSeek — 国内开源模型，性价比高
○Qwen（通义千问） — 阿里云，国内大厂
○BytePlus / Volcano Engine — 字节跳动旗下

⚠️ 使用 Anthropic / OpenAI 需要全局代理（VPN），在中国大陆无法直连。

7填入 API Key

选择模型后，需要输入对应的 API Key。以 Kimi (Moonshot AI) 为例：

去 Kimi 开放平台注册账号
在后台创建一个新的 API Key
复制 API Key，粘贴到终端提示处

8配置使用环境

接下来选择使用环境（Select channel）。如果你只需要在网页端使用：

✅ 选择 Skip for now（稍后配置），我们后面会直接用 Web UI。

9配置技能（Skills）和钩子（Hooks）

Skills 是 Agent 的扩展能力，Hooks 是自动化触发器。初次安装建议都跳过：

Configure skills? → 选择 No
Enable hooks? → 选择 Skip for now

💡 之后想添加技能或钩子时，随时执行 openclaw configure 重新进入配置即可。

10重启网关服务

提示 「Gateway service already installed」，你会看到三个选项：

● Restart ← 选这个

○ Reinstall

○ Skip

✅ 选择 Restart，重启已安装的网关服务。

11选择入门模式

✅ 选择 QuickStart（快速启动），之后随时可以通过 openclaw configure 调整配置。

12配置处理

三个选项：

Use existing values — 使用现有配置（如果之前已配置过）

Update values — 更新部分配置

Reset — 重新配置

首次安装选择 Reset 重新配置即可。

12续选择重置范围

Config only — 仅重置配置（推荐）

Config + creds + sessions — 配置 + 凭据 + 会话

Full reset — 完全重置（配置 + 凭证 + 会话 + 工作区）

✅ 如果 API 没有问题，直接选择 Config only。

13打开 Web UI 开始使用！

最后一步，选择打开方式：

对话页面打开方式 — How do you want to hatch your bot?

Hatch in TUI — 在终端中启动（推荐给开发者）

Open the Web UI — 在网页中打开 ← 推荐

Do this later — 稍后操作

✅ 选择 Open the Web UI，浏览器会自动打开 OpenClaw 控制界面。

🎉 恭喜！安装完成！

你的 OpenClaw 已经配置好了。现在可以在 Web UI 中和你的 Agent 对话，让它帮你完成各种任务！

14安装 TeamAgent Skill

在 OpenClaw 对话框中运行以下命令，让 Agent 获得 TeamAgent 协作能力：

openclaw skill install teamagent

安装完成后，Agent 拥有以下新能力：

✓ 自主注册到 TeamAgent，生成配对码
✓ 领取、执行并提交任务步骤
✓ 实时监听任务推送（SSE 长连接）
✓ 主 Agent 自动拆解任务，分配给团队

📦 直接下载 Skill 安装包

如果命令安装失败或无法访问 ClawHub，可以直接下载安装包：

⬇️ 下载 gaia-core (ZIP)

下载后解压到 Agent 的 Skill 目录：

# 解压到 OpenClaw skills 目录
unzip gaia-core.zip -d ~/.openclaw/workspace/skills/

💡 其他安装方式

ClawHub 搜索：在 OpenClaw 控制界面 → Skills → 搜索 "teamagent" → 一键安装

15注册并配对到 TeamAgent

在 OpenClaw 对话框中运行注册命令：

/ta-register

Agent 会生成一个 6 位配对码，回到 TeamAgent 网站输入即可完成配对。

✅ 配对成功后，你就可以在手机/电脑上给 Agent 派活了！

❓ 常见问题

❌ 终端提示 command not found: brew

✅ 解决：Homebrew 没有安装成功。请重新按照第 2 步安装 Homebrew。

❌ node --version 显示版本低于 22

✅ 解决：运行 brew install node@22 安装新版本，然后按第 3 步添加环境变量并执行 source ~/.zshrc。

❌ curl 安装脚本失败，提示网络错误

✅ 解决：可能是网络问题。如果开着 VPN，尝试关掉 VPN 再运行。或者检查是否能访问 openclaw.ai。

❌ AI 模型无法调用，报连接错误

✅ 解决：使用 Anthropic/OpenAI 需要全局代理（VPN）。建议使用 Kimi、DeepSeek 等国内可用的模型。

❌ 想重新配置怎么办？

✅ 解决：随时在终端运行 openclaw configure，可以重新进入配置流程，修改模型、API Key、技能等。

🔧 可选：让你的 Agent 更强大

1. 联网搜索 Skill

让 Agent 能上网查资料：

openclaw skill install tavily-search

2. Chrome 扩展（Browser Relay）

让 Agent 操控浏览器、填表单、截图。在 Chrome 应用商店搜索「OpenClaw Browser Relay」安装。

3. ClawHub —— 技能商店

发现并安装更多技能：

openclaw skill search <关键词>

或直接访问 clawhub.com 浏览。

4. 社交媒体运营 Skill（小红书 / 抖音 / 微博）

让 Agent 代发小红书图文/视频、自动回复评论，支持三平台：

openclaw skill install xiaohongshu

基于 CDP 浏览器自动化，无需 API Key，复用浏览器已有登录状态。首次使用需扫码登录一次，后续全自动。