跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客我的书AI学习GitHub 精选镜像AI 生图工具UI配色美学关于
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
JavaScriptNode.jsAI

使用 OpenClaw 与飞书搭建专属 AI 机器人教程

介绍如何使用 OpenClaw 结合飞书构建 AI 机器人。主要步骤包括：安装 Node.js 环境及 OpenClaw 工具；配置大语言模型 API；在飞书开放平台创建企业自建应用并获取凭证；将飞书凭证配置至 OpenClaw；设置应用权限并发布；最后在飞书中授权配对完成连接。整个过程通过命令行操作，实现本地 AI 助手与飞书的集成。

莫名其妙发布于 2026/4/6更新于 2026/10/15119 浏览
使用 OpenClaw 与飞书搭建专属 AI 机器人教程

使用 OpenClaw 与飞书搭建专属 AI 机器人教程

当前版本 OpenClaw（2026.2.22-2）已内置飞书插件，无需额外安装。

一、准备工作

1.1 安装 Node.js（版本 ≥ 22）

OpenClaw 依赖 Node.js 运行，首先确保你的 Node 版本不低于 22。

推荐使用 nvm 管理 Node 版本，打开终端执行：

# 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.4/install.sh | bash
# 加载 nvm（避免重启终端）
. "$HOME/.nvm/nvm.sh"
# 安装 Node.js 24
nvm install 24
# 验证安装
node -v # 应输出 v24.13.1
npm -v # 应输出 11.8.0

📎 Node.js 官网：https://nodejs.org/en/download

Node.js 下载页面

1.2 安装 OpenClaw

进入 OpenClaw 官网 https://openclaw.ai/ ，我们通过 npm 全局安装：

# 安装 OpenClaw
npm i -g openclaw
# 运行引导向导（加 --install-daemon 安装守护进程，让 Gateway 在后台持续运行）
openclaw onboard --install-daemon

💡 加了 --install-daemon 后，Gateway 会作为系统守护进程自动启动（macOS 用 LaunchAgent，Linux 用 systemd），重启电脑也不会丢。如果不加，后面启动 openclaw gateway 时关掉终端机器人就断了。

📎 GitHub 地址：https://github.com/openclaw/openclaw

OpenClaw 官网

二、配置 AI 模型

OpenClaw 需要接入一个大语言模型作为"大脑"。你可以使用 Anthropic、OpenAI 等官方 API，也可以通过第三方中转服务获取。

这里以 Claude Haiku 为例。Haiku 是 Anthropic 的轻量级模型，响应快、成本低，非常适合日常对话场景。如果你需要更强的推理能力，也可以换成 claude-sonnet 或 claude-opus 等模型。

在终端依次执行以下命令：

# 1. 设置 API 地址
openclaw config set -- models.providers.my_api.baseUrl "你的API地址"
# 2. 设置 API 类型
openclaw config set -- models.providers.my_api.api "openai-completions"
# 3. 设置 API Key
openclaw config set -- models.providers.my_api.apiKey "你的API密钥"
# 4. 设置默认模型（可替换为其他模型）
openclaw config set -- agents.defaults.model.primary "my_api/claude-haiku-4-5-20251001"

⚠️ 注意：config set 和路径之间的 -- 是两个英文半角短横线，不要从网页复制，手动敲键盘上的减号键两次。

如果你不习惯命令行，也可以通过 Dashboard 配置：

  1. 启动 Gateway 后，浏览器打开 http://127.0.0.1:18789/
  2. 点击顶部 Config 标签页，切换到 Raw JSON 编辑器
  3. 找到 models.providers 部分，直接编辑 JSON
  4. 保存后 Gateway 自动热加载生效，无需重启

💡 Dashboard 的 Form 表单视图对自定义 Provider 支持有限，建议直接用 Raw JSON 编辑器修改。

三、创建飞书应用

3.1 进入飞书开放平台

访问 https://open.feishu.cn/app ，如果没有账号，用手机号注册即可。

3.2 创建企业自建应用

按照下图步骤操作：

创建应用 - 步骤 1

创建应用 - 步骤 2

创建应用 - 步骤 3

创建应用 - 步骤 4

创建完成后点击发布。

3.3 记录 App ID 和 App Secret

这两个值后面配置 OpenClaw 时要用到，务必保存好。

App ID 和 App Secret

四、连接 OpenClaw 与飞书

回到终端，将飞书应用的凭证写入 OpenClaw 配置：

# 设置飞书 App ID
openclaw config set -- channels.feishu.appId "你的 AppID"
# 设置飞书 App Secret
openclaw config set -- channels.feishu.appSecret "你的 AppSecret"
# 启动 OpenClaw Gateway
openclaw gateway

💡 新版 OpenClaw 已内置飞书支持，不需要额外安装插件。

五、配置飞书机器人权限

回到飞书开放平台，为应用添加必要的权限和事件订阅。

