养龙虾日记05:OpenClaw连接飞书从踩坑到成功的完整教程

本文档详细记录了在OpenClaw环境中配置飞书插件过程中遇到的各种问题及其解决方案。通过系统性的梳理，为后续用户避免常见陷阱提供参考。本文档基于OpenClaw 2026.2.26版本编写，最终解决问题在2026.3.12版本。对常规步骤不清楚的，可以参考文末的参考文档。

一、安装过程中的常见问题

1.1 多种安装方式对比

在OpenClaw 2026.2.26版本中，尝试了多种安装飞书插件的方式：

方式一：通过OpenClaw配置页面安装

- **操作流程**：`openclaw config` → 控制台页面 → 选择channel → 找到feishu进行下载安装

- **主要问题**：有时channel列表上不显示feishu选项

- **错误信息**：

```

Failed to start CLI: Error: spawn EINVAL

at ChildProcess.spawn (node:internal/child_process:420:11)

at spawn (node:child_process:753:9)

...

```

- **建议处理**：有说法称此错误可忽略，检查插件是否存在后可继续，但实际效果因人而异。（见参考资料1）

方式二：PowerShell管理员模式直接安装

- **命令**：`openclaw plugins install @m1heng-clawd/feishu`

- **问题**：出现与方式一类似的spawn错误

方式三：NPM安装

- **命令**：`npm install @openclaw/plugin-feishu`

- **注意**：具体错误信息忘了。。。

方式四：本地TGZ包安装

- **获取方式**：从GitHub仓库下载tar包

- 仓库地址：https://github.com/m1heng/clawdbot-feishu

- **安装命令**：`openclaw plugins install feishu-2026.2.25.tgz`

- **查看已安装插件**：`openclaw plugins list`

- **预期输出示例**：

||| Feishu/Lark channel plugin||

二、插件配置注意事项

2.1 配置流程参考

飞书平台侧的基本配置可参考：https://zhuanlan.zhihu.com/p/2014287886124594271

2.2 常见配置错误及解决方案

错误1：插件重复提示

- **原因**：先后多种安装方式可能导致插件重复安装

- **解决方法**：清理所有相关目录下的feishu插件后重新安装

- NPM相关目录

- OpenClaw工作目录下的extensions目录

错误2：配置位置错误

- **错误配置**：

```json

"feishu": {

"enabled": true

}

```

- **正确配置**：appId和appSecret应配置在channel下的对应条目，而非enabled字段下

错误3：插件删除后的残留问题

- **现象**：完全删除插件后仍报错"无法加载飞书插件"

- **根本原因**：配置文件中channel下的飞书配置项未完全清除

三、版本升级减少麻烦，最终成功

3.1 升级命令

```bash

npm install -g openclaw@latest

```

当前版本：2026.3.12

3.2 新版本优势

- 问题较少

- 可直接在`openclaw config`页面下载并配置飞书插件

- 安装流程更加稳定

四、其他问题

4.1 机器人不回复消息

**现象**：飞书平台正确配置机器人权限后，手机端发送消息无回复

**诊断命令**：`openclaw logs --follow`

多一会出现以下信息：

```

gateway connect failed: Error: gateway closed (1000):

Gateway not reachable. Is it running and accessible?

Gateway target: ws://127.0.0.1:18789

Source: local loopback

Config: C:\Users\hua'wei\.openclaw\openclaw.json

Bind: loopback

Hint: run `openclaw doctor`.

**解决方案**：

- 此错误通常不影响正常使用

- 尝试重启OpenClaw服务（多次重启后通常恢复正常）

题外：重启方式对比

- **`openclaw gateway restart`**：完全重启OpenClaw网关服务，先停止再启动，适用于配置变更后需要重启的情况

- **`openclaw gateway`**：仅启动网关服务，不执行停止操作

参考资料

- 1.配置报错参考文档：

https://blog.csdn.net/m0_51545436/article/details/158457976

- 2.飞书插件仓库：

https://github.com/m1heng/clawdbot-feishu

- 3.飞书配置指南：

https://zhuanlan.zhihu.com/p/2014287886124594271