OpenClaw安装实操教程macOS

零基础必看！Mac 安装 OpenClaw 全攻略（2026 最新版）

5分钟搭建本地 AI 智能体框架，支持 Kimi / OpenAI / Claude 多模型接入

来源：秒哒 OpenClaw · 2026年4月最新版

🤖 如果你曾经想过：

• "能不能在本地搭一个真正能帮我做事的 AI 助手？"

• "GitHub 上最火的 AI Agent 框架是什么？怎么安装？"

• "国内网络能不能正常用？"

这篇文章，就是为零基础的你写的。跟着步骤操作，5 分钟内你就能跑通 OpenClaw。

一、什么是 OpenClaw？为什么全网都在装？

OpenClaw（社区昵称"小龙虾"）是一款开源的 AI 智能体执行框架，由奥地利开发者 Peter Steinberger 创建，于 2025 年 11 月正式发布。

它的定位是："the AI that actually does things"——真正能执行任务的 AI。

💡 国内用户推荐搭配 Kimi 大模型使用——长文本处理能力强，工具调用优秀，中文理解出色，无需科学上网。

核心数据一览

指标	数据
GitHub 星标	33 万+（AI Agent 类第一）
支持平台	macOS / Windows / Linux / WSL2
接入模型	Kimi / OpenAI / Claude / DeepSeek / Gemini
支持消息渠道	50+（微信/Telegram/WhatsApp/飞书等）
开源协议	MIT（全开源，可商用）
最新版本	2026.3.24（持续迭代中）

二、安装前准备：你的 Mac 能跑 OpenClaw 吗？

在开始安装之前，先确认你的 Mac 满足基本要求。

硬件和系统要求

配置项	最低要求	推荐配置
操作系统	macOS 11.0（Big Sur）	macOS 13+（最新）
芯片类型	Intel 或 Apple Silicon	Apple Silicon（M1/M2/M3/M4）
内存	4GB RAM	8GB+ RAM
磁盘空间	1GB 可用	5GB+ 可用
网络	可访问互联网	国内可直接用 Kimi

💡 如何查看自己的 Mac 配置？点击屏幕左上角苹果图标 → 选择"关于本机"→ 查看处理器和内存。

你是 Intel 还是 Apple Silicon？

2019 年之前的 Mac 大多是 Intel 处理器；2020 年之后推出的 Mac 基本都是 Apple Silicon（M1/M2/M3/M4）。Apple Silicon 用户安装过程略有不同，注意看第三步的提示。

💡 打开"终端"（Terminal），输入命令：uname -m → 输出 arm64 = Apple Silicon，输出 x86_64 = Intel

⚠️ 安装前建议关闭 VPN，避免安装脚本从海外节点下载导致速度慢或失败。

三、步骤一：安装 Homebrew（Mac 包管理器）

Homebrew 是 macOS 上最流行的包管理器，类似于手机上的"应用商店"，可以一键安装各种开发工具。安装 OpenClaw 离不开它。

步骤 1.1：打开 Mac 终端（Terminal）

按 Command + 空格键，搜索"终端"或"Terminal"，点击打开。

📸 图1：Mac 终端打开方式 → 按 Command + 空格，搜索"终端"，回车打开

步骤 1.2：粘贴 Homebrew 安装命令

复制以下命令，粘贴到终端，按回车键执行：

# Homebrew 官方安装命令（2026年最新版）/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

⚠️ 提示输入密码：安装过程中会提示"Password:"，输入你的 Mac 登录密码（输入时屏幕不显示字符，这是正常的 macOS 安全机制）。输入后按回车即可。

💡 等待时间约 2-5 分钟——Homebrew 会下载 Xcode Command Line Tools（约 500MB），具体时间取决于网络。

步骤 1.3：配置 Homebrew 环境变量（仅 Apple Silicon 用户）

如果你的 Mac 是 M1/M2/M3/M4 芯片，安装完 Homebrew 后，还需要配置环境变量：

# Apple Silicon 用户（M1/M2/M3/M4）执行以下两行命令：echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofileeval "$(/opt/homebrew/bin/brew shellenv)"

