aiping-media（爱平传媒）

AIPing Media Skill

通过 AIPing API 生成图片和视频，完整流程：生成 → 本地下载 → 飞书原生发送，CDN 链接作为备选。

完整工作流

生成图片/视频 → 自动下载到本地 (/tmp/) → 上传飞书 → 发送原生消息
                                              ↓ 失败
                                         返回 CDN 链接

快速上手（新用户从零到跑通）

第一步：安装技能

clawhub install aiping-media

第二步：配置环境变量

在 ~/.openclaw/openclaw.json 的 env 块中添加三个变量。推荐用 CLI 写入，避免手动编辑 JSON：

openclaw config set env.AIPING_API_KEY   "你的AIPing Key"
openclaw config set env.FEISHU_APP_ID    "cli_xxxxxxxxxxxxxxxx"
openclaw config set env.FEISHU_APP_SECRET "你的飞书AppSecret"

获取飞书 AppID / AppSecret：飞书开放平台 → 你的应用 → 凭证与基础信息

验证写入成功：

openclaw config get env.AIPING_API_KEY
openclaw config get env.FEISHU_APP_ID

第三步：重启 Gateway（让 env 变量生效）

openclaw gateway restart

第四步：获取自己的飞书 open_id

以下命令自动用配置中的 AppID/Secret 获取 token，再查询你自己的 open_id（把 你的手机号或邮箱 替换成实际值）：

# 获取 token
TOKEN=$(python3 -c "
import requests, json
with open('$(echo ~/.openclaw/openclaw.json)') as f:
    cfg = json.load(f)
env = cfg['env']
r = requests.post('https://open.feishu.cn/open-apis/auth/v3/tenant_access_token/internal',
    json={'app_id': env['FEISHU_APP_ID'], 'app_secret': env['FEISHU_APP_SECRET']})
print(r.json()['tenant_access_token'])
")

# 按手机号查 open_id（换成你的手机号，含国家码如 +8613800138000）
curl -s "https://open.feishu.cn/open-apis/contact/v3/users/batch_get_id?user_id_type=open_id" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"mobiles": ["你的手机号"]}' | python3 -m json.tool

记下 open_id（格式如 ou_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx），后续测试用。

第五步：一键测试（图片生成 + 飞书发送）

SKILL_DIR=~/.openclaw/workspace/skills/aiping-media

# 生成图片（默认模型 Doubao-Seedream-5.0-lite，~5秒）
IMG_JSON=$(python3 $SKILL_DIR/scripts/generate_image.py "赛博朋克城市夜景，霓虹灯，超写实")
LOCAL_PATH=$(echo $IMG_JSON | python3 -c "import sys,json; print(json.load(sys.stdin)['local_path'])")
echo "图片已下载到: $LOCAL_PATH"

# 发送到飞书（替换 open_id）
python3 $SKILL_DIR/scripts/send_feishu.py image ou_你的open_id $LOCAL_PATH

输出 "success": true 即代表完整链路跑通。

第六步：测试视频生成

SKILL_DIR=~/.openclaw/workspace/skills/aiping-media

# 提交任务（视频生成通常需要 1~3 分钟）
TASK_JSON=$(python3 $SKILL_DIR/scripts/generate_video.py submit Kling-V3-Omni "一只橘猫在草地上打滚，阳光明媚" 5 pro 16:9)
TASK_ID=$(echo $TASK_JSON | python3 -c "import sys,json; print(json.load(sys.stdin)['id'])")
echo "Task ID: $TASK_ID"

# 等待完成并自动下载（轮询，最长等 5 分钟）
VIDEO_JSON=$(python3 $SKILL_DIR/scripts/generate_video.py wait $TASK_ID)
VIDEO_PATH=$(echo $VIDEO_JSON | python3 -c "import sys,json; print(json.load(sys.stdin).get('local_path',''))")
echo "视频已下载到: $VIDEO_PATH"

# 发送到飞书（群聊用 chat_id）
python3 $SKILL_DIR/scripts/send_feishu.py video oc_群聊ID $VIDEO_PATH chat_id

在 Agent 代码中调用

图片生成 + 飞书发送

from scripts.generate_image import generate_image
from scripts.send_feishu import send_image

# 1. 生成（自动下载到本地）
img = generate_image(
    model="Kling-V1",
    prompt="未来城市夜景，赛博朋克风格",
    negative_prompt="低质量，模糊"
)
local_path = img.get("local_path")  # 自动下载路径

# 2. 发送飞书
if local_path:
    # 发送给用户（默认 open_id）
    result = send_image(token=None, receive_id="ou_xxx", source=local_path)
    # 或发送到群聊（指定 chat_id）
    result = send_image(token=None, receive_id="oc_xxx", source=local_path, receive_id_type="chat_id")
    if result.get("success"):
        print(f"飞书 image_key: {result.get('image_key')}")
    else:
        print(f"失败: {result.get('error')}")
        print(f"CDN链接: {result.get('cdn_url')}")

视频生成 + 飞书发送

from scripts.generate_video import generate_video, wait_for_video
from scripts.send_feishu import send_video

# 1. 提交任务
video = generate_video(
    model="Kling-V3-Omni",
    prompt="一只猫咪在草地上玩耍",
    seconds=5,
    mode="pro",
    aspect_ratio="1:1"
)
task_id = video["id"]

