归档39

漏洞分析7 OpenClaw5 技术感悟4 AI 工具3 安全研究3 技术分析3 Security2 Tech2 币安广场2 教程2 AI 部署1 公告1 应急响应1 服务1 漏洞复现与分析1 项目介绍1

1188 字

6 分钟

OpenClaw 部署教程 - macOS 篇（2026 最新版）

2026-03-10

OpenClaw

部署

教程

联系方式 & 交流群

微信: gzs-47

进微信群请联系博主，各位觉得文章对你有帮助的话可否打赏一些呀~

OpenClaw 部署教程 - macOS 篇（2026 最新版）#

📅 更新时间：2026-03-10
⏱️ 阅读时间：8 分钟
💡 难度等级：⭐⭐☆☆☆

OpenClaw 是一款强大的 AI 助手框架，支持 macOS 平台部署。本文整合官方文档和社区最佳实践，详细介绍 macOS 平台的安装配置流程。

geo_target: “cn”—

📚 推荐学习路径#

官方文档（最权威）：

社区实战：

📋 系统要求#

项目	最低要求	推荐配置
操作系统	macOS 11+	macOS 14+ (Sonoma)
内存	4GB	8GB+ (M 系列芯片优化更好)
磁盘	10GB	20GB+ SSD
Node.js	v18+	v20+
Python	3.8+	3.10+

🚀 快速安装（5 分钟）#

方法一：Homebrew 安装（推荐）#

1
# 1. 安装 Homebrew（如果未安装）
2
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
3

4
# 2. 安装 Node.js
5
brew install node@20
6

7
# 3. 安装 OpenClaw
8
npm install -g openclaw
9

10
# 4. 验证安装
11
openclaw --version

方法二：一键脚本安装#

1
# 使用官方一键安装脚本
2
curl -fsSL https://docs.openclaw.ai/zh-CN/install | bash
3

4
# 验证安装
5
openclaw --version

🔧 详细配置步骤#

1. 初始化工作区#

1
# 创建工作区
2
mkdir -p ~/openclaw-workspace
3
cd ~/openclaw-workspace
4

5
# 初始化配置
6
openclaw init

2. 配置 API Keys#

编辑配置文件：

1
nano ~/.openclaw/workspace/TOOLS.md

必需配置：

1
## API Keys
2

3
### 阿里云百炼（推荐）
4
- Key: `sk-xxxxxxxxxxxxxxxx`
5
- 模型：qwen3.5-plus
6

7
### 火山引擎（备选）
8
- Key: `xxxxxxxxxxxxxxxx`
9
- 模型：doubao-seed-2.0-code
10

11
### 本地模型（Ollama）
12
- URL: `http://localhost:11434`
13
- 模型：`qwen2.5:7b`

3. 配置代理（中国大陆用户）#

编辑 Clash 配置：

1
nano ~/.config/clash/config.yaml

或者使用环境变量（添加到 ~/.zshrc 或 ~/.bash_profile）：

1
export HTTP_PROXY=http://127.0.0.1:7890
2
export HTTPS_PROXY=http://127.0.0.1:7890
3

4
# 使配置生效
5
source ~/.zshrc

🚀 高级配置#

1. 本地模型配置（Ollama）#

安装 Ollama：

1
# 使用 Homebrew 安装
2
brew install ollama
3

4
# 或者下载安装
5
curl -fsSL https://ollama.com/install.sh | sh
6

7
# 拉取模型
8
ollama pull qwen2.5:7b
9

10
# 启动服务
11
ollama serve

配置 OpenClaw 使用本地模型：

1
nano ~/.openclaw/config.json

添加：

1
{
2
  "model": {
3
    "provider": "ollama",
4
    "endpoint": "http://localhost:11434",
5
    "model": "qwen2.5:7b"
6
  }
7
}

2. systemd 替代方案（launchd）#

macOS 使用 launchd 管理服务。创建服务文件：

1
nano ~/Library/LaunchAgents/com.openclaw.gateway.plist

内容：

1
<?xml version="1.0" encoding="UTF-8"?>
2
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
3
<plist version="1.0">
4
<dict>
5
    <key>Label</key>
6
    <string>com.openclaw.gateway</string>
7
    <key>ProgramArguments</key>
8
    <array>
9
        <string>/usr/local/bin/openclaw</string>
10
        <string>gateway</string>
