From 6f552ebb2150207a02016c63da9606fe928bb952 Mon Sep 17 00:00:00 2001 From: "openclaw-docs-sync[bot]" Date: Fri, 1 May 2026 22:17:22 +0000 Subject: [PATCH] chore(sync): mirror docs from openclaw/openclaw@0df90d9b8d5c4b67ca3e583fafef4a5163ed4a70 --- .openclaw-sync/source.json | 4 ++-- docs/gateway/logging.md | 3 +++ docs/tools/plugin.md | 31 +++++++++++++++++++++++++++++++ 3 files changed, 36 insertions(+), 2 deletions(-) diff --git a/.openclaw-sync/source.json b/.openclaw-sync/source.json index 776e78bcb..1247b0fc3 100644 --- a/.openclaw-sync/source.json +++ b/.openclaw-sync/source.json @@ -1,5 +1,5 @@ { "repository": "openclaw/openclaw", - "sha": "7ac23eeeb58100601710efb3101f2af6ab0be4d0", - "syncedAt": "2026-05-01T21:59:33.967Z" + "sha": "0df90d9b8d5c4b67ca3e583fafef4a5163ed4a70", + "syncedAt": "2026-05-01T22:15:28.527Z" } diff --git a/docs/gateway/logging.md b/docs/gateway/logging.md index 22b2ba6ad..543623f7d 100644 --- a/docs/gateway/logging.md +++ b/docs/gateway/logging.md @@ -41,6 +41,9 @@ openclaw logs --follow raise the file log level. - To capture verbose-only details in file logs, set `logging.level` to `debug` or `trace`. +- Trace logging also includes diagnostic timing summaries for selected hot paths, + such as plugin tool factory preparation. See + [/tools/plugin#slow-plugin-tool-setup](/tools/plugin#slow-plugin-tool-setup). ## Console capture diff --git a/docs/tools/plugin.md b/docs/tools/plugin.md index c756c3e45..402578588 100644 --- a/docs/tools/plugin.md +++ b/docs/tools/plugin.md @@ -334,6 +334,37 @@ do not run in live chat traffic, check these first: Gateway session/status surfaces and, when debugging provider payloads, start the Gateway with `--raw-stream --raw-stream-path `. +### Slow plugin tool setup + +If agent turns appear to stall while preparing tools, enable trace logging and +check for plugin tool factory timing lines: + +```bash +openclaw config set logging.level trace +openclaw logs --follow +``` + +Look for: + +```text +[trace:plugin-tools] factory timings ... +``` + +The summary lists total factory time and the slowest plugin tool factories, +including plugin id, declared tool names, result shape, and whether the tool is +optional. Slow lines are promoted to warnings when a single factory takes at +least 1s or total plugin tool factory prep takes at least 5s. + +If one plugin dominates the timing, inspect its runtime registrations: + +```bash +openclaw plugins inspect --runtime --json +``` + +Then update, reinstall, or disable that plugin. Plugin authors should move +expensive dependency loading behind the tool execution path instead of doing it +inside the tool factory. + ### Duplicate channel or tool ownership Symptoms: