How to Use PATINA Text to Material in OpenClaw
PATINA Text to Material turns a surface description into a tileable texture plus five PBR maps for 3D rendering. It creates the starting texture as well as the maps, with base textures up to 2048 pixels and maps reaching 8K through upscaling.
Prompts to try with PATINA Text to Material in OpenClaw
Copy an example into OpenClaw, or ask in your own words.
Every Monday, use PATINA Text to Material to generate one 1024 by 1024 masonry material for review. Rotate among limestone, sandstone, and rough mortar, and describe the grain and location of weathering in each prompt.
Each Friday, use PATINA Text to Material to make one 1024 by 1024 timber material for a coastal environment collection. Alternate between salt in the grooves, worn raised grain, and fine surface cracks; keep the texture repeating in both directions.
Once a week, use PATINA Text to Material to create one 1024 by 1024 clay material. Alternate fine pores, shallow fractures, and dusty recesses, and keep the texture and five maps together with the description.
Every Tuesday, use PATINA Text to Material to generate a 1024 by 1024 plaster candidate for an aged interior collection. Specify fine sand grain and place cracks around worn patches; prepare it for visual review.
Each month, use PATINA Text to Material to create one 1024 by 1024 stone material for a ruin set. Change the placement of moss and mineral deposits each time, and include the full set of rendering maps.
How to set up PATINA Text to Material in OpenClaw
Pick the way that suits you. Each takes about two minutes.
Use the Spiral skill
- Send OpenClaw this message
Your agent reads Spiral's skill and sets itself up.
set up https://spiral.ai/SKILL.md
- Sign in or paste a key
Approve Spiral in the browser, or give the agent a key from the console.
Use Spiral's MCP server
- Add the server
On the machine that runs OpenClaw's Gateway:
openclaw mcp add spiral \ --url https://api.spiral.ai/mcp \ --transport streamable-http \ --auth oauth
- Sign in
In Settings › MCP, select Sign in on the Spiral server, sign in to Spiral and click Authorize. No API key.
openclaw mcp login spiral
- Reload and check
A running Gateway may keep its old tool list: restart it, or Save & Publish in the Control UI.
openclaw mcp reload openclaw mcp doctor spiral --probe
Use the Spiral CLI
- Install and sign in
Installs the Spiral CLI, signs you in and adds its skill to your coding agents.
npx -y spiral-cli@latest init
Call the Spiral API
- Create an API key
In the console, under API keys.
- Run PATINA Text to Material
One request; the result comes back by polling or a webhook.
curl https://api.spiral.ai/v1/runs \ -H "Authorization: Bearer $SPIRAL_API_KEY" \ -H "Content-Type: application/json" \ -H "Idempotency-Key: $(uuidgen)" \ -d '{ "provider": "fal", "model": "fal-ai/patina/material", "input": { "prompt": "mossy stone wall" } }'
Then paste one of the prompts above: OpenClaw finds PATINA Text to Material on Spiral, shows the price and runs it.
PATINA Text to Material providers and prices
Spiral runs PATINA Text to Material through fal. Open a card for today's price, with every fee included.
$0.013 per megapixel. image_size presets count as 1 MP; custom sizes round up to whole megapixels. Billed on num_images, default 1.
Settings you can ask for
PATINA Text to Material works from your prompt, image URL, and mask URL. Ask OpenClaw for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Number of inference steps | 1 to 8 | 8 | Number of denoising steps for texture generation. |
| Seed | a whole number | Random seed for reproducible generation. | |
| Number of images | 1 to 4 | 1 | Number of texture images to generate. |
| Enable prompt expansion | on or off | on | Expand prompt with an LLM for richer detail. Adds ~0.0025 credits. |
| Tiling mode | both, horizontal, or vertical | both | Tiling direction: 'both' (omnidirectional), 'horizontal', or 'vertical'. |
| Tile size | 32 to 256 | 128 | Tile size in latent space. Automatically capped to the generated image dimensions on tiled axes (64 = 512px, 128 = 1024px). |
| Tile stride | 16 to 128 | 64 | Tile stride in latent space. Automatically capped to half the effective tile size. |
| Strength | a number up to 1 | 0.6 | How much to transform the input image. Only used when image_url is provided. |
| Upscale factor | 0, 2, or 4 | 0 | Upscale factor for predicted PBR maps via SeedVR seamless upscaling. 0 = no upscaling, 2 = 2× resolution, 4 = 4× resolution. The base texture image is not upscaled. |
| Output format | jpeg, png, or webp | png | Output image format for textures and PBR maps. |
Every API field of PATINA · Text to Material is on its tool page: open its card above.
What can you do with PATINA Text to Material in OpenClaw?
Build a material library over time from recurring art briefs. A scheduled agent can generate surface candidates and keep each result associated with its description for later review.
Game environment surfaces
Generate tileable stone, clay, or concrete materials for floors and walls. Describe cracks, pores, and deposits to give each location a specific surface treatment.
Architectural finish studies
Create plaster, limestone, and ceramic material candidates for interior renders. Compare surface grain and wear before choosing a finish.
Film set weathering
Build materials for aged sets by specifying moss in joints, salt along boards, or paint peeling around edges. Use the resulting maps in the scene's material workflow.
Product surface exploration
Try ceramic, leather, or textured concrete finishes on a product visualization. Generate material candidates from descriptions before committing to a surface direction.
Prop material development
Create wood grain, cracked clay, or worn leather materials for 3D props. Describe the scale and placement of surface damage to guide the result.
Reusable material libraries
Build a collection of tileable PBR materials organized by surface and condition, such as dry plaster, dusty stone, and weathered timber.
More on PATINA Text to Material and OpenClaw
Overview
PATINA Text to Material in other agents
Questions about PATINA Text to Material in OpenClaw
Can OpenClaw use PATINA Text to Material?
Yes. Add Spiral to OpenClaw as an MCP server, and OpenClaw can find and run PATINA Text to Material like any built-in tool.
How much does PATINA Text to Material cost in OpenClaw?
$0.013 per megapixel. `image_size` presets count as 1 MP; custom sizes round up to whole megapixels. Billed on `num_images`, default 1. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your OpenClaw plan is separate.
Do I need a fal account to use PATINA Text to Material in OpenClaw?
No. Spiral runs PATINA Text to Material on its own fal account. You sign in to Spiral once and never paste a key.
How long does it take to set up PATINA Text to Material in OpenClaw?
About two minutes: add the server, then sign in, then reload and check.
Does OpenClaw wait while PATINA Text to Material runs?
PATINA Text to Material runs in the background. OpenClaw starts the run, checks on it and gives you the image when it's ready.
What does PATINA Text to Material produce?
It produces a tileable texture plus five physically based rendering maps: base color, normal, roughness, metalness, and height. The result is material imagery for a 3D rendering workflow.
Does PATINA Text to Material generate native 8K textures?
Base texture generation reaches 2048 pixels. The predicted PBR maps can reach 8K through upscaling, which does not enlarge the original generated texture.
How should I describe a material?
Describe visible surface details such as grain, cracks, pores, or worn edges. Specify where weathering appears, such as moss inside mortar joints or pale dust inside cracks.
Which materials need extra review?
Review metals, coated surfaces, and translucent materials carefully. Fal says its training library favors nonmetallic surfaces and identifies those other material classes as underrepresented.
Is PATINA Text to Material useful for game and film environments?
Yes. Creating tileable material libraries and matching weathering for environment art and set dressing are documented uses.
Start using PATINA Text to Material in OpenClaw
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into OpenClaw:
set up https://spiral.ai/SKILL.md