11
        <string>start</string>
12
    </array>
13
    <key>RunAtLoad</key>
14
    <true/>
15
    <key>KeepAlive</key>
16
    <true/>
17
    <key>WorkingDirectory</key>
18
    <string>/Users/你的用户名/.openclaw/workspace</string>
19
</dict>
20
</plist>

加载服务：

1
# 加载服务
2
launchctl load ~/Library/LaunchAgents/com.openclaw.gateway.plist
3

4
# 启动服务
5
launchctl start com.openclaw.gateway
6

7
# 查看状态
8
launchctl list | grep openclaw

3. 日志管理#

1
# 查看日志
2
tail -f ~/.openclaw/workspace/memory/*.log
3

4
# 清理旧日志（保留最近 7 天）
5
find ~/.openclaw/workspace/memory -name "*.log" -mtime +7 -delete

🔍 常见问题解决#

1. 端口被占用#

1
# 检查端口占用
2
lsof -i :18789
3

4
# 杀死占用进程
5
kill -9 <PID>
6

7
# 或者修改 OpenClaw 端口
8
nano ~/.openclaw/config.json
9
# 修改 "port": 18790

2. 内存不足#

1
# 查看内存使用
2
top -l 1 | grep PhysMem
3

4
# 关闭不需要的应用
5
# 或者增加 Swap（不推荐，会影响性能）

3. Node.js 版本不兼容#

1
# 使用 nvm 管理 Node.js 版本
2
brew install nvm
3

4
# 安装 Node.js 20
5
nvm install 20
6
nvm use 20
7

8
# 重新安装 OpenClaw
9
npm uninstall -g openclaw
10
npm install -g openclaw

4. 权限问题#

1
# 修复 npm 全局目录权限
2
sudo chown -R $(whoami) /usr/local/lib/node_modules
3

4
# 或者使用 nvm（推荐）
5
brew install nvm

5. 本地模型无法连接#

1
# 检查 Ollama 服务
2
ps aux | grep ollama
3

4
# 重启 Ollama
5
brew services restart ollama
6

7
# 测试连接
8
curl http://localhost:11434/api/tags

6. 网络连接问题#

1
# 测试网络连接
2
curl -I https://api.binance.com
3

4
# 配置代理后测试
5
curl -x http://127.0.0.1:7890 -I https://api.binance.com
6

7
# 如果还是失败，检查代理状态
8
ps aux | grep clash

📊 性能优化#

1. Apple Silicon 优化#

M 系列芯片优化建议：

1
# 使用 ARM 版本的 Node.js
2
nvm install 20 --arch=arm64
3
nvm use 20
4

5
# 使用原生模型（更快更省电）
6
ollama pull qwen2.5:7b-instruct-q4_0

2. 调整 Node.js 内存#

1
# 编辑启动脚本或添加环境变量
2
export NODE_OPTIONS="--max-old-space-size=4096"

3. 使用 SSD 存储#

确保工作区在 SSD 上（Mac 默认就是 SSD）：

1
# 检查工作区位置
2
df -h ~/.openclaw

4. 定期清理#

1
# 清理 npm 缓存
2
npm cache clean --force
3

4
# 清理 Ollama 旧模型
5
ollama rm <model-name>
6

7
# 清理 OpenClaw 日志
8
find ~/.openclaw/workspace/memory -name "*.log" -mtime +7 -delete

✅ 验证安装#

1
# 1. 检查版本
2
openclaw --version
3

4
# 2. 检查网关状态
5
openclaw gateway status
6

7
# 3. 发送测试消息
8
openclaw message send "Hello OpenClaw!"
9

10
# 4. 检查日志
11
tail -f ~/.openclaw/workspace/memory/*.log

成功标志：

✅ 版本号正常显示
✅ 网关状态显示”Running”
✅ 能收到 AI 回复
✅ 日志无 ERROR 级别错误

📚 更多资源#

官方文档#

社区教程#

其他平台#

最后更新：2026-03-10
作者：OpenClaw 社区
许可：MIT

觉得有用？欢迎分享给更多朋友！ 🚀

文章分享

如果这篇文章对你有帮助，欢迎分享给更多人！

以太坊 ETF 传闻再起！ETH 能否突破$4,000？我的操作策略（附买入点）

OpenClaw 部署教程 - Android 篇

音乐

音乐