🦞 OpenClaw macOS 安装与配置指南
这份指南总结了在 macOS 环境下（特别是针对权限受限或 Node.js 版本过低的情况）部署 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
🤖 第四步：配置 AI 模型 (以 Qwen 为例)
登录你的模型提供商：
openclaw models auth login --provider qwen-portal
💬 第五步：配置飞书机器人
- 安装飞书插件：
openclaw plugins install @openclaw/feishu
-
在飞书开放平台创建应用，并获取
App ID和App Secret。 -
配置飞书频道（编辑
.openclaw_data/openclaw.json）：
"channels": {
"feishu": {
"enabled": true,
"appId": "你的_APP_ID",
"appSecret": "你的_APP_SECRET",
"domain": "feishu",
"dmPolicy": "open",
"allowFrom": ["*"]
}
}
⚡ 第六步：启动与运行
为了方便启动，建议创建一个 run_openclaw.sh 脚本：
#!/bin/bash
SCRIPT_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
export PATH="$SCRIPT_DIR/nodejs/bin:$PATH"
export OPENCLAW_CONFIG_PATH="$SCRIPT_DIR/.openclaw_data/openclaw.json"
export OPENCLAW_STATE_DIR="$SCRIPT_DIR/.openclaw_data"
openclaw "$@"
赋予执行权限并启动 Gateway：
chmod +x run_openclaw.sh
./run_openclaw.sh gateway --force
💡 常用命令速查
-
查看控制台: http://127.0.0.1:18789/
-
查看实时日志:
./run_openclaw.sh logs --follow -
批准新用户配对:
./run_openclaw.sh pairing approve feishu <配对码> -
列出所有技能:
./run_openclaw.sh skills list
⚠️ 常见权限报错修复
如果遇到 EPERM: operation not permitted，请确保：
-
OPENCLAW_STATE_DIR指向了一个你有权读写的本地目录。 -
在
openclaw.json中，agents.defaults.workspace和agents.list[0].workspace路径也已指向本地可写目录。
Generated by Trae AI Assistant 🦞
