大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。



• 1. 项目概述
• 2. 问题分析
  • 2.1 问题背景
  • 2.2 问题描述
  • 2.3 问题影响
• 3. 解决方案
  • 3.1 修复思路
  • 3.2 具体修复内容
  • 3.3 修复效果
• 4. 使用说明
  • 4.1 快速安装
  • 4.2 安装过程
  • 4.3 撤销修复
• 5. 技术实现细节
  • 5.1 项目结构
  • 5.2 核心模块
  • 5.3 代码实现
• 6. 兼容性说明
• 7. 常见问题
• 8. 作者与许可

---

OpenClaw 飞书图片发送修复工具（openclaw-feishu-media-fixer）是一个专门用于修复 OpenClaw 无法发送图片到飞书的问题的一键式解决方案。

核心功能

• ✅ 一键修复：单条命令即可完成全部修复操作
• ✅ 自动备份：修复前自动创建备份，支持一键回滚
• ✅ 安全恢复：服务重启失败时自动恢复原始代码
• ✅ 版本兼容：针对 OpenClaw 2026.2.x 版本优化

---

2.1 问题背景

OpenClaw 是一个强大的 AI 助手框架，支持多种消息渠道（Channel），包括飞书（Feishu/Lark）。用户可以通过 OpenClaw 与飞书机器人进行交互，发送和接收消息。

然而，在使用飞书渠道发送图片时，发现图片无法正常显示，只能发送文本内容。

2.2 问题描述

经过代码分析，发现问题位于 OpenClaw 飞书扩展的 reply-dispatcher.ts 文件中。

问题定位：deliver 函数只处理 payload.text，没有处理 payload.mediaUrls。

相关代码片段：

问题根源：当 OpenClaw 处理 MEDIA: 语法时，会将媒体文件的 URL 放入 payload.mediaUrls 数组中。但是飞书渠道的 deliver 函数没有读取这个数组，导致图片信息被丢弃。

2.3 问题影响

示例场景：

---

3.1 修复思路

通过在 deliver 函数中添加对 payload.mediaUrls 的处理逻辑，调用 sendMediaFeishu 函数来发送媒体文件。

修复策略： 1. 导入 sendMediaFeishu 函数 2. 在 deliver 函数开头添加媒体发送逻辑 3. 遍历 mediaUrls 数组，逐个发送媒体文件 4. 添加错误处理机制，确保单个媒体发送失败不影响其他消息

3.2 具体修复内容

3.2.1 添加 Import 语句

在 reply-dispatcher.ts 文件顶部添加以下 import：

3.2.2 修改 deliver 函数

在 deliver 函数开头添加媒体发送逻辑：

3.2.3 修复的文件位置

3.3 修复效果

修复后，OpenClaw 可以正确发送图片到飞书：

---

4.1 快速安装

只需执行一条命令即可完成修复：

使用 curl：

GPT plus 代充 只需 145

使用 wget：

4.2 安装过程

脚本会自动完成以下操作：

安装输出示例：

[✓] 检测到 OpenClaw 安装路径: ~/.npm-global/lib/node_modules/openclaw
[✓] 找到目标文件: reply-dispatcher.ts
[✓] 检查通过，需要修复
[✓] 创建备份: /.openclaw-feishu-fixer/backups/reply-dispatcher.ts.backup._
[✓] 应用修复补丁
[✓] 验证修复成功
[✓] 重启 OpenClaw Gateway 服务
[✓] 修复完成！OpenClaw 现在可以发送图片到飞书了。

4.3 安全性保障

4.3.1 自动备份

修复前会自动创建备份文件，存储在：

/.openclaw-feishu-fixer/backups/

备份文件命名格式：

reply-dispatcher.ts.backup.YYYYMMDD_HHMMSS

4.3.2 自动恢复

如果服务重启失败，脚本会自动恢复备份：

[✗] 服务重启失败
[✓] 自动恢复备份
[✓] 原始代码已恢复

4.3.3 版本检查

脚本会检查 OpenClaw 版本兼容性：

[✓] OpenClaw 版本: 2026.2.1 (兼容)

4.4 撤销修复

如果需要撤销修复，恢复原始代码：

步骤 1：找到最新的备份文件

输出示例：

步骤 2：恢复备份

GPT plus 代充 只需 145

步骤 3：重启服务

---

5.1 项目结构

openclaw-feishu-media-fixer/
├── src/
│   ├── commands/          # 命令处理模块
│   │   └── fix.ts         # 修复命令
│   ├── core/              # 核心功能模块
│   │   ├── backup.ts      # 备份管理
│   │   ├── detector.ts    # 问题检测
│   │   └── patcher.ts     # 补丁应用
│   ├── types/             # 类型定义
│   │   └── index.ts       # 类型声明
│   ├── utils/             # 工具函数
│   │   ├── logger.ts      # 日志工具
│   │   └── file.ts        # 文件操作
│   ├── cli.ts             # CLI 入口
│   └── index.ts           # 主入口
├── install.sh             # 一键安装脚本
├── package.json           # 项目配置
├── tsconfig.json          # TypeScript 配置
└── README.md              # 项目说明

5.2 核心模块

5.2.1 问题检测器 (detector.ts)

负责检测 OpenClaw 安装环境和问题状态。

主要功能：

代码示例：

5.2.2 补丁应用器 (patcher.ts)

负责应用修复补丁到目标文件。

主要功能：

代码示例：

5.2.3 备份管理器 (backup.ts)

负责备份文件的创建和管理。

主要功能：

代码示例：

GPT plus 代充 只需 145

5.3 代码实现

5.3.1 主入口 (index.ts)

5.3.2 CLI 入口 (cli.ts)

GPT plus 代充 只需 145

---

6.1 支持的版本

6.2 测试环境

6.3 已知限制

• 目前仅支持 Linux 系统（使用 systemd 管理 OpenClaw 服务）
• 需要 Node.js 18 或更高版本
• 需要具有 OpenClaw 安装目录的写权限

---

Q1: 修复失败怎么办？

A: 修复失败时，脚本会自动恢复备份。你也可以手动恢复：

# 查看备份列表

# 手动恢复

GPT plus 代充 只需 145

Q2: 如何确认修复是否成功？

A: 可以通过以下方式确认：

1. 检查日志输出，确认显示 “修复完成”
2. 向飞书机器人发送图片请求，查看是否能正常显示图片
3. 检查目标文件是否包含 sendMediaFeishu 相关代码

Q3: 支持哪些 OpenClaw 版本？

A: 主要针对 OpenClaw 2026.2.x 版本。其他版本可能需要手动调整。

Q4: 修复后需要重启服务吗？

A: 脚本会自动重启 OpenClaw Gateway 服务，无需手动操作。

Q5: 可以多次运行修复脚本吗？

A: 可以。脚本会检测是否已经修复过，如果已经修复则会跳过。

---

作者信息

• 作者: xixiluo95
• GitHub: https://github.com/xixiluo95
• 项目地址: https://github.com/xixiluo95/openclaw-feishu-media-fixer

许可证

本项目采用 MIT 许可证 开源。

MIT License

Copyright © 2025 xixiluo95

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the “Software”), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

---

如果这个项目对你有帮助，请给 ⭐ Star 支持！