Huajing 图像生成

安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install huajing-image-gen
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 huajing-image-gen。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

Huajing 图像生成可将 AI 编程代理连接到本地运行的 Huajing（AI Image Studio）服务器，根据文本提示词创建图像。配置自己的图像模型服务提供商，选择提供商和模型选项，设置图像尺寸和批量数量，还可选择添加负面提示词。
此技能还支持润色粗略提示词和搜索 Huajing 本地图像图库，方便完善创意，也能重新查看先前结果而无需重新生成。作为用于图像创作的 Openclaw Skills 之一，它让图像生成始终连接到你自己的 Huajing 设置及其可审计的本地图库。

应用场景

根据自然语言提示词生成图像并等待结果。
选择尺寸后，一批生成一至四张图像。
选择已配置的特定提供商，或覆盖其默认图像模型。
添加负面提示词，引导图像生成避开不想要的元素。
使用提供商的提示词模型，将简短或粗略的提示词扩展为更丰富的提示词。
搜索本地图库，查找并重新使用以前生成的图像。
判断生成问题是由 Huajing 服务器无法访问还是上游提供商错误导致。

工作原理

使用 health 命令检查本地 Huajing 服务器是否可访问。
生成图像时，提交必填提示词，并可选设置尺寸、数量、提供商、模型、负面提示词和超时。
CLI 将请求发送到 Huajing，并在内部轮询，直到生成完成或失败。
从 stdout 读取 JSON 格式的结果；面向用户的诊断信息会写入 stderr。使用 --plain 可输出便于阅读的命令结果。
要完善提示词，请使用粗略提示词和提供商调用 polish。
要重新查看以往作品，请使用 gallery，并可选指定查询词和结果上限。

配置指南

安装 Node.js 18 或更高版本并启动 Huajing 服务器。每台机器只启动一个 Huajing 实例。
在 Huajing 的 Service & Models 页面中，至少配置一个图像提供商，并填写其 base URL、API key 和图像模型。
如有需要，设置可选环境变量：HUAJING_BASE_URL 用于更改服务器 URL（默认值：http://127.0.0.1:4173）；HUAJING_DATA_DIR 指向 Huajing 的 data/ 目录，并使结果包含本地文件的绝对路径。
从技能已安装的基础目录运行脚本：
node {baseDir}/scripts/huajing.mjs health
node {baseDir}/scripts/huajing.mjs generate
--prompt "a tiny red paper crane on a wooden desk, soft window light"
--size 1024x1024 --count 1 --timeout 300 node {baseDir}/scripts/huajing.mjs polish
--prompt "一只纸鹤" --provider node {baseDir}/scripts/huajing.mjs gallery --limit 5 --query "crane"
generate 命令必须指定 --prompt。可选标志包括 --size（WxH；默认值为 1024x1024）、--count（1–4）、--provider（ID 或不区分大小写的名称）、--model、--negative、--timeout（秒；默认值为 300）和 --plain。成功时退出代码为 0，生成失败时为 1，服务器无法访问时为 2，用法错误时为 3。如果服务器无法访问，请在 Windows 上使用 start.bat 启动 Huajing，或在 Huajing 代码库中运行 npm start。

数据架构

此技能通过 CLI 命令与 Huajing 通信，默认将 JSON 输出到 stdout；诊断信息写入 stderr。上游提供商导致的生成错误会包含在 JSON 的 error 字段中。图库由 Huajing 管理，并会保留生成的图像以供日后查找。
数据或设置 用途
提示词 描述要生成图像的必填文本；也用作提示词润色的输入。
尺寸 请求的图像尺寸，格式为 WxH；默认值为 1024x1024。
数量 要生成的图像数量，范围为 1 至 4。
提供商和模型 选择已配置的图像提供商，并可选择覆盖其默认图像模型。
负面提示词 可选的指导内容，用于说明应避免的元素。
图库查询和上限 筛选先前生成的图像，并控制返回结果的数量。
HUAJING_BASE_URL 可选的 Huajing 服务器 URL 覆盖值；默认值为 http://127.0.0.1:4173。
HUAJING_DATA_DIR 可选的 Huajing 数据目录路径；设置后，结果会包含本地文件的绝对路径，而不只是 HTTP URL。

高级特性

在内部轮询生成请求，使命令可以等待图像生成完成；等待时间受可配置超时限制。
支持一次生成一至四张图像，并可明确指定图像尺寸。
用户可通过 ID 或不区分大小写的名称选择已配置的提供商，也可覆盖提供商的默认模型。
通过已配置提供商的提示词模型润色提示词。
搜索持久化的本地图库，取回先前生成的图像，无需再次创建。
通过退出代码 0、1、2 和 3 区分成功、提供商或生成失败、服务器不可用以及无效用法。
支持用于自动化的 JSON 输出，并提供 --plain 选项以输出便于阅读的内容。

name: huajing-image-gen description: >- Generate images through a local Huajing (AI Image Studio) server. Use when
the user asks to create or generate an image, polish an image prompt, or
look up previously generated images. Supports text-to-image with polling,
batch count, size, negative prompt, and provider/model selection. Requires
the local Huajing server (default http://127.0.0.1:4173) and Node 18+.