From 1416c584ac4cdc48af9f224e3d870ef40900c752 Mon Sep 17 00:00:00 2001 From: Gustavo Madeira Santana Date: Mon, 2 Mar 2026 20:25:25 -0500 Subject: [PATCH] docs: clarify developer-role compat for openai-completions --- docs/concepts/model-providers.md | 3 +++ docs/gateway/configuration-reference.md | 1 + 2 files changed, 4 insertions(+) diff --git a/docs/concepts/model-providers.md b/docs/concepts/model-providers.md index a2b777020d2..58710d88ee7 100644 --- a/docs/concepts/model-providers.md +++ b/docs/concepts/model-providers.md @@ -442,6 +442,9 @@ Notes: - `contextWindow: 200000` - `maxTokens: 8192` - Recommended: set explicit values that match your proxy/model limits. +- For `api: "openai-completions"` on non-native endpoints (any non-empty `baseUrl` whose host is not `api.openai.com`), OpenClaw forces `compat.supportsDeveloperRole: false` to avoid provider 400 errors for unsupported `developer` roles. +- If `baseUrl` is empty/omitted, OpenClaw keeps the default OpenAI behavior (which resolves to `api.openai.com`). +- For safety, an explicit `compat.supportsDeveloperRole: true` is still overridden on non-native `openai-completions` endpoints. ## CLI examples diff --git a/docs/gateway/configuration-reference.md b/docs/gateway/configuration-reference.md index 37e64f2f840..b7486d50d9d 100644 --- a/docs/gateway/configuration-reference.md +++ b/docs/gateway/configuration-reference.md @@ -1961,6 +1961,7 @@ OpenClaw uses the pi-coding-agent model catalog. Add custom providers via `model - `models.providers.*.baseUrl`: upstream API base URL. - `models.providers.*.headers`: extra static headers for proxy/tenant routing. - `models.providers.*.models`: explicit provider model catalog entries. +- `models.providers.*.models.*.compat.supportsDeveloperRole`: optional compatibility hint. For `api: "openai-completions"` with a non-empty non-native `baseUrl` (host not `api.openai.com`), OpenClaw forces this to `false` at runtime. Empty/omitted `baseUrl` keeps default OpenAI behavior. - `models.bedrockDiscovery`: Bedrock auto-discovery settings root. - `models.bedrockDiscovery.enabled`: turn discovery polling on/off. - `models.bedrockDiscovery.region`: AWS region for discovery.