• Generate images from text descriptions / 从文字描述生成图片
• Create AI art, illustrations, or concept art / 创作 AI 艺术、插画或概念图
• User mentions "生图", "文生图", "AI 绘画", "generate image", "text-to-image", "create image"
• User provides a prompt and wants to see it visualized / 用户提供描述并想看到可视化效果

• High-quality generation: HD mode produces more detailed, refined images (~20s)
• Multiple aspect ratios: Square, portrait, landscape formats supported
• GLM-Image model: Latest model with improved understanding and quality
• Excellent at: Scientific illustrations (科普插画), high-quality portraits (高质量人像), social media graphics (社交媒体图文), commercial posters (商业海报)
• Watermark control: Enable/disable watermarks (requires signed disclaimer for no-watermark)
• Content safety: Built-in content filtering for compliance

ZHIPU_API_KEY

ZHIPU_API_KEY

1. Global config (recommended) / 全局配置（推荐）： Set once in

   openclaw.json

   under

   env.vars

   , all Zhipu skills will share it:
   json

   {
     "env": {
       "vars": {
         "ZHIPU_API_KEY": "你的密钥"
       }
     }
   }

2. Skill-level config / Skill 级别配置： Set for this skill only in

   openclaw.json

   :
   json

   {
     "skills": {
       "entries": {
         "glm-image-generation": {
           "env": {
             "ZHIPU_API_KEY": "你的密钥"
           }
         }
       }
     }
   }

3. Shell environment variable / Shell 环境变量： Add to

   ~/.zshrc

   :
   bash

    export ZHIPU_API_KEY="你的密钥"
   

💡 如果你已为其他智谱 skill（如

glmocr

、

glmv-caption

）配置过 key，它们共享同一个

ZHIPU_API_KEY

，无需重复配置。

• Environment variables used / 使用的环境变量：

  • ZHIPU_API_KEY

    (required / 必需)
• Fixed endpoint / 固定官方端点：

  https://open.bigmodel.cn/api/paas/v4/images/generations

• No custom API URL override / 不支持自定义 API URL 覆盖： avoids accidental key exfiltration via redirected endpoints.

1. ONLY use GLM-Image API — Execute the script

   python scripts/glm_image_cli.py

2. NEVER generate images yourself — Do NOT try to create images using built-in vision or any other method
3. NEVER offer alternatives — Do NOT suggest "I can try to describe it" or similar
4. IF API fails — Display the error message and STOP immediately
5. NO fallback methods — Do NOT attempt image generation any other way

• Show the generated image URL(s) — images are temporary (30 days), remind user to save
• Display the prompt used and generation parameters (size, quality)
• If content_filter indicates issues, show the warning level

1. Show the image — Use the URL to display the image in the chat (if platform supports it)
2. Remind user to save — "图片链接有效期 30 天，请及时下载保存"
3. Offer to send to Feishu — If user wants the image sent to a Feishu chat, use the message tool with the image URL

• Width and height: 1024px - 2048px
• Both dimensions must be multiples of 32 / 长宽均需为 32 的整数倍
• Maximum total pixels: 2^22 (4,194,304 px) / 最大像素数不超过 2^22

{
  "created": 123,
  "data": [
    {
      "url": "<string>"
    }
  ],
  "content_filter": [
    {
      "role": "assistant",
      "level": 1
    }
  ]
}

{
  "ok": true,
  "model": "glm-image",
  "image_url": "https://open.bigmodel.cn/.../generated_image.png",
  "prompt": "一只可爱的小猫咪，坐在阳光明媚的窗台上，背景是蓝天白云",
  "size": "1280x1280",
  "quality": "hd",
  "created": 1710835200,
  "content_filter": [
    {
      "role": "assistant",
      "level": 3
    }
  ],
  "saved_file": "/Users/xxx/image.png",
  "error": null
}

• ok

  — whether generation succeeded

• model

  — model used for generation

• image_url

  — extracted from

  data[0].url

  , temporary URL (valid 30 days)

• prompt

  — the text prompt used

• size

  — generated image dimensions

• quality

  — hd or standard

• created

  — Unix timestamp when request was created

• content_filter

  — content safety analysis array (may be empty)

  • role

    : where the issue was detected (user/assistant/history)

  • level

    : severity 0-3 (0 = most severe, 3 = minor)

• saved_file

  — absolute path to saved local file (if

  --save

  was used)

• error

  — error details on failure

content_filter

• role

  : where the issue was detected (user/assistant/history)

• level

  : severity 0-3 (0 = most severe, 3 = minor)

• Specific details: "一只橘色的英国短毛猫，绿色眼睛，坐在木质窗台上"
• Style keywords: "赛博朋克风格", "中国水墨画", "油画质感", "3D 渲染"
• Lighting: "阳光明媚", "柔和的逆光", "电影感灯光"
• Composition: "特写镜头", "广角视角", "俯视角度"

• Vague descriptions: "好看的图片"
• Contradictory elements: "白天和夜晚同时"
• Too many subjects: Keep focus on 1-2 main elements