在开始安装之前，确认你已经准备好以下三样东西。

硬件要求

• Mac 电脑：Intel 或 Apple Silicon（M1/M2/M3/M4）均可，macOS 12 及以上
• 内存：至少 4GB，推荐 8GB
• 网络连接：安装过程需要下载软件

申请大模型 API 密钥

你需要一个大模型的 API Key。推荐使用国产模型（如 Kimi / MiniMax），价格更便宜。OpenClaw 是一个非常消耗 Token 的框架，日常任务用国产模型更划算。也可以使用 Anthropic（Claude）、OpenAI（GPT）等，或通过 Ollama 使用免费本地模型。

先把 API Key 申请好并保存下来，后面配置时会用到。

kimi 开放平台地址：https://platform.moonshot.cn/

Homebrew 是 Mac 上的软件安装助手（开发者的 App Store），Node.js 是 OpenClaw 的运行引擎。两者缺一不可。

打开终端

1. 按下 Command + 空格，打开聚焦搜索
2. 输入 终端 或 Terminal，按回车

安装 Homebrew

在终端中粘贴以下命令并按回车：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

• 系统会要求输入开机密码，输入时屏幕不显示任何字符，这是正常的，输完直接按回车
• 安装过程可能会失败并自动重试，这是正常的，耐心等待即可
• 看到 Installation successful 表示安装成功

Apple Silicon 用户额外步骤（M1/M2/M3/M4）：安装完成后运行以下两行命令，把 Homebrew 加入系统路径：

echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"

验证：输入 brew --version，显示版本号即成功。

安装 Node.js

brew install node@22

等待 1-3 分钟。验证：输入 node --version，显示 v22.x.x 或更高版本号即成功。

将 OpenClaw 程序本体下载到电脑上。

方式一：一行脚本自动安装（推荐）

curl -fsSL https://openclaw.ai/install.sh | bash

方式二：手动安装

如果上面的方式失败，使用 npm 手动安装：

npm install -g openclaw@latest

npm 是 Node.js 自带的包管理器，-g 表示全局安装。

验证安装

openclaw --version

看到版本号（如 openclaw/2026.3.x）即安装成功。

如果提示 openclaw: command not found，运行以下命令修复 npm 全局路径：

mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc
source ~/.zshrc

然后重新执行 npm install -g openclaw@latest。

OpenClaw 的初始化配置过程，向导会引导你完成身份令牌、网关设置、AI 模型选择和后台服务安装。

启动向导

openclaw onboard --install-daemon

--install-daemon 会把 OpenClaw 注册为 Mac 后台服务，每次开机自动启动。

按顺序完成以下选项

1. 用户同意：按方向键左键选到 Yes，回车确认
2. 设置方式：选择 快速启动
3. 配置处理：使用默认选项即可
4. 选择模型：根据你申请的 API Key 选择对应的提供商（如 Moonshot/Kimi），然后选择默认模型
5. 输入 API Key：粘贴你之前申请的密钥
6. 选择通道（Channel）：直接选 跳过，不要在这里选飞书，后面单独配置更方便
7. 搜索提供商：同样选择你的模型提供商，再粘贴一次 API Key
8. 安装 Skill：选 No 跳过，后面有更快速的方法
9. Enable Hooks：四个选项全部选上（按空格选中，按下键切换）
10. 重启网关：选择 Restart
11. 使用方式：选择 Open the Web UI，浏览器会自动打开控制面板

验证

在打开的网页对话框中输入「你好」，如果 AI 回复了，说明安装配置成功。

OpenClaw 默认只有聊天和编程能力（coding 配置档）。要发挥全部实力，需要切换到 full 模式，解锁浏览器控制、网页搜索、定时任务、文件读写、命令执行等所有能力。

安全提醒：full 模式下 AI 权限很高，建议不要在主力电脑上使用，最好用一台闲置电脑或云端环境。

修改配置文件

nano ~/.openclaw/openclaw.json

打开后一直按方向键往下翻，找到 tools 部分，将 profile 的值从 coding 改为 full：

{
  "tools": {
    "profile": "full"
  }
}

按 Ctrl + O 保存，按回车确认，再按 Ctrl + X 退出。

重启网关

openclaw gateway restart

验证

回到控制面板对话框，让 AI 列出桌面上的文件。如果能正确列出，说明权限已解锁。

如果担心安全问题，可以开启操作审批，AI 执行敏感操作前会先问你确认：

openclaw approvals set --policy "auto"

在飞书那边注册一个机器人身份，获取 App ID 和 App Secret，OpenClaw 拿着这组凭证就能以机器人身份收发消息。连接使用 WebSocket 长连接，不需要公网服务器、域名或 ngrok。

创建应用

1. 打开 飞书开放平台，用飞书账号登录
2. 点击 创建企业自建应用
3. 填写应用名称（如「我的 AI 助手」），点击创建
4. 进入应用后，在左侧菜单点击 添加应用能力 → 勾选 机器人
5. 进入 凭证与基础信息 页面，复制并保存 App ID（以 cli_ 开头）和 App Secret

开通权限

1. 左侧菜单点击 权限管理 → 开通权限
2. 在 应用身份 栏，搜索 im，找到「消息与群组」，点击 全选，确认开通
3. 切到 用户身份 栏，同样搜索 im，把「消息与群组」所有权限也全部开通

让飞书知道当有人给机器人发消息时，需要通知 OpenClaw。

配置事件订阅

1. 左侧菜单点击 事件与回调
2. 订阅方式选择 使用长连接接收事件
3. 点击保存

如果保存时报错「没有检测到应用连接」，说明 OpenClaw 还没连上飞书。先跳过这一步，完成下一步的飞书配置后再回来保存。

1. 保存成功后，点击 添加事件，搜索 im，将列出的事件全部勾选
2. 如果弹出新权限确认，点确认

发布应用

1. 左侧菜单点击 版本管理与发布
2. 点击 创建版本，输入版本号和更新说明
3. 点击 保存发布
4. 如果你是企业管理员，直接审批通过；否则需要找管理员审批

将飞书的凭证告诉 OpenClaw，建立连接，完成配对后就能在飞书里和 AI 对话了。

方式一：让 OpenClaw 自动配置（推荐）

因为已经开放了最高权限，可以直接在 OpenClaw 对话框里完成配置：

1. 打开 OpenClaw 控制面板的对话框
2. 把 App ID 和 App Secret 粘贴给它，告诉它「帮我配置飞书的接入」
3. OpenClaw 会自动完成所有配置

方式二：手动配置

在终端中依次运行以下命令（替换为真实值）：

openclaw config set channels.feishu.enabled true --json
openclaw config set channels.feishu.appId "cli_你的AppID"
openclaw config set channels.feishu.appSecret "你的AppSecret"
openclaw gateway restart

完成配对

1. 配置完成后，如果之前事件订阅保存失败，现在回到飞书开放平台重新保存
2. 打开飞书 App，搜索你的机器人名字，发一条消息
3. 第一次可能收到一串配对码（而不是正常回复），这是正常的
4. 将配对码复制并粘贴到 OpenClaw 对话框中，它会自动批准配对
5. 配对成功后，再回到飞书发一条消息，就能收到正常的 AI 回复了

国际版 Lark 用户需要额外设置：

openclaw config set channels.feishu.domain "lark"
openclaw gateway restart

至此，OpenClaw 安装和飞书接入全部完成！你可以在飞书上随时和 AI 助手对话了。