Intel Mac 用户跳过此步骤，直接看步骤 4。

步骤 1.4：验证 Homebrew 安装成功

~ $ brew --versionHomebrew 5.1.5Homebrew/homebrew-core (git revision abc123)~ $ brew doctorYour system is ready to brew.

💡 看到"Your system is ready to brew."——说明 Homebrew 完全就绪，可以继续下一步。

四、步骤二：安装 Node.js

Node.js 是 OpenClaw 运行的基础环境。Homebrew 装好后，一条命令搞定：

# 一键安装 Node.js LTS 长期支持版（推荐）brew install node

OpenClaw 要求 Node.js ≥ 22.0.0。如果版本低于 22，运行 brew upgrade node 升级。

💡 brew install node 会安装 Node.js 的最新稳定版（LTS）。如果你需要同时管理多个 Node.js 版本，推荐使用 NVM。详见文末 FAQ。

~ $ node --versionv25.8.0~ $ npm --version11.11.0

五、步骤三：一键安装 OpenClaw

环境准备完毕，现在正式安装 OpenClaw。推荐使用官方一键安装脚本，一行命令，自动完成所有配置。

步骤 3.1：运行官方安装脚本

# 官方一键安装脚本（macOS / Linux / WSL2）curl -fsSL https://openclaw.ai/install.sh | bash

⚠️ 国内网络注意！如果上面命令下载超时或报错（官方服务器在海外），使用国内镜像版：curl -fsSL https://get.openclaw.cc/install.sh | bash

步骤 3.2：等待自动安装完成

[INFO] Detecting system...[INFO] System: macOS arm64 (Apple Silicon)[INFO] Node.js v22.14.0 detected ✓[SUCCESS] OpenClaw v2026.3.24 installed![SUCCESS] Type 'openclaw --version' to get started

💡 也可以用 npm 直接安装（适合已有 Node.js 环境的用户）：npm install -g openclaw@latest

六、步骤四：验证安装是否成功

~ $ openclaw --versionopenclaw v2026.3.24~ $ openclaw doctor[✓] Node.js v22.14.0[✓] npm v10.9.0[✓] openclaw binary found[✓] System ready!

💡 看到绿色的 [✓] System ready!——说明 OpenClaw 安装完全正确，可以进入配置环节了。

七、步骤五：接入 Kimi 大模型（国内用户推荐）

OpenClaw 安装好了，但还需要配置 AI 模型才能真正使用。这一步我们接入 Kimi 大模型（国内用户首选，无需科学上网）：

① 获取 Kimi API Key

1. 打开浏览器，访问 platform.moonshot.cn，使用手机号注册账号并登录。

2. 登录后在左侧菜单找到「API Keys」→「创建 API Key」，给 Key 起个名字（如"Mac本地"），点击创建。

⚠️ API Key 只显示一次！创建后请立即复制保存，关闭页面后无法再次查看。建议粘贴到备忘录保存。

② 创建工作目录并初始化

# 创建工作目录mkdir ~/openclaw-workspacecd ~/openclaw-workspace# 初始化 OpenClaw 配置openclaw init

③ 编辑 .env 配置文件，填入 Kimi API Key

# 用 VSCode 打开 .env 文件code ~/openclaw-workspace/.env

在 .env 文件中添加以下内容（替换成你自己的 API Key）：

# Kimi API（推荐国内用户）KIMI_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxx# Kimi 接口地址（国内直连，无需代理）KIMI_BASE_URL=https://api.moonshot.cn/v1# Kimi 模型KIMI_MODEL=moonshot-v1-8k

💡 国内还有哪些模型可选？DeepSeek：DEEPSEEK_API_KEY；硅基流动（便宜）：SILICONFLOW_API_KEY；OpenAI（需科学上网）：OPENAI_API_KEY

八、步骤六：启动 Gateway，体验你的本地 AI 智能体

# 进入工作目录cd ~/openclaw-workspace# 启动 Gatewayopenclaw gateway start

🦞 OpenClaw Gateway[✓] Gateway started on http://localhost:3000[✓] WebSocket ready[✓] Connected to Kimi model[✓] Memory initialized[INFO] Open your browser: http://localhost:3000

