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

🦞 OpenClaw macOS 安装与配置指南

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

展示

📋 前置要求

  • 操作系统: macOS (Intel/Apple Silicon)

  • Node.js : 推荐版本 v20 或 v22 (最低 v18+)

  • 飞书/Lark: 拥有飞书开放平台应用创建权限


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

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

  1. 下载 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
  1. 将 Node.js 添加到 PATH:
bash 复制代码
export PATH="$PWD/nodejs/bin:$PATH"

📦 第二步:安装 OpenClaw CLI

使用 npm 全局安装最新版:

bash 复制代码
npm install -g openclaw@latest

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

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

  1. 创建数据目录:
bash 复制代码
mkdir -p .openclaw_data
  1. 初始化配置:
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

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

  1. 安装飞书插件:
bash 复制代码
openclaw plugins install @openclaw/feishu
  1. 在飞书开放平台创建应用 ,并获取 App ID 和 App Secret。

  2. 配置飞书频道 (编辑 .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,请确保:

  1. OPENCLAW_STATE_DIR 指向了一个你有权读写的本地目录。

  2. 在 openclaw.json 中,agents.defaults.workspace 和 agents.list[0].workspace 路径也已指向本地可写目录。


Generated by Trae AI Assistant 🦞

相关推荐
工程小白菜3 小时前
ai-code-review 全链路:让 AI 来审 AI 的代码
ci/cd·ai编程
小虎AI生活4 小时前
8万星开源HyperFrames,我用WorkBuddy免费模型做了3条视频
aigc·ai编程
AI大模型-小华7 小时前
Codex 自动测试怎么用?从生成测试用例到修复失败用例
git·测试用例·ai编程·软件开发·codex·chatgpt pro·codex cli
huangfuyk7 小时前
前端融入/转后端避坑指南:AI 时代的安全边界、数据防线与实战细节
后端·ai编程
ZzT8 小时前
AI-SDLC 实践 06|开发阶段的知识库:Agent 写代码前该读哪些规则和业务知识
ai编程·claude
Bigger8 小时前
我扒了 GitHub Trending 前 20,8 个在做同一件事:给 Coding Agent 造基础设施
开源·github·ai编程
前端双越老师9 小时前
程序员 1v1 访谈系列第十六期:裸辞后失业半年了
前端·ai编程·全栈
可夫小子11 小时前
不换大模型、关掉深度思考:Hugging Face 用一个 LoRA 把 27B 编程能力拉到 64.7%
ai编程·facebook
ZhengEnCi20 小时前
AI 读不懂你的代码怎么办:用高价值注释消除曲解、过度优化与上下文膨胀
aigc·ai编程
ZhengEnCi21 小时前
AI 总模仿代码库里的过时写法怎么办:先清坏样例,再用类型与测试让 AI 无法犯错
人工智能·ai编程