MacBook 安装 OpenClaw 完整指南（内网版）

本文档适用于macOS 12+系统，提供OpenClaw一键安装、手动部署、故障修复全流程，适配内网环境使用。

📌 说明：OpenClaw是开源本地AI智能体，支持接入主流大模型与本地Ollama，数据本地存储，隐私可控。

一、环境准备

1. 系统要求

macOS 12 Monterey 及以上
内存 ≥8GB（推荐16GB+）
可用存储 ≥20GB
网络可访问外网（安装依赖）

2. 前置依赖检查

打开终端执行：

# 检查版本
node -v  # ≥v22.16.0
npm -v   # ≥v10.0.0
git --version

# 无则手动安装
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
brew install node@24 git

二、一键安装（推荐）

终端执行以下命令，自动完成依赖安装、程序部署、初始化引导：

# 标准安装（含引导）
curl -fsSL https://openclaw.ai/install.sh | bash

# 仅安装程序，跳过引导
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard

三、手动安装（进阶/内网）

# 1. 全局安装CLI
npm install -g openclaw@latest

# 2. 验证
openclaw --version

# 3. 初始化+后台服务
openclaw onboard --install-daemon

内网离线安装：外网下载tgz包 → 内网拷贝 → npm install -g ./openclaw-xxx.tgz

四、初始化配置

选择 Local Gateway（本地网关）
配置AI模型：输入API Key 或选择Ollama本地模型
绑定通信通道：微信/飞书/钉钉等
确认安装后台守护（开机自启）

配置文件：~/.openclaw/config.yaml

五、启动与验证

# 启动服务
openclaw gateway start

# 查看状态
openclaw status

# 访问Dashboard
浏览器打开：http://localhost:18789

# 命令行测试
openclaw chat "你好"

六、常见问题修复

1. 命令找不到

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

2. 权限报错

sudo chown -R $USER ~/.npm /usr/local/lib/node_modules
npm install -g openclaw@latest

3. Sharp编译失败

SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

七、安全与内网部署

⚠️ 安全提示

内网环境：关闭18789公网端口，仅内网访问
设置强密码，启用二次验证
定期更新：npm install -g openclaw@latest