现在打开浏览器，访问 http://localhost:3000，你就能看到 OpenClaw 的 Web 界面了！

📸 图3：OpenClaw Gateway Web 界面 → 浏览器截图：左侧对话区 / 右侧工具面板

💡 恭喜！你已经成功安装了 OpenClaw！按 Ctrl + C 可以停止 Gateway。下次想启动，只需再运行 openclaw gateway start 即可。🎉

九、常见问题 FAQ

以下整理了安装过程中最常见的 9 个问题，建议先收藏，遇到问题直接查阅：

Q1: 安装脚本报错"Failed to connect"或超时怎么办？

国内网络访问海外服务器不稳定是常见问题。按以下顺序尝试：

① 使用国内镜像：curl -fsSL https://get.openclaw.cc/install.sh | bash

② 手动 npm 安装：npm install -g openclaw@latest

③ 切换到 Kimi 等国内节点，或短暂开启 VPN 下载后再关闭。

Q2: 提示"Command not found: openclaw"怎么解决？

说明 npm 全局 bin 目录没有加入 PATH。运行以下命令：

echo 'export PATH="$(npm prefix -g)/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc

然后重新打开终端，再试 openclaw --version。

Q3: 端口 3000 被占用，启动失败怎么办？

另一个程序占用了 3000 端口。解决方法：

① 查找占用进程：lsof -ti:3000

② 终止进程：kill -9 [进程ID]

③ 或换端口启动：openclaw gateway start --port 3001

Q4: Homebrew 安装失败，提示"Permission denied"？

这是 macOS 权限问题。解决方法：

① 确认使用的是管理员账户（非访客账户）

② 检查权限：sudo chown -R $(whoami) /usr/local

③ Apple Silicon 用户：sudo chown -R $(whoami) /opt/homebrew

Q5: Kimi API Key 报错"Invalid API Key"？

① 确认 .env 文件中 KIMI_API_KEY= 后面的内容没有多余空格

② 确认 Key 是从 platform.moonshot.cn 获取的（不是 Kimi App 的账号）

③ 确认 Key 没有过期或被禁用

Q6: openclaw doctor 提示 Node 版本太低？

OpenClaw 需要 Node.js ≥ 22.0.0。升级方法：brew upgrade node

或使用 NVM 管理多版本：brew install nvm && nvm install 22 && nvm use 22

Q7: 想同时用多个 Node.js 版本，推荐用什么？

推荐使用 NVM（Node Version Manager）：

brew install nvm

然后：nvm install 22 && nvm use 22

Q8: 安装后如何更新到最新版本？

npm install -g openclaw@latest

或运行：openclaw update

Q9: 如何卸载 OpenClaw？

npm uninstall -g openclaw

如果同时想删除工作目录：rm -rf ~/openclaw-workspace

十、安装完成后，下一步做什么？

恭喜你，OpenClaw 已经跑起来了！但这只是开始——OpenClaw 的真正魅力在于它的 Skills（技能扩展）：

方向	内容
自动化办公	安装「邮件助手」Skill，让 AI 自动帮你收发 Gmail/QQ 邮件
浏览器操控	安装「网页搜索」Skill，让 AI 替你查资料并整理摘要
数据分析	上传 Excel，AI 自动生成分析报告和数据可视化
接入微信/飞书	把 OpenClaw 接入微信/飞书，实现"个人 AI 助手"在线
开发自己的 Skill	用 JSON 配置开发专属技能，门槛极低
云端部署	部署到云服务器，24小时在线，无需 Mac 常开

💡 ClawHub 技能市场（openclaw.cc/clawhub）——目前已有 1700+ 社区开发的 Skills，涵盖办公、编程、社媒、数据等各个领域。安装一个 Skill 只需一条命令：openclaw skills install [技能名]

总结：核心 5 条命令

全程只需要记住这 5 条命令：

1./bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"  # 安装 Homebrew2. brew install node                                                        # 安装 Node.js3. curl -fsSL https://openclaw.ai/install.sh | bash                      # 安装 OpenClaw4. openclaw init                                                       # 初始化配置5. openclaw gateway start                                            # 启动体验