OpenClaw + 飞书（Feishu）环境搭建指南

偕臧x2026-02-25 8:34

简 述: 一个全面、实用、可直接上手的 Windows 环境下 OpenClaw × 飞书 插件安装与调试指南的部署教程。

涵盖从安装 OpenClaw、配置本地网关、到接入飞书机器人（含插件安装、国内环境 npm 安装困难的解决方案） 、常见问题排查等完整步骤。实际的部署环境为 💻 win11 25H2 ，非 WSL 方案。

文章目录

    • 前提条件
    • 环境说明与约定
    • [安装 OpenClaw + 飞书 部署流程](#安装 OpenClaw + 飞书 部署流程)
      • [1. 安装 OpenClaw](#1. 安装 OpenClaw)
      • [2. 初次启动与向导（onboard）](#2. 初次启动与向导（onboard）)
      • [3 网页网关（Web Gateway）](#3 网页网关（Web Gateway）)
        • [3.1 重置或首次配置建议使用](#3.1 重置或首次配置建议使用)
        • [3.2 如果以前配置过，但是没有配置好（解决方案如下）；](#3.2 如果以前配置过，但是没有配置好（解决方案如下）；)
      • [4. 配置飞书（Feishu）后台与权限](#4. 配置飞书（Feishu）后台与权限)
      • [5. 安装飞书插件（extensions / feishu）](#5. 安装飞书插件（extensions / feishu）)
      • [6. 使用 `openclaw config` 完成飞书相关配置](#6. 使用 openclaw config 完成飞书相关配置)
      • [7. 控制演示（启动并在飞书中控制电脑，效果演示）](#7. 控制演示（启动并在飞书中控制电脑，效果演示）)
    • 常见问题与排查建议
    • 参考资料
    • 系列地址

本文初发于 "偕臧的小站"，同步转载于此。

前提条件

仅需在管理员 PowerShell 窗口执行一次，在管理员权限的 PowerShell 窗口中依次运行：

powershell 复制代码 
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass

说明：

  • 第一条命令允许当前用户运行本地与下载的脚本。
  • 第二条命令在当前 PowerShell 会话中临时跳过脚本执行策略的限制。

安全提示： 这两条命令仅影响当前用户或当前会话，不会修改系统全局策略或其他用户的环境。

环境说明与约定

本文的所有 openclaw 相关命令与演示均在 PowerShell 7（Pwsh7）下执行。除特别说明外，操作以非管理员权限运行为主。
关于模型选择：部署时可选择如 Qiwen 或者 智谱 的模型（两者均可快速注册并接入；实测 Qiwen 登录一次即可，智谱需要复制 API Key）；两种方式都实际接接入过且成功。

安装 OpenClaw + 飞书 部署流程

1. 安装 OpenClaw

在 PowerShell 中执行：

bash 复制代码 
npm install -g openclaw@latest       // 安装， 耗时略久，稍等片刻

安装完成后，可按需执行 openclaw --help 查看可用子命令。

2. 初次启动与向导（onboard）

启动并安装守护进程：

bash 复制代码 
openclaw onboard --install-daemon    // 启动

向导会让你选择 AI 模型、是否连接即时通讯平台等选项。若只想先跑通本地流程，可以选择跳过连接即时通讯平台，后续再单独安装飞书插件。

参考教程：保姆级教程（手把手安装 OpenClaw 并接入飞书）提供了较详尽的步骤，适合初学者对照操作。

示意图：

3 网页网关（Web Gateway）

3.1 重置或首次配置建议使用

如果没配置过（或者一开始选择重置 Rest 选项； 推荐这种）

打开 "C:\Users\Venn\.openclaw\openclaw.json" 文件，选中 gateway - token 拷贝到网页里面。这样就能够在网页里面直接聊天。右上角也会显示 online 绿色图标

直接网页端进行聊天

当控制台服务启动后，直接浏览器输入 http://127.0.0.1:18789/ 就可以进入这个页面。

3.2 如果以前配置过，但是没有配置好（解决方案如下）；

则发概率打开网页失败

这里会自动打开浏览器，网址为 http://127.0.0.1:18789/#token=48cc2621xxxxxxxxxxxxx5942aebfe31cbf5

但是会显示网页显示不对

无法访问此网站

127.0.0.1 拒绝了我们的连接请求。

配置 Openclaw 网页网关

bash 复制代码 
openclaw gateway install   // 必须 管理员 权限，用的 pwsh7
openclaw gateway           // 启动

4. 配置飞书（Feishu）后台与权限

的 后台配置和操作参考 【保姆级教程】手把手教你安装OpenClaw并接入飞书，让AI在聊天软件里帮你干活 的 【五、接入飞书机器人】 章节。非常详细。

常见坑：必须发布两次应用版本。第一次发布后机器人可能没有聊天输入框；完成回调配置并再次发布后，聊天界面才会出现输入框并能正常输入文字。

飞书开放平台：https://open.feishu.cn（在飞书后台完成应用的创建与事件回调设置）。

5. 安装飞书插件（extensions / feishu）

执行：

bash 复制代码 
openclaw plugins install @m1heng-clawd/feishu    // 安装命令

一定 会遇到的问题：

一定会遇到 openclaw安装飞书插件时一定会遇到的报错 spawn：

openclaw Failed to start CLI: Error: spawn EINVAL

插件官网 m1heng/clawdbot-feishu， 里面自带的一篇比较详细的，也可以对比着参考 OpenClaw 到底怎么装？一篇纯小白也能成功部署的超详细教程，说的比较详细，更适合纯小白扫盲，且由于 AI 迭代太快，但时间内里面有些步骤已经属于过时了，但是仍有一定借鉴含。

推荐的实测解决方案（一）：本地先安装，再拷贝到扩展目录，推荐

在 C:\Users\<用户名>\.openclaw 路径下执行：

bash 复制代码 
npm config set registry https://registry.npmmirror.com  // 先设置国内镜像
npm cache clean --force
npm install @m1heng-clawd/feishu --verbose   // 显示下载详细， 主要此包安装比较困难

// 确认安装成功
npm list @m1heng-clawd/feishu
ls node_modules/@m1heng-clawd/feishu

然后将安装好的包复制到 OpenClaw 的扩展目录：

powershell 复制代码 
// 创建扩展目录并复制文件
C:\Users\Venn\.openclaw> mkdir extensions
C:\Users\Venn\.openclaw> mkdir extensions\feishu
C:\Users\Venn\.openclaw> xcopy /E /Y "node_modules\@m1heng-clawd\feishu\*" "extensions\feishu\"


// 安装依赖
PS C:\Users\Venn\.openclaw> cd extensions\feishu
PS C:\Users\Venn\.openclaw\extensions\feishu> npm install --prod  // 很重要一步，不换源也很慢或者失败

完成后重启 OpenClaw 服务：

bash 复制代码 
openclaw gateway restart

并将 npm registry 还原为官方镜像（可选）：

bash 复制代码 
npm config set registry https://registry.npmjs.org/  // 还原官方镜像源
npm config get registry
替代方案（二）：在扩展目录中直接补装依赖

解决安装过程中可能的依赖问题，这是因为安装插件过程中没有正常安装完依赖导致的，只需要到插件目录继续安装下就行：

bash 复制代码 
cd ~/.openclaw/extensions/feishu
npm install

6. 使用 openclaw config 完成飞书相关配置

执行 openclaw config， 后续步骤参考 文章 的 【八）安装飞书插件】 章节部分，按照这个选继续操作

包括后面 【回到飞书后台设置事件回调】步骤 也继续参考。 如果缺少这一步那么机器人就聊天界面不会有底部的 聊天栏，无法输入文字了。 设置后一定要再次发布一次版本，才会更新生效。

7. 控制演示（启动并在飞书中控制电脑，效果演示）

  • 运行openclaw gateway 启动服务

  • 在 飞书中搜索 配置的 bot 名字，然后选中开始聊天

    复制代码 
    <img src="https://i-blog.csdnimg.cn/direct/fbdbf21c4b2f4d09b56d16c23e78aca6.png" width="40%"/>

  • 开始聊天，使用自然语言对电脑进行编码和指令的响应。

    这里尝试提问两个，一个通用问题，一个截图操作。 都完美响应了。

常见问题与排查建议

  • 网页无法访问 127.0.0.1:18789 ：确认 openclaw gateway 已安装并以管理员权限启动；检查本地防火墙或端口占用。
  • 插件安装报 spawn EINVAL ：采用"先安装再拷贝"的方法，或在扩展目录中手动 npm install。
  • 飞书聊天界面没有输入框 ：回到飞书后台检查事件回调配置，完成后再次发布一次版本。

参考资料

系列地址

QtExamples 欢迎 star ⭐ 和 fork 🍴 这个系列的 C++ / QT / DTK 学习，附学习由浅入深的目录，这里你可以学到如何亲自编写这类软件的经验，这是一系列完整的教程，并且永久免费！

相关推荐
星哥来了3 小时前
OpenAI 对接飞书
飞书
玩泥巴的1 天前
MAF + 飞书：让大模型干活，但别让它乱干
ai·c#·.net·飞书·agent
Hello_Pyhx1 天前
Zenance 源码部署与数据迁移：先跑通本地账本，再接 Dropbox
部署·记账
Teable任意门互动2 天前
项目管理数字化落地案例｜任意门互动科技（Teable 官方合作伙伴）以多维表格搭建项目管理平台
人工智能·开源·软件工程·飞书·开源软件·数据库开发
七夜zippoe2 天前
把 OpenClaw Agent 搬进 K8s：容器化部署全记录
ai·云原生·容器·kubernetes·openclaw
Rock Chin6972 天前
把 Claude Code 和 Codex 接进微信、飞书、钉钉：LangBot Runner 插件实战
elasticsearch·钉钉·飞书
goehou3 天前
Agent 接飞书实战：回调验签、事件去重与异步回复（附踩坑）
实战·飞书·agent·mcp·im集成
张张123y3 天前
后端第九课：部署上线（把你的 FastAPI 后端真正跑起来给别人用）
python·docker·部署·fastapi
Joy T4 天前
阿里云全栈部署 Skill：环境检查、版本适配、灰度发布与回滚实践
阿里云·云计算·部署·skills·ai能力接入·版本冲突
鬼手点金5 天前
nanoGPT/nanochat 能做出 DeepSeek/Qwen 这样的大模型吗？
服务器·前端·javascript·bug·openclaw
热门推荐
01国内可直接用、免费额度/永久免费的大模型API清单（含 SiliconFlow、火山、阿里、智谱、百度、Kimi、DeepSeek、DMXAPI 等）02如何新建文件夹？ 电脑新建文件夹的4种方法03历年考研数学一、数学二、数学三真题试卷及答案PDF04「全语录+省流版」邵艾伦 × 孙宇晨：聊风口、聊个人IP、聊年轻人如何抓住 AI 时代的机会05GitHub 镜像站点06几个好用的ip纯净度检测网站07苹果iPA游戏软件资源下载网站08昇腾910B系列芯片完全指南：四款型号对比、服务器选型与大模型部署实战09Windows 10/11 如何退出微软账户并改用本地账户登录（含找不到选项的解决方法）10蜘蛛磁力 搜索引擎大全，如何使用蜘蛛磁力查找磁力链接