夜雨聆风作者: 曹曹发布时间: 2026-03-22适用场景: OpenClaw 本地部署 + 飞书集成
📋 问题描述
今天下午遇到一个棘手的问题：我在飞书中发送图片给 OpenClaw，但它无法查看，一直返回 400 错误。
具体表现:
- 发送飞书图片后，OpenClaw 无法读取内容
feishu_im_bot_image工具返回 400 错误feishu_im_user_fetch_resource工具也返回 400 错误- 文字消息正常，只有图片无法查看
影响: 严重影响工作效率，无法处理图片内容！当时真的很郁闷。😤
🔍 问题诊断
第 1 步：检查 Gateway 状态
我在本地 PowerShell 运行：
openclaw gateway status
发现问题:
Service: Scheduled Task (registered)
Runtime: unknown (Task status is stopped)
ERROR: The system cannot find the file specified.
结论: Gateway 服务未运行！❌
第 2 步：理解 Gateway 的作用
Gateway 是 OpenClaw 的核心服务，负责：
- ✅ 插件工具调用（包括飞书图片下载）
- ✅ API 请求转发
- ✅ 本地服务监听（默认 127.0.0.1:18789）
Gateway 未运行的后果:
- 飞书图片下载工具失败（400 错误）
- 其他需要 Gateway 的工具也无法使用
- OpenClaw 只能处理基础功能
🛠️ 解决方案
第 1 步：安装 Gateway 服务
在本地 PowerShell 运行（需要管理员权限）：
openclaw gateway install
输出示例:
[openclaw] Gateway service installed successfully
Service file: ~\.openclaw\gateway.cmd
Service env: OPENCLAW_GATEWAY_PORT=18789
第 2 步：启动 Gateway 服务
openclaw gateway start
输出示例:
Gateway started successfully
Listening: 127.0.0.1:18789
RPC probe: ok
第 3 步：验证服务状态
openclaw gateway status
成功状态:
Service: Scheduled Task (registered)
Runtime: Ready (Task status is running)
Gateway: bind=loopback (127.0.0.1), port=18789
RPC probe: ok
Listening: 127.0.0.1:18789
✅ 完成！Gateway 已正常运行！
🎉 问题验证
测试图片查看
- 在飞书中发送一张测试图片
- OpenClaw 能够正常读取了
- 查看图片内容并回复
技术流程:
我发图片到飞书
↓
飞书存储图片并生成 file_key
↓
Gateway 服务调用 feishu_im_bot_image 下载
↓
下载到本地：C:\Users\Administrator\.openclaw\media\inbound\*.webp
↓
OpenClaw 用 read 工具查看图片
↓
成功！✅
💡 备用方案：直接读取本地文件
如果 Gateway 服务正常但图片下载工具仍失败，可以直接用
read 工具读取本地文件：图片存储路径:
C:\Users\Administrator\.openclaw\media\inbound\*.webp
使用方法:
read 工具 → 读取本地 webp 文件
优点:
- ✅ 不依赖飞书 API 下载工具
- ✅ 文件已自动保存到本地
- ✅ 直接读取，简单快速
缺点:
- ❌ 需要知道文件路径
- ❌ 需要手动查找最新文件
📊 问题对比
项目 | 问题状态 | 解决后 |
|---|---|---|
Gateway 服务 | stopped（ERROR） | running（Ready） |
图片下载工具 | 400 错误 | 正常下载 |
图片查看 | 无法查看 | 正常查看 |
RPC 探测 | 失败 | ok |
监听端口 | 无 | 127.0.0.1:18789 |
⚠️ 常见问题 FAQ
Q1: 为什么 Gateway 服务会停止？
我的分析:
- 系统重启后未自动启动
- Gateway 服务未正确安装
- 系统更新导致服务配置丢失
- 端口冲突（18789 被占用）
预防措施:
- 定期检查 Gateway 状态
- 设置开机自启动
- 避免手动修改 Gateway 配置
Q2: 安装 Gateway 需要管理员权限吗？
需要！ 因为 Gateway 服务是 Windows 计划任务，需要管理员权限创建。
以管理员身份运行 PowerShell:
- 按
Win + X - 选择"Windows PowerShell (管理员)"
- 或按
Win + S搜索"PowerShell"，右键选择"以管理员身份运行"
Q3: Gateway 安装失败怎么办？
我遇到的错误:
ERROR: The system cannot find the file specified.
解决方法:
- 确认 OpenClaw 已正确安装
- 检查
~\.openclaw\目录是否存在 - 重新安装 OpenClaw
- 查看 Gateway 日志：
openclaw gateway logs --tail 50
Q4: 端口冲突怎么办？
检查端口占用:
netstat -ano | findstr "18789"
解决方法:
- 关闭占用端口的程序
- 或修改 Gateway 端口：
- 重启 Gateway 服务
Q5: 云端 OpenClaw 也适用吗？
不完全适用。云端 OpenClaw 的 Gateway 服务由云服务商管理，用户无法直接操作。
云端用户建议:
- 联系云服务商检查 Gateway 状态
- 或采用本地读取 + 云端处理方案
- 或检查飞书 OAuth 授权状态
🔧 高级诊断命令
查看 Gateway 日志
# 查看最近 50 条日志
openclaw gateway logs --tail 50
# 实时查看日志
openclaw gateway logs --follow
重启 Gateway 服务
# 停止服务
openclaw gateway stop
# 启动服务
openclaw gateway start
# 或直接重启
openclaw gateway restart
检查飞书配置
openclaw configure --section feishu
检查项:
- 飞书 App ID 和 App Secret
- 飞书 OAuth 授权状态
- 飞书机器人配置
📝 总结
问题根源
Gateway 服务未运行，导致飞书图片下载工具失败。
解决步骤
- 检查状态:
openclaw gateway status - 安装服务:
openclaw gateway install - 启动服务:
openclaw gateway start - 验证状态:
openclaw gateway status
我的经验
- ✅ Gateway 是 OpenClaw 的核心服务
- ✅ 图片下载工具依赖 Gateway
- ✅ 安装需要管理员权限
- ✅ 备用方案：直接读取本地文件
🦞 后记
这个问题困扰了我一下午，最后发现是 Gateway 服务未运行。写这篇文章是希望帮助遇到同样问题的朋友，少走弯路。
我的几点体会:
- 遇到问题先检查基础服务状态，不要一上来就查复杂配置
- Gateway 日志是诊断的重要依据，学会看日志很重要
- 本地文件读取是可靠的备用方案，关键时刻能顶上
如果这篇文章对你有帮助，欢迎转发分享！ 🚀
📎 附录：相关资源
- OpenClaw 官方文档：https://docs.openclaw.ai
- OpenClaw GitHub: https://github.com/openclaw/openclaw
- 飞书开放平台：https://open.feishu.cn
- 问题讨论区：https://discord.gg/clawd
本文基于我的真实问题解决过程整理 | 2026-03-22如有问题，欢迎在评论区讨论！
