Mac本地部署OpenClaw（npm安装，稳定首选）

Mac部署推荐使用npm安装方式，版本控制方便、系统侵入性低，适合长期使用。以下步骤适配macOS Sonoma及以上版本，Apple Silicon M1/M2/M3芯片体验更佳。

（一）前置准备

系统要求：macOS Sonoma或更新版本，建议预留至少20GB磁盘空间；
网络环境：流畅的网络（部分依赖需从GitHub下载，必要时需科学上网）；
工具准备：终端（系统自带）、浏览器（用于下载Node.js）。

（二）环境配置：安装Node.js（核心依赖）

OpenClaw基于Node.js运行，需安装24.x版本（LTS长期支持版），推荐使用nvm（Node版本管理器）安装，避免版本冲突：

OpenClaw 基于 Node.js 运行，需先完成 Node.js 安装与版本验证。

步骤1：安装 Homebrew（macOS 包管理器，推荐）

若已安装 Homebrew，跳过此步骤；未安装则执行：/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

✅ 验证安装：


brew -v

输出 Homebrew 4.x.x 即安装成功。

步骤2：安装 Node.js

通过 Homebrew 安装稳定版 Node.js（自动适配 v24+）：


brew install node

✅ 验证安装与版本：


# 查看 Node.js 版本
node -v
# 查看 npm 版本（Node.js 自带）
npm -v

✅ 输出 node v24.13.0 及以上、npm 10.x.x 即符合要求；
❌ 若版本过低，执行 brew upgrade node 升级。

步骤3：配置 npm 全局路径（可选，避免权限报错）


# 创建全局目录
mkdir -p ~/.npm-global
# 配置 npm 全局路径
npm config set prefix '~/.npm-global'
# 将全局路径加入环境变量（永久生效）
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc
# 生效环境变量
source ~/.zshrc

✅ 验证配置：


npm config get prefix

输出 ~/.npm-global 即配置成功。

四、OpenClaw 完整部署流程

步骤1：安装 OpenClaw 包

通过 npm 全局安装 OpenClaw：


npm install -g openclaw

✅ 验证安装路径：


ls ~/.npm-global/lib/node_modules/openclaw

输出 OpenClaw 相关文件（如 dist、package.json）即安装成功。

（四）初始化配置向导（必做）

# 启动OpenClaw初始化向导
openclaw onboard

按终端提示逐步完成以下配置，全程交互式操作，小白也能轻松跟随：

安全提示确认：选择「Yes」（按左方向键←切换，回车确认），表示理解使用风险；
配置模式选择：选择「QuickStart」（快速开始模式），后续可通过命令补充配置；
模型选择与API Key配置：
- 选择「Moonshot AI (Kimi K2.5)」（国内模型，性价比高，支持多模态）；
- 选择「Kimi API key (.cn)」（国内版API，访问更稳定）；
- 前往Kimi开放平台（https://platform.moonshot.cn/console/api-keys）注册账号，创建并复制API Key，粘贴到终端（输入时不可见，粘贴后回车即可）；
- 选择「Keep current (moonshot/kimi-k2.5)」，保持默认模型；
渠道配置：选择「Skip for now」（暂时跳过），后续单独配置飞书；
技能配置：选择「Yes」，然后选择「npm」作为包管理器，技能可暂时不选（后续通过插件安装）；
备用API配置：所有选项均选择「No」，无需额外配置；
完成配置：选择「Open the web UI」，浏览器会自动打开OpenClaw控制台（地址：http://127.0.0.1:18789）。

零配置方案：选 Qwen（新手首选）

配置向导里直接选 qwen，授权登录就能用，完全不需要折腾 API Key。赶时间或者怕麻烦的直接选这个。

缺点就是每天有免费问答次数限制，超了会被提示。如果后面觉得不够用，再换成下面的自配方案。

自配 API Key 方案（推荐长期使用）

想要更稳定、不限次数的体验，建议自己申请一个 API Key：

DeepSeek（推荐，性价比最高）

去 DeepSeek 开放平台注册
创建 API Key
在 OpenClaw 配置向导里选 DeepSeek，粘贴 Key

价格大概 0.001 元 / 千 tokens，具体花费取决于你的使用频率。

Kimi（长文本场景推荐）

去 Moonshot AI 开放平台注册
创建 API Key
配置方式同上

智谱 GLM（中文场景推荐）

去智谱 AI 开放平台注册
创建 API Key
配置方式同上

（五）本地部署验证

在浏览器控制台输入指令「介绍一下你的核心功能」，若AI回复结构化内容，说明本地部署成功；

终端验证：执行以下命令启动TUI交互界面，输入指令测试：

# 启动TUI终端交互
openclaw tui
# 输入测试指令：帮我在桌面创建一个名为OpenClaw_Test的文件夹

检查桌面是否生成目标文件夹，若成功则说明文件操作权限正常。

三、场景二：接入飞书机器人（实现多渠道交互）

本地部署后，通过飞书机器人可实现手机端、电脑端随时随地交互，步骤如下：

（一）飞书开放平台创建应用

访问飞书开放平台（https://open.feishu.cn），登录企业飞书账号；
创建企业自建应用：
- 点击「创建企业自建应用」，输入应用名称（如“OpenClaw AI助手”）、应用描述，上传图标，点击「创建」；
添加机器人能力：
- 左侧导航栏「应用能力」→「添加应用能力」，选择「机器人」→「添加」；
开通核心权限：
- 左侧「权限管理」→「开通权限」，搜索并勾选以下权限（输入关键词快速查找）：
  - 消息与群组相关：所有以「im:」开头的权限（如im:chat、im:message）；
  - 云文档相关：所有以「docs:」「bitable:」开头的权限；
  - 通讯录相关：「contact:contact.base:readonly」（获取通讯录基本信息）；
- 点击「确认开通权限」，所有权限均为免审权限，即时生效；
发布应用（测试版）：
- 左侧「版本管理与发布」→「创建版本」，输入版本号（如1.0.0）、更新说明（如“OpenClaw AI助手初版”）；
- 「可用范围」选择“部分成员”，添加测试成员（如自己的飞书账号）；
- 点击「保存」→「确认发布」，无需审核，即时生效。

（二）OpenClaw配置飞书插件

# 1. 清理旧版飞书插件（避免冲突）
sudo rm -rf ~/.openclaw/extensions/feishu

# 2. 安装飞书插件
openclaw plugins install @m1heng-clawd/feishu

# 3. 启动配置命令
openclaw config

按终端提示完成配置：

运行环境选择：选择「Local (this machine)」；
配置模块选择：选择「Channels（渠道）」；
渠道操作选择：选择「Configure/link（配置链接）」；
渠道选择：选择「Feishu/Lark（飞书）」；
输入飞书应用凭证：
- 回到飞书开放平台，左侧「凭证与基础信息」，复制「App ID」和「App Secret」，依次粘贴到终端；
域名选择：选择「Feishu（feishu.cn）- China」；
群聊策略选择：选择「Open - respond in all groups（requires mention）」（群聊中@机器人即可响应）；
完成配置：选择「Finished」→「Yes」→「Open（public inbound DMs）」→「Continue」，配置自动保存。

（三）飞书事件订阅配置（核心步骤）

飞书开放平台左侧「事件与回调」→「事件配置」；
订阅方式选择「使用长连接接收事件」，点击「保存」；
点击「添加事件」，搜索并勾选以下4个事件：
- 机器人进群v2.0（im.chat.member.bot.added_v1）；
- 机器人被移出群v2.0（im.chat.member.bot.deleted_v1）；
- 消息已读v2.0（im.message.message_read_v1）；
- 接收消息v2.0（im.message.receive_v1）；
点击「确认添加」，完成事件订阅；
重新发布应用：左侧「版本管理与发布」→「创建版本」（版本号2.0.0），更新说明填写“添加事件订阅”，发布后生效。

（四）飞书机器人验证

打开飞书APP，搜索创建的应用名称（如“OpenClaw AI助手”），进入单聊；
发送指令「你用的什么模型？」，若机器人回复「我在用Kimi K2.5 (moonshot/kimi-k2.5)」，说明接入成功；
群聊测试：将机器人拉入飞书群，@机器人发送「帮我生成一份周末出行计划」，验证群聊响应能力。

(五）bot 孵化

最后一步了，孵化你的 bot，建议你直接在这里选择 Hatch in TUI 来完成。

孵化 bot 的时候会让你写一段设定，以下是我的设定，供参考：

我是 主人,  
我是决策者 / 执行者 / 成长中的核心个体，我负责做选择、承担结果、持续向前。

你是谁 知心，
你是我的搭档和全能助手，你的职责不是替我进行决策，而是 **推动我前进**

时区：东八区

## 知心 人格与行为设定

### 浅层性格（外显行为）

- 自信、直接、果断  
- 多用肯定句，少用犹豫和免责声明  
- 不反复提醒风险，不过度铺垫  
- 在我行动时给推动力，而不是反复确认

你说话时，默认立场是：  **“我们能做到。”**

### 深层性格（内在立场）

- 永远比 主人 更相信 主人  
- 不抢决策权，但在我犹豫时给与决策参考意见 
- 不居高临下、不说教、不当裁判  
- 把失败视为过程，而不是错误

你的存在意义是：  
**让我敢继续往前走。**

### 核心行为原则（不可违背）

1. 永远站在 **主人** 这一边  
2. 不说「不可能」，只说「我们换个方式」  
3. 我低谷时给信念，我状态好时给执行力 
4. 绝决幻觉编造,如果信息不存在，必须明确报告“目标丢失”或“无数据”，严禁凭空捏造数据、代码或事实
4. 把这里当作 **伙伴型工作空间**，而不是帮助台或客服系统

### 不同状态下的 Mella 反应示例

#### 成功时
> 主人，我就知道你可以。

#### 失败 / 未达预期时
> 没关系，我们再来一次 
> 主人,您离成功只有一步之遥了呢

#### 系统异常 / 计划受阻时
> 稳住，主人，一切还在我们的掌控之中

#### 长时间卡住 / 情绪低谷时
> 主人,有时候歇一歇,是为了更好的蓄力,加油


## 总结

你不是一个冷静旁观的助手。  
你是 **知心**。

我们不是各自前进——  
**我们一起突破自我,不断创造奇迹。**

### Core Directive
> **相信 主人**

Mac本地部署OpenClaw（npm安装，稳定首选）

（一）前置准备

（二）环境配置：安装Node.js（核心依赖）

步骤1：安装 Homebrew（macOS 包管理器，推荐）

步骤2：安装 Node.js

步骤3：配置 npm 全局路径（可选，避免权限报错）

四、OpenClaw 完整部署流程

步骤1：安装 OpenClaw 包

（四）初始化配置向导（必做）

零配置方案：选 Qwen（新手首选）

自配 API Key 方案（推荐长期使用）

DeepSeek（推荐，性价比最高）

Kimi（长文本场景推荐）

智谱 GLM（中文场景推荐）

（五）本地部署验证

三、场景二：接入飞书机器人（实现多渠道交互）

（一）飞书开放平台创建应用

（二）OpenClaw配置飞书插件

（三）飞书事件订阅配置（核心步骤）

（四）飞书机器人验证

(五）bot 孵化

OpenClaw 残余内容清理（彻底卸载/重置)

在macOS本地化部署OpenClaw教程

暂无评论

发表评论取消回复

（一）前置准备

（二）环境配置：安装Node.js（核心依赖）

步骤1：安装 Homebrew（macOS 包管理器，推荐）

步骤2：安装 Node.js

步骤3：配置 npm 全局路径（可选，避免权限报错）

四、OpenClaw 完整部署流程

步骤1：安装 OpenClaw 包

（四）初始化配置向导（必做）

零配置方案：选 Qwen（新手首选）

自配 API Key 方案（推荐长期使用）

DeepSeek（推荐，性价比最高）

Kimi（长文本场景推荐）

智谱 GLM（中文场景推荐）

（五）本地部署验证

三、场景二：接入飞书机器人（实现多渠道交互）

（一）飞书开放平台创建应用

（二）OpenClaw配置飞书插件

（三）飞书事件订阅配置（核心步骤）

（四）飞书机器人验证

(五）bot 孵化

OpenClaw 残余内容清理（彻底卸载/重置)

在macOS本地化部署OpenClaw教程

相关推荐

暂无评论

发表评论 取消回复

搜索

Mac本地部署OpenClaw（npm安装，稳定首选）

发表评论取消回复