你是否想过在飞书里直接调用本地运行的 AI 模型？你是否想要一个专属的「本地 AI 中控大脑」？今天这篇教程，带你从零开始，在 Windows 和 Linux/Mac 上安装 OpenClaw，并完成飞书配置！

---

什么是 OpenClaw？

OpenClaw 是一个强大的本地 AI 助手框架，可以让你在自己的机器上运行 AI 代理。它支持：

• 🤖 多模型接入 - Claude、GPT、Gemini、MiniMax 等

• 💬 多渠道接入 - Telegram、Discord、WhatsApp、飞书、微信等

• 🖥️ 网页 UI - 完整的控制面板

• 🔌 插件系统 - 丰富的扩展能力

• 📴 本地运行 - 数据本地存储，保护隐私

注：龙虾官网 https://openclaw.ai/

---

准备工作

在开始之前，你需要准备：

• Node.js 22+ （安装脚本会自动检测，如未安装会提示）

• 飞书账号（需要开发者后台权限）

• 一台电脑（Windows、Linux 或 macOS）

---

一、Windows 安装指南

步骤一：检查 Node.js 环境

首先确认你是否已安装 Node.js。打开 PowerShell，输入：

node -v

如果显示版本号（如 v22.x.x），说明已安装；如果提示「找不到命令」，需要先去 Node.js 官网[https://nodejs.org/] 下载安装。

步骤二：一键安装 OpenClaw

以管理员身份打开 PowerShell，复制以下命令执行：

iwr -useb https://openclaw.ai/install.ps1 | iex

安装过程会自动完成以下操作：

• ✅ 检测 Node.js 版本

• ✅ 安装 OpenClaw CLI

• ✅ 启动初始化向导

步骤三：初始化配置

安装完成后，终端会提示你进行初始化配置：

openclaw onboard

3.1 选择安装类型

OpenClaw 安装向导
请选择安装类型：
1) 快速入门 (推荐)
2) 自定义安装
3) 仅安装 CLI

新手建议选择「快速入门」，会自动配置最常用的功能。

3.2 配置模型

选择 AI 模型：
1) Claude
2) GPT
3) Gemini
4) MiniMax

选择你已有的模型 API。如果选择 MiniMax，需要：

1. 如果没用再引导界面选择模型，运行openclaw configure

2. Where will the Gateway run? → 选择 Local (this machine)

3. Select sections to configure → 选择 Model

4. Model/auth provider → 选择 MiniMax

5. MiniMax auth method → 选择MiniMax OAuth

6. MiniMax endpoint → 选择 CN

7. 自动弹出登录页，登录并授权

8. 确认模型选择（默认勾选 minimax-portal/MiniMax-M2.1 和 minimax-portal/MiniMax-M2.5）

9. 测试对话

输入 openclaw tui，若成功对话则表示配置成功：

3.3 配置渠道

注：如果已经配置好openclaw以及模型后端，可以试试用openclaw安装通信前端

选择要接入的渠道：
□ Telegram
□ Discord
□ 飞书
□ WhatsApp

先跳过，后续单独配置飞书。

💡 提示：如果你在安装过程中遇到 spawn npm ENOENT 错误，可以手动创建目录后重试：

New-Item -ItemType Directory -Force -Path ~\.openclaw\plugins
cd ~\.openclaw\plugins
npm install "openclaw"

步骤四：验证安装

安装完成后，运行以下命令验证：

# 检查状态
openclaw status

# 检查配置
openclaw doctor

如果看到类似输出，说明安装成功：

✅ Gateway: 运行中
✅ 模型: 已配置
✅ 渠道: 已连接

---

二、Linux / macOS 安装指南

步骤一：系统准备

确保你的系统满足以下条件：

• Ubuntu 20.04+ / Debian 11+ / CentOS 8+ / macOS

• 已安装 curl

步骤二：一键安装 OpenClaw

打开终端，执行官方安装脚本：

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

安装脚本会自动：

• 检测 Node.js 版本，如未安装则自动安装

• 安装 OpenClaw CLI 到全局

• 提示是否运行初始化向导

步骤三：初始化配置

同样运行初始化命令：

openclaw onboard

按照提示完成：选择模型供应商、配置 API Key、跳过 Channel 配置。

步骤四：验证安装

运行以下命令检查状态：

openclaw doctor        # 检查配置问题
openclaw status        # 查看网关状态
openclaw dashboard     # 打开浏览器管理界面

---

三、飞书配置详解

步骤一：创建飞书企业自建应用