在「权限管理」页面，搜索 im，将 im 相关的权限全部勾选（包括消息读取、发送、群组管理等），确保机器人能正常收发消息。

💡 OpenClaw 使用 WebSocket 模式连接飞书，不需要配置事件订阅的回调地址（Request URL），保持为空即可。

权限配置 - 步骤 1

权限配置 - 步骤 2

权限配置 - 步骤 3

修改完权限后，需要重新发布一个版本，点击确认发布。

重新发布

六、首次使用：授权配对

在手机飞书上给机器人发一条消息，你会收到类似这样的提示：

OpenClaw: access not configured. Your Feishu user id: ou_72c25a66a2248f494484a792b18d0c12 Pairing code: RYXBPRNJ Ask the bot owner to approve with: openclaw pairing approve feishu RYXBPRNJ

这是 OpenClaw 的安全机制，防止陌生人使用你的机器人。需要两步操作：

6.1 开启权限

在终端中点击提示的链接，开启相关权限。

开启权限 - 步骤 1

开启权限 - 步骤 2

6.2 授权配对

在终端执行配对命令，将你的飞书账号绑定为授权用户：

openclaw pairing approve feishu RYXBPRNJ

将 RYXBPRNJ 替换为你实际收到的配对码。

配对成功

⚠️ 每创建一个新的飞书机器人应用，都需要重新走一遍这个配对流程。

七、开始使用

一切就绪，现在可以在飞书里愉快地和 AI 对话了 🎉

使用效果

目录

  1. 使用 OpenClaw 与飞书搭建专属 AI 机器人教程
  2. 一、准备工作
  3. 1.1 安装 Node.js（版本 ≥ 22）
  4. 安装 nvm
  5. 加载 nvm（避免重启终端）
  6. 安装 Node.js 24
  7. 验证安装
  8. 1.2 安装 OpenClaw
  9. 安装 OpenClaw
  10. 运行引导向导（加 --install-daemon 安装守护进程，让 Gateway 在后台持续运行）
  11. 二、配置 AI 模型
  12. 1. 设置 API 地址
  13. 2. 设置 API 类型
  14. 3. 设置 API Key
  15. 4. 设置默认模型（可替换为其他模型）
  16. 三、创建飞书应用
  17. 3.1 进入飞书开放平台
  18. 3.2 创建企业自建应用
  19. 3.3 记录 App ID 和 App Secret
  20. 四、连接 OpenClaw 与飞书
  21. 设置飞书 App ID
  22. 设置飞书 App Secret
  23. 启动 OpenClaw Gateway
  24. 五、配置飞书机器人权限
  25. 六、首次使用：授权配对
  26. 6.1 开启权限
  27. 6.2 授权配对
  28. 七、开始使用

更多推荐文章

查看全部
  • C++ 类与对象：封装特性的实现与实战应用
  • Cursor、Kiro 与 Google Antigravity 三款 AI 编程工具对比
  • 汽车雷达多径环境下幽灵目标检测技术解析
  • 前端 WebSocket 实时通信：告别轮询的最佳实践
  • Java HashMap 底层原理深度解析
  • Java 对象属性批量复制实战：BeanUtils 使用指南
  • OpenClaw 与 Telegram 机器人集成
  • AI 生成艺术二维码的几种方法（SD 与在线工具）
  • OpenClaw Ubuntu 安装指南
  • LLM 与 AIGC 融合：编程范式的转变与实践案例
  • Python 3D 光照效果实战指南：核心算法与渲染技术
  • 基于 SFT 微调 Llama2 实现自我认知
  • 在 Kubernetes 中部署 Kafka 高可用集群实战
  • 基于 AI 算法的全网比价系统设计与实现
  • 在 iPhone 和 iPad 上运行 Minecraft Java 版的 PojavLauncher 指南
  • Flutter 基础组件：BottomNavigationBar 与 TabBar 多页切换及鸿蒙适配
  • VS Code + GitHub Copilot 避坑指南：从安装配置到最佳实践
  • openTCS WEB 接口实战：从基础调用到自定义指令开发
  • 在 Jetson 上部署 OpenClaw 并集成飞书机器人实现 AI 助手
  • FPGA 烧写硬件连接详解：Vivado 固化程序操作指南

相关免费在线工具

  • RSA密钥对生成器

    生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online

  • Mermaid 预览与可视化编辑

    基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online

  • 随机西班牙地址生成器

    随机生成西班牙地址（支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选），支持数量快捷选择、显示全部与下载。 在线工具，随机西班牙地址生成器在线工具，online

  • Keycode 信息

    查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具，Keycode 信息在线工具，online

  • Escape 与 Native 编解码

    JavaScript 字符串转义/反转义；Java 风格 \uXXXX（Native2Ascii）编码与解码。 在线工具，Escape 与 Native 编解码在线工具，online

  • JavaScript / HTML 格式化

    使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具，JavaScript / HTML 格式化在线工具，online