个人向：本机MAC部署OpenClaw过程记录

🦞 OpenClaw macOS 安装与配置指南

这份指南总结了在 macOS 环境下（特别是针对权限受限或 Node.js 版本过低的情况）部署 OpenClaw 的最佳实践。

展示

📋 前置要求

操作系统: macOS (Intel/Apple Silicon)
Node.js : 推荐版本 v20 或 v22 (最低 v18+)
飞书/Lark: 拥有飞书开放平台应用创建权限

🚀 第一步：准备 Node.js 环境

如果你的系统 Node.js 版本较低，推荐使用便携式二进制包：

下载 Node.js v22：

bash 复制代码

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：

bash 复制代码

export PATH="$PWD/nodejs/bin:$PATH"

📦 第二步：安装 OpenClaw CLI

使用 npm 全局安装最新版：

bash 复制代码

npm install -g openclaw@latest

🛠️ 第三步：初始化与数据迁移

由于 macOS 默认路径 ~/.openclaw 可能存在权限问题，建议将数据存放在当前项目目录：

bash 复制代码

mkdir -p .openclaw_data

初始化配置：

bash 复制代码

export OPENCLAW_CONFIG_PATH="$PWD/.openclaw_data/openclaw.json"

export OPENCLAW_STATE_DIR="$PWD/.openclaw_data"

openclaw setup --non-interactive

🤖 第四步：配置 AI 模型 (以 Qwen 为例)

登录你的模型提供商：

bash 复制代码

openclaw models auth login --provider qwen-portal

💬 第五步：配置飞书机器人

安装飞书插件：

bash 复制代码

openclaw plugins install @openclaw/feishu

在飞书开放平台创建应用 ，并获取 App ID 和 App Secret。
配置飞书频道 （编辑 .openclaw_data/openclaw.json）：

json 复制代码

"channels": {

"feishu": {

"enabled": true,

"appId": "你的_APP_ID",

"appSecret": "你的_APP_SECRET",

"domain": "feishu",

"dmPolicy": "open",

"allowFrom": ["*"]

}

}

⚡ 第六步：启动与运行

为了方便启动，建议创建一个 run_openclaw.sh 脚本：

bash 复制代码

#!/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：

bash 复制代码

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 🦞