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

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

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

前提条件

仅需在管理员 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 中执行：

npm install -g openclaw@latest       // 安装，耗时略久，稍等片刻

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

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

启动并安装守护进程：

openclaw onboard --install-daemon    // 启动

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

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

3. 网页网关（Web Gateway）

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

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

打开 "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 网页网关

openclaw gateway install   // 必须管理员权限，用的 pwsh7
openclaw gateway           // 启动

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

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

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

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

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

执行：

openclaw plugins install @m1heng-clawd/feishu    // 安装命令

一定会遇到的问题：

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

[openclaw] Failed to start CLI: Error: spawn EINVAL

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

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

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

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 的扩展目录：

// 创建扩展目录并复制文件
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 服务：

openclaw gateway restart

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

npm config set registry https://registry.npmjs.org/  // 还原官方镜像源
npm config get registry  // 验证

替代方案（二）：在扩展目录中直接补装依赖

如果已经通过 openclaw plugins install 安装了插件但缺少依赖，可以直接在扩展目录中补装：

cd C:\Users\<用户名>\.openclaw\extensions\feishu
npm install --prod

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

执行配置命令：

openclaw config

按照提示填入飞书应用的 App ID、App Secret 等信息。配置完成后，OpenClaw 会自动连接飞书机器人。

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

配置完成后，在飞书中找到你的机器人，发送消息即可开始对话。OpenClaw 会响应你的指令，并可以执行各种任务，如文件操作、代码执行等。

测试步骤：

  1. 在飞书中打开机器人对话
  2. 发送测试消息，如"你好"
  3. 观察机器人是否正常响应
  4. 尝试发送更复杂的指令进行测试

验证与自查

  1. openclaw plugins list 能看到 feishu 插件
  2. 浏览器访问 http://127.0.0.1:18789/ 能打开控制台，右上角显示 online 绿色图标
  3. 在飞书中给机器人发"你好"，能收到 AI 回复
  4. npm config get registry 确认 registry 已还原为官方源（如按上文操作）

常见问题与排查建议

问题 1：网关无法访问

现象： 浏览器访问 http://127.0.0.1:18789/ 显示"无法访问此网站"

解决方案：

  1. 以管理员权限重新安装网关：openclaw gateway install
  2. 重启网关服务：openclaw gateway restart
  3. 检查防火墙是否阻止了端口 18789

问题 2：插件安装失败（spawn EINVAL）

现象： 执行 openclaw plugins install @m1heng-clawd/feishu 时报错

解决方案：

  • 使用本文推荐的"本地先安装，再拷贝"方案
  • 确保使用国内镜像源：npm config set registry https://registry.npmmirror.com
  • 在扩展目录中手动执行 npm install --prod

问题 3：飞书机器人没有输入框

现象： 飞书中打开机器人，但看不到聊天输入框

解决方案：

  1. 确保在飞书后台完成了事件回调配置
  2. 在飞书开放平台重新发布应用版本
  3. 等待几分钟后刷新飞书客户端

问题 4：机器人不响应消息

现象： 在飞书中发送消息，机器人没有任何反应

解决方案：

  1. 检查 OpenClaw 服务是否正常运行：openclaw gateway
  2. 查看日志文件排查错误
  3. 确认飞书后台的权限配置是否完整
  4. 验证 openclaw config 中的配置信息是否正确

参考资料

  1. OpenClaw 官方文档
  2. 【保姆级教程】手把手教你安装OpenClaw并接入飞书
  3. m1heng/clawdbot-feishu 插件仓库
  4. OpenClaw 到底怎么装？超详细教程
  5. 飞书开放平台

系列地址

本文为 OpenClaw 系列教程的一部分，更多相关内容请访问：

  • 原文地址：https://xmuli.tech/posts/4e21d8f5/
  • 作者博客：https://xmuli.tech/

作者： 偕臧 最后更新： 2026-02-24 环境： Windows 11 25H2 + PowerShell 7