OpenClaw 免费部署指南(Mac 版)

本指南帮助你在 Mac 上免费、完全本地化地部署 OpenClaw，使用 Ollama 运行开源模型，无需任何云服务费用。适合个人开发、团队协作或作为企业内部的 AI 助手。

📋 环境要求

Mac：Apple Silicon (M1/M2/M3) 或 Intel 芯片，8GB+ 内存（建议 16GB）系统：macOS 12 (Monterey) 或更高版本

磁盘：至少 10GB 可用空间（模型约 2-4GB）

网络：安装时需要稳定网络，后续可离线使用

提前安装好软件 node.js

🚀一键安装（推荐）

打开终端，依次执行以下命令。如果遇到问题，请参考后面的“常见问题”部分。

1. 安装 Homebrew（如已安装可跳过）

# 使用国内镜像安装 Homebrew（解决网络超时）/bin/bash -c "$(curl -fsSL https://mirrors.ustc.edu.cn/misc/brew/install.sh)"

安装完成后，按提示将 Homebrew 添加到 PATH（通常会自动提示，复制执行即可）。

2. 配置 npm 使用国内镜像（加速）

npm config set registry https://registry.npmmirror.com

3. 配置 npm 用户级全局目录（避免权限问题）

mkdir ~/.npm-globalnpm config set prefix '~/.npm-global'echo'export PATH=~/.npm-global/bin:$PATH'>> ~/.zshrcsource ~/.zshrc

4. 安装 OpenClaw

npminstall-g openclaw@latest

安装成功后，运行验证。

openclaw --version

5. 安装 Ollama（本地模型引擎）

访问 Ollama 官网下载 .dmg 安装包，拖入 Applications 并启动（菜单栏出现羊驼图标）。

或使用 Homebrew 安装（需已配置好 brew）：

brew install ollama

启动 Ollama 后，打开终端下载一个轻量级中文模型（约 1.9 GB）：

ollama pull qwen2.5:3b

6. 初始化 OpenClaw 配置

openclaw onboard

配置向导中按以下选择：

模型提供商：选择 Ollama
模型名称：输入 qwen2.5:3b（与上一步下载的模型名完全一致）
其他选项：使用默认或根据需求调整（如工作目录、端口等）

7. 启动网关服务

openclaw gateway start

此时网关应运行在 http://127.0.0.1:18789（端口可能不同，请留意终端输出）。

8. 访问 Web 界面

打开浏览器，访问 http://127.0.0.1:18789/。如果提示需要 token，请执行：

cat ~/.openclaw/openclaw.json |grep-A2'"auth"'

复制输出的 token 粘贴到浏览器输入框即可进入。

如果希望关闭 token 认证（本地安全），编辑配置文件：

open ~/.openclaw/openclaw.json

找到 "gateway" 下的 "auth" 字段并删除，保存后重启网关：

openclaw gateway restart

9. 验证

在终端发送一条测试消息：

openclaw agent --session-id test--message"你好，请介绍一下自己"

如果返回回答，说明部署成功！

你现在可以在 Web 界面或终端与 OpenClaw 对话。

终端运行成功：

网页端运行成功：

🧰 常见问题及解决方案

❌ 问题 1：Homebrew 安装失败，报 curl: (56) Recv failure: Operation timed out

原因：国内访问 GitHub 不稳定。

解决：使用国内镜像安装：

/bin/bash -c"$(curl-fsSL https://mirrors.ustc.edu.cn/misc/brew/install.sh)"

❌ 问题 2：npm install -g openclaw@latest 报 EACCES: permission denied

原因：没有权限写入 /usr/local/lib/node_modules。

解决：配置 npm 使用用户级目录（已在步骤 3 中完成）。如果已执行，请确认 ~/.npm-global/bin 已加入 PATH。

❌ 问题 3：npm 安装卡住，长时间无响应

原因：网络慢或官方源不稳定。

解决：确保已切换淘宝镜像（步骤 2），并清理缓存后重试：

npm cache clean --forcenpminstall-g openclaw@latest

❌ 问题 4：Ollama 下载模型失败，报 no such host 或进度卡住

原因：DNS 解析问题或网络中断。

解决：

更换 DNS（如 114.114.114.114、8.8.8.8）。

先下载轻量版模型：ollama pull qwen2.5:3b。

❌ 问题 5：Web 界面提示 API rate limit reached

原因：OpenClaw 默认使用了云端模型（qwen-portal），而非本地 Ollama。

解决：修改默认模型为本地模型：

openclaw configure# 选择 Models → Set default model → Ollama → 输入 qwen2.5:3b

或直接编辑配置文件 ~/.openclaw/openclaw.json，将 agents.defaults.model.primary 改为 ollama/qwen2.5:3b，并确保 models.providers 中有 Ollama 配置。

❌ 问题 6：浏览器访问 http://127.0.0.1:18789/ 提示 unauthorized: gateway token missing

原因：网关开启了 token 认证。

解决：

查看 token：cat ~/.openclaw/openclaw.json | grep -A 2 '"auth"'，复制 token 在浏览器中输入。

或关闭认证：编辑配置文件，删除 gateway.auth 字段，重启网关。

❌ 问题 7：终端运行 openclaw agent 报 Pass --to, --session-id, or --agent to choose a session

原因：缺少会话标识。

解决：添加 --session-id 参数，例如：

openclaw agent --session-id test--message"你好"

❌ 问题 8：模型下载完成后，OpenClaw 仍提示找不到模型

原因：模型名称不匹配。

解决：运行 ollama list 查看已下载模型的确切名称，然后在 OpenClaw 配置中使用相同名称。

📌后续使用与扩展

添加聊天渠道（如 Telegram、Discord）：openclaw channels add

安装技能插件：openclaw skills install <skill-name>

更新 OpenClaw：npm update -g openclaw

查看日志：openclaw logs --follow

停止网关：openclaw gateway stop

开机自启：安装时已自动配置 LaunchAgent，无需额外操作。

🧪 验证清单

openclaw --version 显示版本号

ollama list 显示 qwen2.5:3b

openclaw gateway status 显示 Runtime: running

浏览器能打开 http://127.0.0.1:18789/（可能需 token）

发送消息能获得回复（终端或 Web 界面）📞 获取帮助

官方文档：https://docs.openclaw.ai/

问题反馈：执行 openclaw doctor 自动诊断

恭喜！你已经成功部署了一个完全免费、本地运行的 OpenClaw 实例。现在，你可以把它作为你的个人 AI 助手，或者进一步集成到团队工作流中。

实际部署会遇到非常多问题，比如Mac系统太老、Node版本不兼容、模型太大电脑跑不动等等，建议遇到问题直接把终端返回信息，给到DeepSeek分析并给出解决方案，相信D老师！

如果觉得太麻烦，还是建议大家看看飞书，一键部署真的非常非常简单！纵享丝滑！

最快接入龙虾🦞OpenClaw的方式！关键限时免费！