From 822fdcb8a2144aa3b18f7f89dfe74d08aa3f5634 Mon Sep 17 00:00:00 2001 From: "openclaw-docs-sync[bot]" Date: Sat, 25 Apr 2026 01:13:11 +0000 Subject: [PATCH] chore(sync): mirror docs from openclaw/openclaw@c018e7347542aa963095de1ca704b943476856fe --- .openclaw-sync/source.json | 4 ++-- docs/concepts/model-providers.md | 2 ++ docs/gateway/config-agents.md | 2 +- docs/help/testing-live.md | 5 +++++ docs/providers/google.md | 5 +++++ 5 files changed, 15 insertions(+), 3 deletions(-) diff --git a/.openclaw-sync/source.json b/.openclaw-sync/source.json index 73cf273ef..9d6457112 100644 --- a/.openclaw-sync/source.json +++ b/.openclaw-sync/source.json @@ -1,5 +1,5 @@ { "repository": "openclaw/openclaw", - "sha": "cc0f3067a003443d9ec9af5a8fa847798b74c147", - "syncedAt": "2026-04-25T01:05:36.150Z" + "sha": "c018e7347542aa963095de1ca704b943476856fe", + "syncedAt": "2026-04-25T01:11:43.237Z" } diff --git a/docs/concepts/model-providers.md b/docs/concepts/model-providers.md index 91fdda73d..1dc7b123f 100644 --- a/docs/concepts/model-providers.md +++ b/docs/concepts/model-providers.md @@ -180,6 +180,8 @@ OpenClaw ships with the pi‑ai catalog. These providers require **no** - Example models: `google/gemini-3.1-pro-preview`, `google/gemini-3-flash-preview` - Compatibility: legacy OpenClaw config using `google/gemini-3.1-flash-preview` is normalized to `google/gemini-3-flash-preview` - CLI: `openclaw onboard --auth-choice gemini-api-key` +- Thinking: `/think adaptive` uses Google dynamic thinking. Gemini 3/3.1 omit a fixed + `thinkingLevel`; Gemini 2.5 sends `thinkingBudget: -1`. - Direct Gemini runs also accept `agents.defaults.models["google/"].params.cachedContent` (or legacy `cached_content`) to forward a provider-native `cachedContents/...` handle; Gemini cache hits surface as OpenClaw `cacheRead` diff --git a/docs/gateway/config-agents.md b/docs/gateway/config-agents.md index 238c7487f..e0186a460 100644 --- a/docs/gateway/config-agents.md +++ b/docs/gateway/config-agents.md @@ -943,7 +943,7 @@ scripts/sandbox-browser-setup.sh # optional browser image - `model`: string form overrides `primary` only; object form `{ primary, fallbacks }` overrides both (`[]` disables global fallbacks). Cron jobs that only override `primary` still inherit default fallbacks unless you set `fallbacks: []`. - `params`: per-agent stream params merged over the selected model entry in `agents.defaults.models`. Use this for agent-specific overrides like `cacheRetention`, `temperature`, or `maxTokens` without duplicating the whole model catalog. - `skills`: optional per-agent skill allowlist. If omitted, the agent inherits `agents.defaults.skills` when set; an explicit list replaces defaults instead of merging, and `[]` means no skills. -- `thinkingDefault`: optional per-agent default thinking level (`off | minimal | low | medium | high | xhigh | adaptive | max`). Overrides `agents.defaults.thinkingDefault` for this agent when no per-message or session override is set. +- `thinkingDefault`: optional per-agent default thinking level (`off | minimal | low | medium | high | xhigh | adaptive | max`). Overrides `agents.defaults.thinkingDefault` for this agent when no per-message or session override is set. The selected provider/model profile controls which values are valid; for Google Gemini, `adaptive` keeps provider-owned dynamic thinking (`thinkingLevel` omitted on Gemini 3/3.1, `thinkingBudget: -1` on Gemini 2.5). - `reasoningDefault`: optional per-agent default reasoning visibility (`on | off | stream`). Applies when no per-message or session reasoning override is set. - `fastModeDefault`: optional per-agent default for fast mode (`true | false`). Applies when no per-message or session fast-mode override is set. - `embeddedHarness`: optional per-agent low-level harness policy override. Use `{ runtime: "codex" }` to make one agent Codex-only while other agents keep the default PI fallback in `auto` mode. diff --git a/docs/help/testing-live.md b/docs/help/testing-live.md index a24120cb9..fc1112325 100644 --- a/docs/help/testing-live.md +++ b/docs/help/testing-live.md @@ -293,6 +293,11 @@ Narrow, explicit allowlists are fastest and least flaky: - Gemini (API key): `OPENCLAW_LIVE_GATEWAY_MODELS="google/gemini-3-flash-preview" pnpm test:live src/gateway/gateway-models.profiles.live.test.ts` - Antigravity (OAuth): `OPENCLAW_LIVE_GATEWAY_MODELS="google-antigravity/claude-opus-4-6-thinking,google-antigravity/gemini-3-pro-high" pnpm test:live src/gateway/gateway-models.profiles.live.test.ts` +- Google adaptive thinking smoke: + - If local keys live in shell profile: `source ~/.profile` + - Gemini 3 dynamic default: `pnpm openclaw qa manual --provider-mode live-frontier --model google/gemini-3.1-pro-preview --alt-model google/gemini-3.1-pro-preview --message '/think adaptive Reply exactly: GEMINI_ADAPTIVE_OK' --timeout-ms 180000` + - Gemini 2.5 dynamic budget: `pnpm openclaw qa manual --provider-mode live-frontier --model google/gemini-2.5-flash --alt-model google/gemini-2.5-flash --message '/think adaptive Reply exactly: GEMINI25_ADAPTIVE_OK' --timeout-ms 180000` + Notes: - `google/...` uses the Gemini API (API key). diff --git a/docs/providers/google.md b/docs/providers/google.md index 506a761a8..ae8e2625a 100644 --- a/docs/providers/google.md +++ b/docs/providers/google.md @@ -148,6 +148,11 @@ Gemini 3, Gemini 3.1, and `gemini-*-latest` alias reasoning controls to `thinkingLevel` so default/low-latency runs do not send disabled `thinkingBudget` values. +`/think adaptive` keeps Google's dynamic thinking semantics instead of choosing +a fixed OpenClaw level. Gemini 3 and Gemini 3.1 omit a fixed `thinkingLevel` so +Google can choose the level; Gemini 2.5 sends Google's dynamic sentinel +`thinkingBudget: -1`. + Gemma 4 models (for example `gemma-4-26b-a4b-it`) support thinking mode. OpenClaw rewrites `thinkingBudget` to a supported Google `thinkingLevel` for Gemma 4. Setting thinking to `off` preserves thinking disabled instead of mapping to