From 2ff2dd3a48e479108e323701fae3dbfedb6fa96e Mon Sep 17 00:00:00 2001 From: "openclaw-docs-sync[bot]" Date: Sat, 25 Apr 2026 19:01:39 +0000 Subject: [PATCH] chore(sync): mirror docs from openclaw/openclaw@b66f01bdca7bb08f48c90c7b135b68b57200fed0 --- .openclaw-sync/source.json | 4 ++-- docs/cli/infer.md | 6 ++++++ docs/providers/openai.md | 14 ++++++++++++++ docs/tools/image-generation.md | 16 ++++++++++++++++ 4 files changed, 38 insertions(+), 2 deletions(-) diff --git a/.openclaw-sync/source.json b/.openclaw-sync/source.json index 61663e467..712edf56f 100644 --- a/.openclaw-sync/source.json +++ b/.openclaw-sync/source.json @@ -1,5 +1,5 @@ { "repository": "openclaw/openclaw", - "sha": "bb2b68b34e30f50c2a3a2443bdacbb9640d69648", - "syncedAt": "2026-04-25T18:57:18.032Z" + "sha": "b66f01bdca7bb08f48c90c7b135b68b57200fed0", + "syncedAt": "2026-04-25T18:59:59.476Z" } diff --git a/docs/cli/infer.md b/docs/cli/infer.md index f5dbd32fd..dca170e04 100644 --- a/docs/cli/infer.md +++ b/docs/cli/infer.md @@ -156,7 +156,9 @@ Use `image` for generation, edit, and description. ```bash openclaw infer image generate --prompt "friendly lobster illustration" --json openclaw infer image generate --prompt "cinematic product photo of headphones" --json +openclaw infer image generate --model openai/gpt-image-1.5 --output-format png --openai-background transparent --prompt "simple red circle sticker on a transparent background" --json openclaw infer image generate --prompt "slow image backend" --timeout-ms 180000 --json +openclaw infer image edit --file ./logo.png --model openai/gpt-image-1.5 --output-format png --openai-background transparent --prompt "keep the logo, remove the background" --json openclaw infer image describe --file ./photo.jpg --json openclaw infer image describe --file ./ui-screenshot.png --model openai/gpt-4.1-mini --json openclaw infer image describe --file ./photo.jpg --model ollama/qwen2.5vl:7b --json @@ -165,6 +167,10 @@ openclaw infer image describe --file ./photo.jpg --model ollama/qwen2.5vl:7b --j Notes: - Use `image edit` when starting from existing input files. +- Use `--output-format png --openai-background transparent` with + `--model openai/gpt-image-1.5` for transparent-background OpenAI PNG output. + These OpenAI-specific flags are available on both `image generate` and + `image edit`. - Use `image providers --json` to verify which bundled image providers are discoverable, configured, selected, and which generation/edit capabilities each provider exposes. diff --git a/docs/providers/openai.md b/docs/providers/openai.md index bfaacf22e..809e00c98 100644 --- a/docs/providers/openai.md +++ b/docs/providers/openai.md @@ -267,6 +267,20 @@ OpenAI Codex OAuth routes by rewriting default `openai/gpt-image-2` transparent requests to `gpt-image-1.5`; Azure and custom OpenAI-compatible endpoints keep their configured deployment/model names. +The same setting is exposed for headless CLI runs: + +```bash +openclaw infer image generate \ + --model openai/gpt-image-1.5 \ + --output-format png \ + --openai-background transparent \ + --prompt "A simple red circle sticker on a transparent background" \ + --json +``` + +Use the same `--output-format` and `--openai-background` flags with +`openclaw infer image edit` when starting from an input file. + For Codex OAuth installs, keep the same `openai/gpt-image-2` ref. When an `openai-codex` OAuth profile is configured, OpenClaw resolves that stored OAuth access token and sends image requests through the Codex Responses backend. It diff --git a/docs/tools/image-generation.md b/docs/tools/image-generation.md index b9bcaa19c..95a16a6e9 100644 --- a/docs/tools/image-generation.md +++ b/docs/tools/image-generation.md @@ -289,6 +289,22 @@ OpenAI or OpenAI Codex OAuth route, OpenClaw rewrites the provider request to `gpt-image-1.5`. Azure and custom OpenAI-compatible endpoints keep their configured deployment/model names. +For headless CLI generation, use the equivalent `openclaw infer` flags: + +```bash +openclaw infer image generate \ + --model openai/gpt-image-1.5 \ + --output-format png \ + --openai-background transparent \ + --prompt "A simple red circle sticker on a transparent background" \ + --json +``` + +The same `--output-format` and `--openai-background` flags are available on +`openclaw infer image edit`. Other bundled providers can return PNGs and may +preserve alpha when their backend emits it, but OpenClaw only exposes an +explicit transparent-background control for OpenAI image generation. + Generate one 4K landscape image: ```