1. 访问 飞书开放平台[https://open.feishu.cn]

2. 登录你的飞书账号

3. 进入开发者后台

4. 点击「创建企业自建应用」

步骤二：获取应用凭证

创建成功后，在应用详情页获取：

• App ID

• App Secret

⚠️ 重要：这两个值一定要记下来，后续配置 OpenClaw 时需要用到！

步骤三：添加机器人能力

1. 在应用功能配置中，找到「应用能力」

2. 点击「添加机器人」

3. 确认添加成功

步骤四：配置权限

进入「权限管理 → 开通权限」，勾选以下必要权限：

• im:message - 消息收发

• im:message:send_as_bot - 机器人发送消息

• im:message:readonly - 读取消息

• im:chat.members:bot_access - 群聊成员访问

或者使用 JSON 批量导入（推荐）：

{
  "scopes": {
    "tenant": [
      "aily:file:read",
      "aily:file:write",
      "im:chat.access_event.bot_p2p_chat:read",
      "im:chat.members:bot_access",
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.p2p_msg:readonly",
      "im:message:readonly",
      "im:message:send_as_bot",
      "im:resource"
    ],
    "user": [
      "aily:file:read",
      "aily:file:write",
      "im:chat.access_event.bot_p2p_chat:read"
    ]
  }
}

步骤五：创建版本并发布

1. 进入「版本管理与发布」

2. 创建新版本，填写版本说明

3. 提交并发布

如果设置了免审核策略，发布后会在飞书收到「审批通过」消息

---

四、OpenClaw 飞书插件配置

步骤一：安装飞书插件

在终端执行：

openclaw plugins install @m1heng -clawd/feishu

如果遇到目录问题，手动创建：

mkdir -p ~/.openclaw/plugins
cd ~/.openclaw/plugins
npm install "@m1heng-clawd/feishu"

步骤二：配置飞书 Channel

运行配置命令：

openclaw config

按照提示操作：

1. 选择「本地网关」

2. 选择「Channel 配置」

3. 选择「Feishu/Lark（飞书）」

4. 输入 App ID 和 App Secret

5. 选择「飞书中国」版本

6. 勾选「允许群组聊天」

或者使用环境变量配置：

# Linux/macOS
export FEISHU_APP_ID="你的AppID"
export FEISHU_APP_SECRET="你的AppSecret"

# Windows PowerShell
$env:FEISHU_APP_ID="你的AppID"
$env:FEISHU_APP_SECRET="你的AppSecret"

步骤三：重启网关

配置完成后，重启 OpenClaw 网关：

openclaw gateway

当看到类似以下日志，说明飞书通道已注册成功：

[Feishu] Channel initialized successfully
[Feishu] Bot info: xxx

---

五、飞书事件订阅配置

步骤一：启用事件与回调

1. 回到飞书开放平台应用后台

2. 进入「开发配置」

3. 找到「事件与回调」

4. 选择「使用长连接接收事件」

步骤二：订阅事件

在「事件订阅」中点击「添加事件」，根据需要勾选：

• im.message.p2p_msg.received - 私聊消息事件

• im.message.group_at_msg.received - 群聊@消息事件

• im.message.message_sent.received - 消息发送事件

---

六、测试与使用

步骤一：重新发布应用

完成所有配置后，记得在飞书开放平台重新发布新版本。

步骤二：在飞书中体验

1. 打开飞书「工作台」或「应用管理」

2. 找到你的企业自建应用

3. 安装并进入对话界面

现在你可以：

• 📝 发送消息：直接给机器人发消息

• 👥 群聊@：在群聊中 @机器人 下达指令

• 📎 文件处理：让 AI 分析文档内容

示例指令：

「帮我总结一下这段会议记录」 「根据这个文档，列出重点和风险」 「帮我写一个笑话，保存到桌面」

---

常见问题

Q1：安装时报错 sharp 失败？

尝试设置环境变量后重试：

SHARP_IGNORE_GLOBAL_LIBVIPS
=
1
 npm install -g openclaw

Q2：飞书消息收不到？

检查以下几点：

1. 应用是否已发布

2. 事件订阅是否配置

3. 回调地址是否能访问

4. OpenClaw 网关是否正常运行

Q3：如何更新 OpenClaw？

npm update -g openclaw

---

总结

通过以上步骤，你已经完成了：

1. ✅ 在 Windows/Linux/macOS 安装 OpenClaw

2. ✅ 创建飞书企业自建应用

3. ✅ 配置应用权限和事件订阅

4. ✅ 在 OpenClaw 中安装飞书插件

5. ✅ 实现飞书与本地 AI 的互通

飞书只是入口，OpenClaw 才是你的本地 AI 中枢！

现在，打开飞书，给你的 AI 机器人发送第一条指令吧 🦞

---

如果你觉得这篇文章有帮助，欢迎点赞、转发、关注！有任何问题也可以在评论区留言~

题者按

Q:普通人适合龙虾吗？

A：不适合，龙虾的可用性以及普适性不高，能说会干的“干”是折腾折腾…，无休无止的折腾…

Q:龙虾能用来干嘛？

A：题主对openclaw的定位是生活助手，金融分析师，编程助手

实际使用下来，能写简单python脚本做一些金融分析，但是仍需人为介入，如金融数据获取接口？爬虫与反爬虫的技术架构等方面

生活助手可以做一些电脑控制，但是对于浏览器网页登陆等等控制仍需调教折腾，简单可行，复杂难用

普通人感觉还是豆包、千问好用，即开即用，能做检索以及轻量分析

Q：当前市场对于 AI 行业的质疑是否和互联网的黑色星期五类似？是否是互联网一样的全面革新？

A：emmmmm，题者感觉AI可能还是不如互联网技术成熟，变革力度大，互联网发展带来了新的生活方式（手机、电脑），新的工作方式（办公室面向电脑办公），新的生产力方式（信息化管理、自动化制造）…，是革命性的…

而AI有点像信息时代的高级阶段，是互联网的发展与应用，而非彻底的革命性的。当然，毫无疑问，AI可以在编程、生物医药蛋白研发，科研创造等领域带来全新的可能，但是其对于普通人的革新似乎也目前仅限于检索、分析，可以提升原有体验，而非带来全新的交互方式或者全新体验，至于”A+“，如：AI员工，AI医疗大模型，AI机器人等等，不可否认是未来，但是未来啥时候到来?this is a problem.

但是，不可否认，热点终究是热点，会带来技术、资金、战略、政策、人才等等引入，会带来日新月异，会创造一切可能…

Q: AI能带来投资机会吗？

A：摩尔、沐曦、英伟达、谷歌等硬件算力公司、十五五国家4万亿的电力发展规划、OpenAI、minimax、deepseek等等AI模型应用、传统的HBM内存三星海力士等等和AI相关的领域行业不可置疑是热点，但是行业发展总是经历幼稚期、成长期、成熟期和衰退期，AI是成长期还是幼稚期？投资回报比如何？对于普通人而言，成长期/幼稚期是好的投资时间窗口吗？