OpenClaw 零基础安装指南：Mac 本地部署并集成飞书全流程

OpenClaw 零基础安装指南：Mac 本地部署并集成飞书全流程

• • [OpenClaw 是什么](#OpenClaw 是什么)
  • 你要准备什么
  • [Step1: 安装Homebrew](#Step1: 安装Homebrew)
  • • 作用
    • 步骤
  • [Step2: 安装node.js](#Step2: 安装node.js)
  • • 作用
    • 步骤
  • [Step3: 安装OpenClaw](#Step3: 安装OpenClaw)
  • • 作用
    • 步骤
  • Step4：配置OpenClaw
  • • 作用
    • 步骤
  • [Step5: 打开OpenClaw Dashboard](#Step5: 打开OpenClaw Dashboard)
  • • 作用
    • 步骤
  • 集成飞书
  • • 在飞书开放平台创建应用
    • 配置应用权限
    • 配置事件订阅
    • 发布应用
    • [在 OpenClaw 中配置飞书](#在 OpenClaw 中配置飞书)
    • 测试

OpenClaw 是什么

OpenClaw 是一个开源的 AI 私人助理平台。你可以把它理解为：一个跑在你自己电脑上的 AI 管家。它能连接 WhatsApp、Telegram、微信、Discord，飞书 等聊天软件，让你通过日常聊天就能操控 AI 帮你完成各种任务------管日历、发邮件、浏览网页、执行脚本等。

和 ChatGPT 这类在线工具不同，OpenClaw 运行在你自己的机器上，数据由你自己掌控。

你要准备什么

在开始之前，确认以下几项：

• 一台 Mac 电脑：Intel 或 Apple Silicon。
• 至少 4GB 内存（推荐 8GB）
• 一个 AI 模型的 API Key：比如 Anthropic（Claude）、OpenAI, Google Gemini, MinMax或者Kimi的密钥。如果你还没有，可以在对应平台的官网注册获取。也可以用免费的本地模型（通过 Ollama）。

Step1: 安装Homebrew

作用

Homebrew 是 Mac 上的"软件安装助手"。很多开发工具不在 App Store 里，需要通过 Homebrew 来安装。

如果已经安装，可以跳过这一步。

确认是否安装:

brew --version

步骤

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

安装完成后，终端会提示你运行两行命令。复制执行它们，或者直接运行：

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

这两行命令是把 Homebrew 加到系统的"搜索路径"里，这样电脑以后才能找到通过 Homebrew 安装的软件。

Step2: 安装node.js

作用

Node.js 是一个 JavaScript 运行环境。OpenClaw 是用 JavaScript 编写的，需要 Node.js 才能运行。可以把 Node.js 理解为 OpenClaw 的"引擎"------没有它，OpenClaw 就跑不起来。

步骤

直接用brew install 或者直接下载安装包, node-v24.14.0.pkg，如果是brew install

brew install node@22

确认安装成功

node --version

Step3: 安装OpenClaw

作用

这一步是把 OpenClaw 的运行程序下载到你的电脑上。

步骤

# 配置npm的代理，如果你可以科学上网，可以skip这部分
npm config set registry https://registry.npmmirror.com
# 安装openclaw
sudo npm install -g openclaw@latest 

如果安装不成功，试试下面的步骤。会安装所有需要的依赖。

sudo curl -fsSL https://openclaw.ai/install.sh | sudo bash -s -- --registry https://registry.npmmirror.com

确认安装成功

openclaw --version

Step4：配置OpenClaw

作用

这是 OpenClaw 的初始化配置过程。向导会一步步引导你设置以下内容：

• 身份验证：生成一个安全令牌，防止别人控制你的 AI 助手
• 网关设置：配置 OpenClaw 的核心服务（端口、绑定地址等）
• AI 模型选择：选择你想用的大语言模型（如 Claude、GPT 等）并输入 API Key
• 安装后台服务：--install-daemon 参数会把 OpenClaw 注册为 Mac 的后台服务，这样每次开机它都会自动启动，不需要你手动运行

步骤

操作：

openclaw onboard --install-daemon

然后，会用交互式问答的方式引导你，跟着提示一步步选择即可。我的个人选择如下：

到这里要开始配置你的model provider，我选择的是MinMax，毕竟便宜。

访问https://platform.minimaxi.com/

账户管理-> 接口秘钥 -> 创建新的API Key，把这个api key copy 过来就可以了。

Step5: 打开OpenClaw Dashboard

作用

控制面板是 OpenClaw 的网页管理界面，你可以在浏览器里和 AI 助手对话、管理设置、查看连接状态。

步骤

先确保openclaw能正常运行

openclaw gateway status

打开dashboard:

openclaw dashboard

然后就可以跳转到http://127.0.0.1:18789/，然后恭喜你，你可以让他操控你的Mac了。

集成飞书

OpenClaw 的强大之处在于你可以通过日常用的聊天 App 直接和它对话。

我们以飞书为例，看下如何让 AI 助手住进飞书。

连接飞书使用的是 WebSocket 长连接模式------这意味着不需要公网服务器、不需要域名、不需要 ngrok，你的 Mac 直接和飞书云端通信。

在飞书开放平台创建应用

作用：你需要在飞书那边"注册"一个机器人身份。飞书会给你一组"身份证"（App ID 和 App Secret），OpenClaw 拿着这组身份证就能以机器人的身份收发消息。

1. 打开浏览器，访问 飞书开放平台，用你的飞书账号登录
2. 点击 创建企业自建应用
3. 填写应用名称（比如"家庭助理"）和描述，然后创建
4. 进入应用后，在左侧菜单点击 添加应用能力 → 勾选 机器人
5. 进入 凭证与基础信息 页面，记下 App ID（以 cli_ 开头）和 App Secret------后面要用

配置应用权限

作用：告诉飞书，这个机器人被允许做哪些事情（比如接收消息、发送消息等）。

1. 在飞书开放平台，开发者后天，进入你的应用 → 左侧菜单点击 权限管理
2. 搜索im，可以开通所有带有im的权限。

• im:message --- 获取与发送消息
• im:message:send_as_bot --- 以机器人身份发送消息
• im:chat --- 获取群组信息
• im:resource --- 获取消息中的资源文件（图片等）

4. 点击 批量开通

配置事件订阅

作用：让飞书知道，当有人给机器人发消息时，应该通知你的 OpenClaw。

1. 在飞书开放平台，左侧菜单点击 事件与回调
2. 订阅方式选择 使用长连接接收事件（这是关键------长连接不需要公网地址）
3. 添加事件：搜索并添加 im.message.receive_v1（接收消息事件）
   

发布应用

1. 左侧菜单点击 版本管理与发布
2. 创建一个版本并提交审核

在 OpenClaw 中配置飞书

操作 ：回到 Mac 终端，运行以下命令（把 cli_你的AppID 和 你的AppSecret 替换为真实值）：

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

作用：

• 第一行：开启飞书渠道
• 第二、三行：把飞书给的"身份证"告诉 OpenClaw
• 第四行：重启网关，让配置生效

你也可以把AppID 和 AppSecret，直接告诉OpenClaw，让它帮你配置。

测试

手机上安装飞书app，然后搜索你的机器人名字，就会看到了，这样你的7*24小时个人助理就创建完成了。