From dc2575f6c4f58e8c87816be26699bf4422432ed0 Mon Sep 17 00:00:00 2001 From: Peter Steinberger Date: Sat, 4 Apr 2026 09:04:11 +0100 Subject: [PATCH] docs: clarify local agent plugin preload --- docs/cli/agent.md | 3 ++- docs/cli/index.md | 3 ++- 2 files changed, 4 insertions(+), 2 deletions(-) diff --git a/docs/cli/agent.md b/docs/cli/agent.md index 06da3ec406c..8eee735592c 100644 --- a/docs/cli/agent.md +++ b/docs/cli/agent.md @@ -32,7 +32,7 @@ Related: - `--reply-to `: delivery target override - `--reply-channel `: delivery channel override - `--reply-account `: delivery account override -- `--local`: run the embedded agent directly +- `--local`: run the embedded agent directly (after plugin registry preload) - `--deliver`: send the reply back to the selected channel/target - `--timeout `: override agent timeout (default 600 or config value) - `--json`: output JSON @@ -51,6 +51,7 @@ openclaw agent --agent ops --message "Run locally" --local ## Notes - Gateway mode falls back to the embedded agent when the Gateway request fails. Use `--local` to force embedded execution up front. +- `--local` still preloads the plugin registry first, so plugin-provided providers, tools, and channels stay available during embedded runs. - `--channel`, `--reply-channel`, and `--reply-account` affect reply delivery, not session routing. - When this command triggers `models.json` regeneration, SecretRef-managed provider credentials are persisted as non-secret markers (for example env var names, `secretref-env:ENV_VAR_NAME`, or `secretref-managed`), not resolved secret plaintext. - Marker writes are source-authoritative: OpenClaw persists markers from the active source config snapshot, not from resolved runtime secret values. diff --git a/docs/cli/index.md b/docs/cli/index.md index 835e6532e0d..83e45ec7ebe 100644 --- a/docs/cli/index.md +++ b/docs/cli/index.md @@ -956,7 +956,7 @@ Options: - `--reply-to ` (delivery target override, separate from session routing) - `--reply-channel ` (delivery channel override) - `--reply-account ` (delivery account id override) -- `--local` +- `--local` (embedded run; plugin registry still preloads first) - `--deliver` - `--json` - `--timeout ` @@ -964,6 +964,7 @@ Options: Notes: - Gateway mode falls back to the embedded agent when the Gateway request fails. +- `--local` still preloads the plugin registry, so plugin-provided providers, tools, and channels remain available during embedded runs. - `--channel`, `--reply-channel`, and `--reply-account` affect reply delivery, not routing. ### `agents`