# 2. 等待完成（自动下载）
result = wait_for_video(task_id)
local_path = result.get("local_path")

# 3. 发送到群聊
if local_path:
    result = send_video(token=None, receive_id="oc_xxx", source=local_path, receive_id_type="chat_id")

推荐模型

图片

视频

脚本命令行用法

generate_image.py

python3 scripts/generate_image.py <prompt> [model] [negative_prompt] [image_url] [aspect_ratio] [nodownload]

generate_video.py

# 提交任务
python3 scripts/generate_video.py submit <model> <prompt> [seconds] [mode] [aspect_ratio]
# 等待完成（自动下载）
python3 scripts/generate_video.py wait <task_id>
# 查询状态
python3 scripts/generate_video.py query <task_id>

send_feishu.py

# 图片（本地文件或 CDN URL）
python3 scripts/send_feishu.py image <receive_id> <file_or_url> [receive_id_type]
# 视频（本地文件或 CDN URL）
python3 scripts/send_feishu.py video <receive_id> <file_or_url> [receive_id_type]

关键参数 receive_id_type（默认 open_id，易踩坑！）：

⚠️ 群聊必须用 chat_id，不能拿用户的 open_id 发到群里，否则返回 400 Bad Request

示例：

# 发送给用户（默认 open_id）
python3 scripts/send_feishu.py image ou_xxxxxxxx /tmp/a.jpg

# 发送到群聊（指定 chat_id）
python3 scripts/send_feishu.py image oc_xxxxxxxx /tmp/a.jpg chat_id

飞书上传接口详解（踩坑经验汇总）

图片上传 vs 视频上传（对比）

| | 图片 | 视频 | |--|------|------| | 上传接口 | POST /im/v1/images | POST /im/v1/files | | 参数传递方式 | multipart/form-data（-F） | multipart/form-data（-F） | | 必需参数 | image_type=message | file_type=mp4 + file_name=xxx.mp4 | | 返回值 key | image_key | file_key | | 发送时 msg_type | image | media | | content 格式 | {"image_key": "xxx"} | {"file_key": "xxx", "type": "video"} |

完整 curl 示例（图片）

# 1. 获取 token
TOKEN=$(curl -s -X POST "https://open.feishu.cn/open-apis/auth/v3/tenant_access_token/internal" \
  -H "Content-Type: application/json" \
  -d '{"app_id": "cli_xxx", "app_secret": "xxx"}' | python3 -c "import sys,json;print(json.load(sys.stdin)['tenant_access_token'])")

# 2. 上传图片
IMAGE_KEY=$(curl -s -X POST "https://open.feishu.cn/open-apis/im/v1/images" \
  -H "Authorization: Bearer $TOKEN" \
  -F "image_type=message" \
  -F "image=@/tmp/image.jpg" | python3 -c "import sys,json;print(json.load(sys.stdin)['data']['image_key'])")

# 3. 发送图片
curl -s -X POST "https://open.feishu.cn/open-apis/im/v1/messages?receive_id_type=chat_id" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d "{\"receive_id\": \"oc_xxx\", \"msg_type\": \"image\", \"content\": \"{\\"image_key\\": \\"$IMAGE_KEY\\"}\"}"

完整 curl 示例（视频）

# 1. 获取 token
TOKEN=$(curl -s -X POST "https://open.feishu.cn/open-apis/auth/v3/tenant_access_token/internal" \
  -H "Content-Type: application/json" \
  -d '{"app_id": "cli_xxx", "app_secret": "xxx"}' | python3 -c "import sys,json;print(json.load(sys.stdin)['tenant_access_token'])")

# 2. 上传视频（注意：file_type 必须是 "mp4"，不是 "video/mp4"！）
FILE_KEY=$(curl -s -X POST "https://open.feishu.cn/open-apis/im/v1/files" \
  -H "Authorization: Bearer $TOKEN" \
  -F "file_type=mp4" \
  -F "file_name=video.mp4" \
  -F "file=@/tmp/video.mp4" | python3 -c "import sys,json;print(json.load(sys.stdin)['data']['file_key'])")

# 3. 发送视频（msg_type 是 "media"，content 里 type 是 "video"）
curl -s -X POST "https://open.feishu.cn/open-apis/im/v1/messages?receive_id_type=chat_id" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d "{\"receive_id\": \"oc_xxx\", \"msg_type\": \"media\", \"content\": \"{\\"file_key\\": \\"$FILE_KEY\\", \\"type\\": \\"video\\"}\"}"

飞书上传最容易踩的坑

注意事项

1. env 变量必须配置：技能脚本从 AIPING_API_KEY / FEISHU_APP_ID / FEISHU_APP_SECRET 读取凭证，未配置时调用函数会抛 EnvironmentError
2. 重启 gateway 后才生效：修改 openclaw.json 的 env 块后必须 openclaw gateway restart
3. 本地文件限制 /tmp/：send_feishu.py 只允许读取 /tmp/ 下的本地文件，生成脚本默认也写入 /tmp/
4. 自动 MIME 检测：根据文件扩展名自动识别 PNG/JPEG/GIF/MP4
5. 视频生成需要耐心：视频任务提交后 status 为 queued，需要等待 1~3 分钟才能完成，用 wait 命令轮询查询
6. 上传接口不能混用：图片必须用 /im/v1/images，视频必须用 /im/v1/files，两者接口不同

常见错误排查