From b9fa545a3135ef394560f372f26bc30b43d92ec4 Mon Sep 17 00:00:00 2001 From: "openclaw-docs-sync[bot]" Date: Mon, 4 May 2026 18:17:18 +0000 Subject: [PATCH] chore(sync): mirror docs from openclaw/openclaw@74ab62c6a297e2f92607c7f165a82598516f7fbb --- .openclaw-sync/source.json | 4 ++-- docs/.generated/plugin-sdk-api-baseline.sha256 | 4 ++-- docs/gateway/cli-backends.md | 6 ++++++ docs/plugins/sdk-overview.md | 3 +++ docs/tools/thinking.md | 1 + 5 files changed, 14 insertions(+), 4 deletions(-) diff --git a/.openclaw-sync/source.json b/.openclaw-sync/source.json index d6e8e8939..6f128c4c5 100644 --- a/.openclaw-sync/source.json +++ b/.openclaw-sync/source.json @@ -1,5 +1,5 @@ { "repository": "openclaw/openclaw", - "sha": "103cdd9d96f8f916742a6420b71583abd2f47732", - "syncedAt": "2026-05-04T17:59:58.254Z" + "sha": "74ab62c6a297e2f92607c7f165a82598516f7fbb", + "syncedAt": "2026-05-04T18:15:15.852Z" } diff --git a/docs/.generated/plugin-sdk-api-baseline.sha256 b/docs/.generated/plugin-sdk-api-baseline.sha256 index 95673ce3b..8d14cca35 100644 --- a/docs/.generated/plugin-sdk-api-baseline.sha256 +++ b/docs/.generated/plugin-sdk-api-baseline.sha256 @@ -1,2 +1,2 @@ -f8495c07213012748f099b12ddb02847ffd4eaa1b46f2ae9dfa574fa0ef3299a plugin-sdk-api-baseline.json -815ac868dda35d0af88b9c522233d6065c3eeb70775e19c111162b80390733fa plugin-sdk-api-baseline.jsonl +a7116e6c0cae4c7b9ee7cd6dc48f2978812f4b5be647f3e36eee91ec9a81d85e plugin-sdk-api-baseline.json +2b6c9883d701379761724e21946d417399c1247e6a244d6b00c4a982c8ef5968 plugin-sdk-api-baseline.jsonl diff --git a/docs/gateway/cli-backends.md b/docs/gateway/cli-backends.md index 48eb1181a..6cb5cb47b 100644 --- a/docs/gateway/cli-backends.md +++ b/docs/gateway/cli-backends.md @@ -178,6 +178,12 @@ that agent. To force a different Claude mode, set explicit raw backend args such as `--permission-mode default` or `--permission-mode acceptEdits` under `agents.defaults.cliBackends.claude-cli.args` and matching `resumeArgs`. +The bundled Anthropic `claude-cli` backend also maps OpenClaw `/think` levels +to Claude Code's native `--effort` flag for non-off levels. `minimal` and +`low` map to `low`, `adaptive` and `medium` map to `medium`, and `high`, +`xhigh`, and `max` map directly. Other CLI backends need their owning plugin to +declare an equivalent argv mapper before `/think` can affect the spawned CLI. + Before OpenClaw can use the bundled `claude-cli` backend, Claude Code itself must already be logged in on the same host: diff --git a/docs/plugins/sdk-overview.md b/docs/plugins/sdk-overview.md index fa5474ac7..b3a253d1b 100644 --- a/docs/plugins/sdk-overview.md +++ b/docs/plugins/sdk-overview.md @@ -257,6 +257,9 @@ AI CLI backend such as `codex-cli`. plugin default before running the CLI. - Use `normalizeConfig` when a backend needs compatibility rewrites after merge (for example normalizing old flag shapes). +- Use `resolveExecutionArgs` for request-scoped argv rewrites that belong to + the CLI dialect, such as mapping OpenClaw thinking levels to a native effort + flag. ### Exclusive slots diff --git a/docs/tools/thinking.md b/docs/tools/thinking.md index 1b546bc2b..659cd27ce 100644 --- a/docs/tools/thinking.md +++ b/docs/tools/thinking.md @@ -54,6 +54,7 @@ title: "Thinking levels" ## Application by agent - **Embedded Pi**: the resolved level is passed to the in-process Pi agent runtime. +- **Claude CLI backend**: non-off levels are passed to Claude Code as `--effort` when using `claude-cli`; see [CLI backends](/gateway/cli-backends). ## Fast mode (/fast)