如何在 Mac 上安装 OpenClaw AI 助手（完整教程）
手把手教你在 macOS（Apple Silicon / Intel）上安装配置 OpenClaw AI 代理，包括 Node.js 环境搭建、API 配置和 Telegram 接入全流程。
发布日期：2026-03-04 | 阅读时间：约 4 分钟
什么是 OpenClaw？
OpenClaw 是一款强大的开源 AI 代理（Agent），能够自主操控浏览器、读写本地文件、接入 WeChat、Telegram 等主流聊天平台，让你的 AI 助手真正"动起来"。
安装前准备
在开始之前，请确认你的 Mac 满足以下条件：
- 系统版本：macOS 12 Monterey 及以上
- 内存：至少 16GB RAM（建议 64GB，尤其是运行本地大模型）
- 磁盘空间：至少 512GB 可用空间
第一步：安装 Node.js
OpenClaw 基于 Node.js 运行，推荐使用 nvm 管理版本：
# 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
# 重启终端后安装 Node.js LTS
nvm install --lts
nvm use --lts
# 验证安装
node -v # 应显示 v20.x.x 或更高
第二步：克隆并安装 OpenClaw
git clone https://github.com/opencollar-ai/openclaw.git
cd openclaw
npm install
第三步：配置 API 密钥
复制示例配置文件：
cp .env.example .env
用文本编辑器打开 .env，填入你的 API 密钥：
ANTHROPIC_API_KEY=sk-ant-xxxxxxxx # 推荐，效果最好
# 或者
OPENAI_API_KEY=sk-xxxxxxxx
第四步：配置系统权限
OpenClaw 需要以下系统权限才能正常工作：
- 终端完全磁盘访问权限：系统偏好设置 → 隐私与安全性 → 完全磁盘访问权限 → 添加终端
- 辅助功能权限：系统偏好设置 → 隐私与安全性 → 辅助功能 → 添加终端
第五步：接入 Telegram（可选）
# 安装 Telegram 接入插件
npm install @openclaw/telegram-connector
# 在 .env 中添加 Bot Token
TELEGRAM_BOT_TOKEN=your_bot_token_here
从 @BotFather 创建机器人获取 Token。
第六步：启动 OpenClaw
npm start
首次启动会进行环境检测，完成后即可在 Telegram 中与你的 AI 助手对话。
遇到问题？
Mac 上安装 OpenClaw 最常见的坑：
- 权限问题：Apple Silicon Mac 需要额外配置 Rosetta 兼容层
- Node 版本冲突：建议始终使用 nvm 管理版本
- API 限速：国内访问 Anthropic / OpenAI 需要配置代理
如果遇到环境配置问题，欢迎预约我们的专业安装服务，工程师远程协助，30 分钟内搞定。
遇到问题？预约安装服务