| name | cogview-image-gen |
| description | 智谱 CogView-4 文生图技能。支持中英双语提示词，支持汉字生成，可自定义分辨率。通过智谱开放平台 API 调用。 |
CogView-4 文生图技能
基于智谱 AI CogView-4 模型的文生图能力。支持中英双语输入，原生中文语义理解，能在图片中生成汉字。
模型信息
- 模型名称： CogView-4
- 参数量： 60 亿
- 输入： 中英双语文本提示词
- 输出： 图片（默认 1024×1024）
- 价格： ~0.1 元/张
- 特点： 支持图片中生成中文字符
API 配置
API Key 从 OpenClaw 配置文件中自动读取（与 GLM 模型共用同一个 Key）：
~/.openclaw/openclaw.json
models.providers.qtcool.apiKey
无需额外配置环境变量。
使用方式
方式一：直接调用 API（推荐）
使用 exec 工具执行 shell 命令调用脚本：
bash skills/cogview-image-gen/scripts/generate.sh "一只可爱的橘猫" output.png
bash skills/cogview-image-gen/scripts/generate.sh "山水画风格" output.png --size 768x1344
bash skills/cogview-image-gen/scripts/generate.sh "城市夜景" /tmp/my-image.png
方式二：curl 直接调用
API_KEY=$(python3 -c "import json; print(json.load(open('$HOME/.openclaw/openclaw.json'))['models']['providers']['qtcool']['apiKey'])")
curl -s --max-time 120 \
"https://open.bigmodel.cn/api/paas/v4/images/generations" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $API_KEY" \
-d '{
"model": "cogview-4",
"prompt": "你的提示词",
"size": "1024x1024"
}'
支持的分辨率
| 尺寸 | 比例 | 适用场景 |
|---|
| 1024×1024 | 1:1 | 通用、头像、社交媒体 |
| 768×1344 | 9:16 | 手机壁纸、海报 |
| 864×1152 | 3:4 | 竖版海报 |
| 1344×768 | 16:9 | 横版海报、封面 |
| 1152×864 | 4:3 | PPT 封面、文档配图 |
| 1440×720 | 2:1 | 横幅、Banner |
提示词技巧
- 中文优先： CogView-4 对中文理解最好，建议用中文描述
- 风格明确： 加上风格关键词（水彩画、油画、3D 渲染、扁平设计等）
- 细节丰富： 描述越具体，生成效果越好
- 负面提示： 暂不支持 negative_prompt
- 中文文字： 直接在 prompt 中写要生成的文字内容
错误处理
| 错误 | 原因 | 解决 |
|---|
| 余额不足 | 账户没额度 | 去 open.bigmodel.cn 充值 |
| 模型不存在 | API 地址错误 | 检查 endpoint |
| 请求超时 | 网络问题 | 检查服务器网络 |
| 图片下载失败 | URL 过期 | 重新生成（URL 有效期 1 小时） |
图片发送到飞书
生成图片后，使用 message 工具发送：
message(action=send, media="/path/to/image.png", message="描述文字")
生成后清理
图片默认保存到 workspace/media/generated/ 目录。定期清理旧文件：
find workspace/media/generated/ -name "*.png" -mtime +7 -delete
