前言¶
在对话里直接出图，常见做法是单独写脚本调开放平台，再把链接贴回聊天。每次换尺寸、开关水印都要改参数或查文档，和 Agent 的工作流也容易脱节。下面介绍 SkillHub 上的社区 Skill「智谱glm-image生图」：装好并配置智谱 API Key 后，由 Agent 按统一工具接口调用 GLM-Image，支持多种画幅比例与水印开关。
这是什么¶
「智谱glm-image生图」是遵循通用 SKILL.md 格式的 Agent Skill，坐标为 @user_c5e5dc86/zhipu-image，当前版本 1.0.0，来源为 community，分类为 design-media。Skill 包内说明其面向 OpenClaw 生态（skill.json 要求 OpenClaw >= 4.10.0、Python >= 3.8），通过智谱开放平台的 GLM-Image 模型完成文本到图像生成。发布者在 SkillHub 为 user_c5e5dc86，技能作者署名为 skill大神。
官方入口：
- SkillHub 页面：https://www.skillhub.cn/skills/user_c5e5dc86/zhipu-image
- API 坐标页：https://api.skillhub.cn/user_c5e5dc86/zhipu-image
核心功能¶
根据 Skill 说明与 skill.json，已核实能力包括：
- 调用模型
glm-image，默认画质为hd（实现中写死为 GLM-Image 支持的 hd 质量）。 - 工具名
zhipu_generate_image，必填参数prompt（文本描述）；可选size、watermark。 - 七种预设尺寸：1280x1280、1568×1056、1056×1568、1472×1088、1088×1472、1728×960、960×1728；默认 1280x1280。
- 水印默认开启（
watermark默认 true）；关闭水印需在智谱平台先签署免责声明（Skill 文档中的说明）。 - 成功调用后返回图片链接；文档注明临时链接有效期约 30 天，需自行转存。
- 标签
requires_api_key=true：须在技能配置或环境变量中提供智谱 API Key。
HTTP 调用端点为 https://open.bigmodel.cn/api/paas/v4/images/generations（见技能包内 generate_image.py）。
安装与启用¶
先做 CLI 检查；未安装时按 SkillHub 官方安装文档执行完整安装或仅 CLI：
command -v skillhub && skillhub --version
# 完整安装（CLI + 默认 Skill，推荐）
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
# 仅安装 CLI
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
安装本 Skill 时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/ 且可能不被识别。SkillHub 页面给出的安装提示为：依据 https://skillhub.cn/install/skillhub.md，安装 @user_c5e5dc86/zhipu-image。命令行等价示例：
skillhub install zhipu-image --namespace user_c5e5dc86 --dir ~/.cursor/skills/
Cursor 常用路径为 ~/.cursor/skills/；Claude Code 为 ~/.claude/skills/；Codex 为 ~/.codex/skills/ 或项目下 .agents/skills/（路径来自 SkillHub 安装文档，按你实际使用的客户端选择）。
配置 API Key 有两种方式（技能包文档）：
- 在技能配置中填写字段
api_key（skill.json中required: true）。 - 环境变量
ZHIPU_IMAGE_API_KEY（generate_image.py与USAGE_EXAMPLE.md）。
Key 获取地址：https://bigmodel.cn/usercenter/proj-mgmt/apikeys ；需先在 https://bigmodel.cn/ 注册并保证账户有足够调用额度。
若技能依赖 Python 包，可在技能目录内按 requirements.txt 安装依赖（包内包含 requests 等）。
典型用法¶
在支持 OpenClaw 工具的对话里¶
Skill 文档中的斜杠命令形式：
/zhipu_generate_image 一只可爱的小猫咪，坐在阳光明媚的窗台上，背景是蓝天白云
自定义尺寸（注意文档中使用 × 或 x 书写宽高）：
/zhipu_generate_image 赛博朋克风格的城市夜景，霓虹灯闪烁，下雨的街道 size=1728×960
关闭水印：
/zhipu_generate_image 水彩风格的风景画，山川河流，日出 watermark=false
README 中还提供封装命令示例（需技能安装后的命令是否在 PATH 取决于宿主环境）：
zhipu_generate_image "一只可爱的小猫咪，坐在阳光明媚的窗台上"
zhipu_generate_image "赛博朋克风格的城市夜景" size=1728×960
zhipu_generate_image "水彩风格的风景画" watermark=false
直接运行技能包脚本¶
在技能目录下可用 generate_image.py 做本地验证（需已设置 ZHIPU_IMAGE_API_KEY）：
python generate_image.py "一只可爱的橘猫，躺在阳光下的地毯上，毛茸茸的，治愈系风格"
JSON 参数方式：
python generate_image.py '{"prompt": "未来科技感的人工智能机器人，银白色金属质感，蓝色眼睛，背景是数据中心", "size": "1568×1056", "watermark": true}'
成功时返回 JSON，字段包含 success、image_url、prompt、size 等（见 USAGE_EXAMPLE.md 示例结构）。
适用场景与注意¶
适合需要在 OpenClaw 或兼容 SKILL 工具的 Agent 里快速接入智谱文生图、且希望统一用 prompt / size / watermark 三参控制的开发者。SkillHub 侧统计（抓取时）：评分 100000，下载 1244，安装 3。
使用时注意：
- 内容需符合智谱开放平台内容安全政策；违规 prompt 会导致失败。
- 尺寸需满足文档要求：长宽为 32 的整数倍，像素总数不超过 2^22。
- 费用按智谱开放平台计费标准收取，与本 Skill 无关。
- 本 Skill 为社区发布（community），与智谱官方无直接维护关系；问题排查可先查 API Key、额度与 prompt，再结合返回错误信息。
结尾¶
「智谱glm-image生图」把 GLM-Image 封装成 Agent 可调用的 zhipu_generate_image，配置 Key 后即可在对话或脚本里生成多尺寸图片并控制水印。需要安装或查看说明时，以 SkillHub 官方页为准：https://www.skillhub.cn/skills/user_c5e5dc86/zhipu-image
