OpenClaw 安装部署全攻略 - 最强 AI 助手本地运行指南
#openclaw#ai#feishu#tutorial 2026-03-14

你是否想过在飞书里直接调用本地运行的 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，输入：

1
node -v

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

步骤二：一键安装 OpenClaw

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

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

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

  • ✅ 检测 Node.js 版本
  • ✅ 安装 OpenClaw CLI
  • ✅ 启动初始化向导

步骤三：初始化配置

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

1
openclaw onboard

3.1 选择安装类型

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

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

3.2 配置模型

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

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

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

  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. 自动弹出登录页，登录并授权
    image.png

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

  9. 测试对话

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

3.3 配置渠道

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

1
2
3
4
5
选择要接入的渠道：
□ Telegram
□ Discord
□ 飞书
□ WhatsApp

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

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

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

步骤四：验证安装

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

1
2
3
4
5
# 检查状态
openclaw status

# 检查配置
openclaw doctor

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

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

二、Linux / macOS 安装指南

步骤一：系统准备

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

  • Ubuntu 20.04+ / Debian 11+ / CentOS 8+ / macOS
  • 已安装 curl

步骤二：一键安装 OpenClaw

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

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

安装脚本会自动：

  • 检测 Node.js 版本，如未安装则自动安装
  • 安装 OpenClaw CLI 到全局
  • 提示是否运行初始化向导

步骤三：初始化配置

同样运行初始化命令：

1
openclaw onboard

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

步骤四：验证安装

运行以下命令检查状态：

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

三、飞书配置详解

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

  1. 访问 飞书开放平台
  2. 登录你的飞书账号
  3. 进入开发者后台
  4. 点击「创建企业自建应用」
    image.png

步骤二：获取应用凭证

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

  • App ID
  • App Secret
    image.png

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

步骤三：添加机器人能力

  1. 在应用功能配置中，找到「应用能力」
  2. 点击「添加机器人」
  3. 确认添加成功
    image.png

步骤四：配置权限

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

  • im:message - 消息收发
  • im:message:send_as_bot - 机器人发送消息
  • im:message:readonly - 读取消息
  • im:chat.members:bot_access - 群聊成员访问

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

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
{
  "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"
    ]
  }
}

image.png

步骤五：创建版本并发布

  1. 进入「版本管理与发布」
  2. 创建新版本，填写版本说明
  3. 提交并发布

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

image.png

四、OpenClaw 飞书插件配置

步骤一：安装飞书插件

在终端执行：

1
openclaw plugins install @m1heng-clawd/feishu

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

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

步骤二：配置飞书 Channel

运行配置命令：

1
openclaw config

按照提示操作：

  1. 选择「本地网关」
  2. 选择「Channel 配置」
  3. 选择「Feishu/Lark（飞书）」
  4. 输入 App ID 和 App Secret
  5. 选择「飞书中国」版本
  6. 勾选「允许群组聊天」

或者使用环境变量配置：

1
2
3
4
5
6
7
# 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 网关：

1
openclaw gateway

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

1
2
[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 失败？

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

1
SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw

Q2：飞书消息收不到？

检查以下几点：

  1. 应用是否已发布
  2. 事件订阅是否配置
  3. 回调地址是否能访问
  4. OpenClaw 网关是否正常运行

Q3：如何更新 OpenClaw？

1
npm update -g openclaw

总结

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

  1. ✅ 在 Windows/Linux/macOS 安装 OpenClaw
  2. ✅ 创建飞书企业自建应用
  3. ✅ 配置应用权限和事件订阅
  4. ✅ 在 OpenClaw 中安装飞书插件
  5. ✅ 实现飞书与本地 AI 的互通

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

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

欢迎关注我的公众号

扫码关注「如是观世」，获取更多精彩内容

公众号二维码