OpenClaw macOS 安装与配置指南
这份指南总结了在 macOS 环境下(特别是针对权限受限或 Node.js 版本过低的情况)部署 OpenClaw 的最佳实践。
展示

OpenClaw 控制电脑
📋 前置要求
- 操作系统: macOS (Intel/Apple Silicon)
- Node.js: 推荐版本 v20 或 v22 (最低 v18+)
- 飞书/Lark: 拥有飞书开放平台应用创建权限
🚀 第一步:准备 Node.js 环境
如果你的系统 Node.js 版本较低,推荐使用便携式二进制包:
- 下载 Node.js v22:
curl -L https://nodejs.org/dist/v22.14.0/node-v22.14.0-darwin-x64.tar.gz -o node.tar.gz
tar -xzf node.tar.gz
mv node-v22.14.0-darwin-x64 nodejs
- 将 Node.js 添加到 PATH:
export PATH="$PWD/nodejs/bin:$PATH"
📦 第二步:安装 OpenClaw CLI
使用 npm 全局安装最新版:
npm install -g openclaw@latest
🛠️ 第三步:初始化与数据迁移
由于 macOS 默认路径 ~/.openclaw 可能存在权限问题,建议将数据存放在当前项目目录:
- 创建数据目录:
mkdir -p .openclaw_data
- 初始化配置:
export OPENCLAW_CONFIG_PATH="$PWD/.openclaw_data/openclaw.json"
export OPENCLAW_STATE_DIR="$PWD/.openclaw_data"
openclaw setup --non-interactive


