From bad78393611c7dad2fc2aefda3ccf2eda92087f4 Mon Sep 17 00:00:00 2001 From: "openclaw-docs-sync[bot]" Date: Mon, 27 Apr 2026 11:31:53 +0000 Subject: [PATCH] chore(sync): mirror docs from openclaw/openclaw@053aff6d350048f2be9cc9c2ca885b46d4a6e5ac --- .openclaw-sync/source.json | 4 ++-- docs/.generated/config-baseline.sha256 | 4 ++-- docs/cli/mcp.md | 8 ++++++-- docs/gateway/configuration-reference.md | 3 +++ docs/plugins/bundles.md | 1 + 5 files changed, 14 insertions(+), 6 deletions(-) diff --git a/.openclaw-sync/source.json b/.openclaw-sync/source.json index 1db52a3a5..554f79b93 100644 --- a/.openclaw-sync/source.json +++ b/.openclaw-sync/source.json @@ -1,5 +1,5 @@ { "repository": "openclaw/openclaw", - "sha": "db087a4be7b22fb8891a4c3001d1eaad9f0308d7", - "syncedAt": "2026-04-27T11:28:55.412Z" + "sha": "053aff6d350048f2be9cc9c2ca885b46d4a6e5ac", + "syncedAt": "2026-04-27T11:30:23.473Z" } diff --git a/docs/.generated/config-baseline.sha256 b/docs/.generated/config-baseline.sha256 index f87b0eb3f..aaa19906b 100644 --- a/docs/.generated/config-baseline.sha256 +++ b/docs/.generated/config-baseline.sha256 @@ -1,4 +1,4 @@ -8a37b104c6b3a25618cbf4ecd0dd511703997fb1a10a1167226ab9918eb85455 config-baseline.json -a1839a03fc557a5439fc7b4ce2d45c7212b61e15588e15886bb22b65ff7dc32d config-baseline.core.json +3546f416ff22ead14952cd105c7b88e3b7b76d5ddc10269e73f69ed1950f0603 config-baseline.json +b29ade2d1d2415b030b4d5ec36097a93ab4ea943b7d2a52da95829be1c28fc2a config-baseline.core.json 07963db49502132f26db396c56b36e018b110e6c55a68b3cb012d3ec96f43901 config-baseline.channel.json ed65cefbef96f034ce2b73069d9d5bacc341a43489ff9b20a34d40956b877f79 config-baseline.plugin.json diff --git a/docs/cli/mcp.md b/docs/cli/mcp.md index 5baec8598..e670951c9 100644 --- a/docs/cli/mcp.md +++ b/docs/cli/mcp.md @@ -381,6 +381,7 @@ Notes: - `list` sorts server names. - `show` without a name prints the full configured MCP server object. - `set` expects one JSON object value on the command line. +- Use `transport: "streamable-http"` for Streamable HTTP MCP servers. `openclaw mcp set` also normalizes CLI-native `type: "http"` to the same canonical config shape for compatibility. - `unset` fails if the named server does not exist. Examples: @@ -389,7 +390,7 @@ Examples: openclaw mcp list openclaw mcp show context7 --json openclaw mcp set context7 '{"command":"uvx","args":["context7-mcp"]}' -openclaw mcp set docs '{"url":"https://mcp.example.com"}' +openclaw mcp set docs '{"url":"https://mcp.example.com","transport":"streamable-http"}' openclaw mcp unset context7 ``` @@ -404,7 +405,8 @@ Example config shape: "args": ["context7-mcp"] }, "docs": { - "url": "https://mcp.example.com" + "url": "https://mcp.example.com", + "transport": "streamable-http" } } } @@ -470,6 +472,8 @@ Sensitive values in `url` (userinfo) and `headers` are redacted in logs and stat | `headers` | Optional key-value map of HTTP headers (for example auth tokens) | | `connectionTimeoutMs` | Per-server connection timeout in ms (optional) | +OpenClaw config uses `transport: "streamable-http"` as the canonical spelling. CLI-native MCP `type: "http"` values are accepted when saved through `openclaw mcp set` and repaired by `openclaw doctor --fix` in existing config, but `transport` is what embedded Pi consumes directly. + Example: ```json diff --git a/docs/gateway/configuration-reference.md b/docs/gateway/configuration-reference.md index 0fcb4fea6..ff3756dbc 100644 --- a/docs/gateway/configuration-reference.md +++ b/docs/gateway/configuration-reference.md @@ -88,6 +88,9 @@ target server during config edits. - `mcp.servers`: named stdio or remote MCP server definitions for runtimes that expose configured MCP tools. + Remote entries use `transport: "streamable-http"` or `transport: "sse"`; + `type: "http"` is a CLI-native alias that `openclaw mcp set` and + `openclaw doctor --fix` normalize into the canonical `transport` field. - `mcp.sessionIdleTtlMs`: idle TTL for session-scoped bundled MCP runtimes. One-shot embedded runs request run-end cleanup; this TTL is the backstop for long-lived sessions and future callers. diff --git a/docs/plugins/bundles.md b/docs/plugins/bundles.md index f7074d46b..9e9214453 100644 --- a/docs/plugins/bundles.md +++ b/docs/plugins/bundles.md @@ -149,6 +149,7 @@ MCP servers can use stdio or HTTP transport: ``` - `transport` may be set to `"streamable-http"` or `"sse"`; when omitted, OpenClaw uses `sse` +- `type: "http"` is a CLI-native downstream shape; use `transport: "streamable-http"` in OpenClaw config. `openclaw mcp set` and `openclaw doctor --fix` normalize the common alias. - only `http:` and `https:` URL schemes are allowed - `headers` values support `${ENV_VAR}` interpolation - a server entry with both `command` and `url` is rejected