云部署Openclaw龙虾接入飞书PPT问题

目录

一、先手动拿文件（应急）

二、让龙虾直接发文件（推荐，一劳永逸）

[1. 给龙虾加指令（最简单）](#1. 给龙虾加指令（最简单）)

[2. 检查飞书权限（必须开）](#2. 检查飞书权限（必须开）)

[3. 配置云服务器白名单（彻底解决）](#3. 配置云服务器白名单（彻底解决）)

三、测试发送（验证是否成功）

四、新手避坑（必看）

---

一、先手动拿文件（应急）

1. 复制龙虾返回的云服务器路径（如 /root/.openclaw/workspace/xxx.pptx）
2. 用 FinalShell/Xshell 远程登录云服务器
3. 输入命令下载文件到你电脑（Windows 示例）：

命令行运行

# 从云服务器下载到本地桌面
scp root@你的服务器IP:/root/.openclaw/workspace/xxx.pptx C:\Users\你的用户名\Desktop

1. 手动发到飞书自己用

二、让龙虾直接发文件（推荐，一劳永逸）

1. 给龙虾加指令（最简单）

下次让龙虾做 PPT 时，必须加这一句：

帮我做 XX 主题 PPT，做完后保存到.openclaw/workspace 目录，用 --media 参数发给我

2. 检查飞书权限（必须开）

1. 飞书开放平台 → 你的应用 → 权限管理
2. 批量导入权限（复制粘贴）：

json

{"scopes":{"tenant":["im:resource","im:message:send_as_bot","contact:contact.base:readonly"]}}

1. 去版本管理 → 发布新版本（选 "部分成员"+ 你自己，不用审核）

3. 配置云服务器白名单（彻底解决）

1. 远程登录服务器，编辑配置：

命令行运行

nano ~/.openclaw/openclaw.json

1. 在 agents.defaults 里加一行（Linux 路径）：

json：

"mediaLocalRoots": ["/root/.openclaw/workspace"]

1. 保存退出（按 Ctrl+O → 回车 → Ctrl+X）
2. 重启 OpenClaw：

bash

运行

openclaw restart

三、测试发送（验证是否成功）

在飞书 @龙虾，发指令：

帮我生成一个测试 PPT，保存到.openclaw/workspace，然后用 --media 发给我

正常会直接收到可打开的 PPT 文件，不再是路径。

四、新手避坑（必看）

• 文件名必须英文 ：中文会被飞书识别成路径 / 快捷方式（如 report.pptx 而非 报告.pptx）
• 文件大小≤30MB：飞书默认限制，超了发不出去
• 必须用 --media：龙虾默认只发文本，加这个参数才会发文件
• 重启生效 ：改配置后一定要 openclaw restart