openclaw/docs/tools
Chris Zhang c3bfd328ad
feat(litellm): add image generation provider (#70246)
* feat(litellm): add image generation provider

Registers litellm as an image-generation provider so model refs like
litellm/gpt-image-2 route through the LiteLLM proxy, and
agents.defaults.imageGenerationModel.fallbacks entries of the form
litellm/... resolve without "No image-generation provider registered
for litellm" errors.

Implementation uses the OpenAI-compatible /images/generations and
/images/edits endpoints that LiteLLM proxies for. BaseUrl resolves from
models.providers.litellm.baseUrl (default http://localhost:4000). Private
network is auto-allowed when baseUrl is a loopback/RFC1918 address, which
covers the common self-hosted LiteLLM proxy case without needing
OPENCLAW_PROVIDER_ALLOW_PRIVATE_NETWORK. Public baseUrls keep normal SSRF
defaults.

Default model is gpt-image-2 (matching upstream 4.21+ OpenAI default).
Advertises the same 2K/4K sizes OpenAI now exposes, plus legacy
256/512/1024 for dall-e-3. Supports both generate and edit.

Local patch. LiteLLM has no upstream image-generation support yet; revisit
if upstream adds one.

* ci: rerun after upstream main hot-fix

* fix(litellm): harden image generation provider

---------

Co-authored-by: Chris Zhang <chris@ChrisdeMac-mini.local>
Co-authored-by: Peter Steinberger <steipete@gmail.com>
2026-04-25 19:06:51 +01:00
..
acp-agents-setup.md docs: replace generic 'this page covers' intros with direct openings 2026-04-24 22:25:03 -07:00
acp-agents.md Refresh the Codex runtime docs 2026-04-24 20:30:33 -07:00
agent-send.md docs: normalize frontmatter titles to sentence case 2026-04-23 13:15:17 -07:00
apply-patch.md docs(tools): add Related sections and unify See also to Related 2026-04-23 15:41:56 -07:00
brave-search.md docs(tools): convert search and web-fetch param tables to ParamField 2026-04-23 19:40:05 -07:00
browser-control.md docs(browser): document headless start override 2026-04-25 11:42:04 +01:00
browser-linux-troubleshooting.md feat(browser): configure local startup timeouts 2026-04-25 12:30:35 +01:00
browser-login.md docs(tools): add Related sections and unify See also to Related 2026-04-23 15:41:56 -07:00
browser-wsl2-windows-remote-cdp-troubleshooting.md docs(tools): add Related sections and unify See also to Related 2026-04-23 15:41:56 -07:00
browser.md fix(browser): honor remote CDP open timeouts 2026-04-25 18:52:57 +01:00
btw.md docs: normalize frontmatter titles to sentence case 2026-04-23 13:15:17 -07:00
capability-cookbook.md docs(capability-cookbook): normalize Provider and Harness Seams heading to sentence case 2026-04-24 09:15:22 -07:00
clawhub.md docs(tools): add Related sections and unify See also to Related 2026-04-23 15:41:56 -07:00
code-execution.md docs: unify See also/Related headings across remaining pages 2026-04-23 20:23:06 -07:00
creating-skills.md docs: standardize frontmatter field order (summary before title) 2026-04-23 13:18:17 -07:00
diffs.md docs: standardize frontmatter field order (summary before title) 2026-04-23 13:18:17 -07:00
duckduckgo-search.md docs(tools): convert search and web-fetch param tables to ParamField 2026-04-23 19:40:05 -07:00
elevated.md docs: normalize frontmatter titles to sentence case 2026-04-23 13:15:17 -07:00
exa-search.md docs(tools): convert search and web-fetch param tables to ParamField 2026-04-23 19:40:05 -07:00
exec-approvals-advanced.md fix: match bare exec allowlist commands 2026-04-25 04:18:24 +01:00
exec-approvals.md fix: match bare exec allowlist commands 2026-04-25 04:18:24 +01:00
exec.md fix: match bare exec allowlist commands 2026-04-25 04:18:24 +01:00
firecrawl.md docs: remove duplicate H1 where frontmatter title already sets it 2026-04-23 13:11:14 -07:00
gemini-search.md docs: normalize frontmatter titles to sentence case 2026-04-23 13:15:17 -07:00
grok-search.md docs: normalize frontmatter titles to sentence case 2026-04-23 13:15:17 -07:00
image-generation.md feat(litellm): add image generation provider (#70246) 2026-04-25 19:06:51 +01:00
index.md fix(subagents): explain browser tool profile filtering 2026-04-25 17:59:05 +01:00
kimi-search.md docs: normalize frontmatter titles to sentence case 2026-04-23 13:15:17 -07:00
llm-task.md docs: clarify OpenAI GPT-5.5 auth routes 2026-04-23 23:49:17 +01:00
lobster.md docs: standardize frontmatter field order (summary before title) 2026-04-23 13:18:17 -07:00
loop-detection.md docs(tools): add Related sections and unify See also to Related 2026-04-23 15:41:56 -07:00
media-overview.md feat(media): add voice conversion and speech plugins 2026-04-25 12:12:33 +01:00
minimax-search.md docs: normalize frontmatter titles to sentence case 2026-04-23 13:15:17 -07:00
multi-agent-sandbox-tools.md fix(agents): fail empty explicit tool allowlists 2026-04-25 01:11:36 +01:00
music-generation.md fix(minimax): default music generation to music 2.6 2026-04-25 10:55:54 +01:00
ollama-search.md docs: normalize frontmatter titles to sentence case 2026-04-23 13:15:17 -07:00
pdf.md refactor(pdf): move document extraction to plugin 2026-04-24 17:15:05 -07:00
perplexity-search.md docs(tools): convert perplexity-search params to ParamField 2026-04-23 19:41:09 -07:00
plugin.md docs(plugins): document persisted registry repair 2026-04-25 10:35:35 -07:00
reactions.md docs: remove duplicate H1 where frontmatter title already sets it 2026-04-23 13:11:14 -07:00
searxng-search.md docs: normalize frontmatter titles to sentence case 2026-04-23 13:15:17 -07:00
skills-config.md docs(tools): add Related sections and unify See also to Related 2026-04-23 15:41:56 -07:00
skills.md fix(skills): restore legacy skill metadata fallback (#71346) 2026-04-25 03:30:51 +01:00
slash-commands.md feat(discord): allow voice model override 2026-04-25 12:47:46 +01:00
subagents.md fix(subagents): explain browser tool profile filtering 2026-04-25 17:59:05 +01:00
tavily.md docs: remove duplicate H1 where frontmatter title already sets it 2026-04-23 13:11:14 -07:00
thinking.md fix: map google adaptive thinking dynamically 2026-04-25 02:04:40 +01:00
tokenjuice.md feat(plugins): add harness tool result middleware (#71021) 2026-04-24 12:39:13 -07:00
trajectory.md docs(tools): add Related sections and unify See also to Related 2026-04-23 15:41:56 -07:00
tts.md fix(whatsapp): send voice note text separately 2026-04-25 18:55:03 +01:00
video-generation.md fix(xai): support video reference images 2026-04-25 18:14:51 +01:00
web-fetch.md docs(tools): convert search and web-fetch param tables to ParamField 2026-04-23 19:40:05 -07:00
web.md docs: standardize frontmatter field order (summary before title) 2026-04-23 13:18:17 -07:00