什么是 Materials CLI？

Materials CLI 是一款高性能技术工具，旨在将结构化 JSON 数据转换为高质量视觉资产。通过使用 declare-render 格式，它允许对图层、文本和形状进行精确的程序化控制。作为 Openclaw Skills 生态系统的一部分，该工具弥合了原始数据与视觉呈现之间的鸿沟，使 AI 智能体和开发者能够直接从命令行生成 PNG 或 JPG 文件。对于需要自动化视觉工作流或在生产前验证渲染模式的用户来说，它尤为强大。

下载入口:https://github.com/openclaw/skills/tree/main/skills/cai-zhuo/materials-cli

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

2. 手动安装

将技能文件夹复制到以下位置之一

优先级：工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

Materials CLI 应用场景

• 从结构化 JSON 数据模式创建视觉资产或横幅。
• 通过 AI 使用自然语言描述原型化 UI 布局和形状。
• 在开发流水线中自动化渲染模式的验证。
• 使用程序化模板为应用程序生成动态图像内容。

1. 输入接收：该工具接受 JSON 模式文件路径或自然语言文本提示。
2. AI 模式生成：如果提供了提示，该工具将利用 OpenAI 将描述翻译成有效的 declare-render 模式。
3. 验证：CLI 根据强制性数据模式验证 JSON 结构，以确保渲染兼容性。
4. 图像渲染：引擎处理模式中定义的图层、坐标和样式。
5. 导出：最终结果将渲染并保存为指定输出路径下的 PNG 或 JPG 文件。

Materials CLI 配置指南

要将此工具集成到您的环境中并扩展您的 Openclaw Skills 能力，请通过 Node.js 安装：

npm install -g materials-cli

在使用 AI 生成功能之前，请设置您的 API 密钥环境变量：

export OPENAI_API_KEY='your-api-key-here'

Materials CLI 数据架构与分类体系

Materials CLI 的所有渲染操作均遵循 declare-render 数据格式。模式结构包括：

您可以使用 validate 命令来确保您的 JSON 文件符合此分类法。

name: materials-cli
description: Render JSON schemas to images and generate schemas from prompts using declare-render and AI.
version: 1.0.8
metadata:
  clawdbot:
    requires:
      env:
        - OPENAI_API_KEY
      bins:
        - node
    primaryEnv: OPENAI_API_KEY

Materials CLI

Use this skill when the user wants to render JSON schemas to images (PNG/JPG), validate render-data schemas, or generate schemas from natural-language prompts and then render them.

Commands

• render — Render a JSON schema file to an image.
• generate — Use AI (OpenAI) to generate a schema from a prompt, then render it.
• validate — Validate a JSON schema against the declare-render data schema.

When to use

• User asks to "render a schema to image", "turn JSON into a picture", or "draw from schema".
• User wants to "generate an image from a description" or "create a schema from a prompt" and render it.
• User wants to "validate" a JSON file against the render data schema.

Usage

Run via Node (from the project or after npm install -g materials-cli):

materials render  [options]
materials generate "" [options]
materials validate  [options]

Render

• materials render schema.json -o output.png
• Options: -s, --schema , -o, --output (default ./output.png), -f, --format , -w, --width, -h, --height, --output-schema , -i, --interactive

Generate (AI)

• materials generate "A red circle with text Hello" -o out.png
• Options: -o, --output, -f, --format, -w, --width, -h, --height, --output-schema, --model, --api-key, --base-url, -i, --interactive
• Uses OPENAI_API_KEY (and optionally OPENAI_MODEL, OPENAI_BASE_URL) if not passed via flags.

Validate

• materials validate schema.json
• Options: -s, --schema , -i, --interactive

CLI help

Usage: materials  [options]

Commands:
  render      Render a JSON schema file to an image
  generate    Use AI to generate a schema, then render
  validate    Validate a schema against the render data schema

Examples:
  materials render schema.json -o output.png
  materials generate "A red circle with text Hello"
  materials validate schema.json

Schema format

The JSON schema follows the declare-render format: root has id, width, height, and layers. Layer types include text, image, and shape. Use materials validate to check a schema before rendering.