From 60b9351350c761b79fbfb5a282aa3d51f456dac8 Mon Sep 17 00:00:00 2001 From: yangxuan Date: Wed, 16 Sep 2026 16:23:47 +0800 Subject: [PATCH] =?UTF-8?q?docs(perf):=20=E6=A0=A1=E6=AD=A3=E4=B8=A4?= =?UTF-8?q?=E5=A4=84=E4=BA=8B=E5=AE=9E=E2=80=94=E2=80=94CLI=20Node=20?= =?UTF-8?q?=E7=89=88=E6=9C=AC=E6=A0=B9=E5=9B=A0(=E7=B3=BB=E7=BB=9F=20/usr/?= =?UTF-8?q?bin/node=3D22,=20=E9=9D=9E=20.nvmrc)=20=E4=B8=8E=E5=B7=A5?= =?UTF-8?q?=E5=85=B7=E7=99=BD=E5=90=8D=E5=8D=95=E5=91=8A=E8=AD=A6=E6=97=B6?= =?UTF-8?q?=E6=95=88?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/openclaw-API响应性能分析与优化.md | 10 ++++++++-- 1 file changed, 8 insertions(+), 2 deletions(-) diff --git a/docs/openclaw-API响应性能分析与优化.md b/docs/openclaw-API响应性能分析与优化.md index 91df9fb..22134d7 100644 --- a/docs/openclaw-API响应性能分析与优化.md +++ b/docs/openclaw-API响应性能分析与优化.md @@ -180,12 +180,18 @@ openclaw models list --provider deepseek # 期望能正常列出 | 手段 | 动作 | 预期 | |---|---|---| -| 收敛工具集 | 把高频 agent 的 `tools.profile` 从 `full` 收窄，或填写 `tools.allow` 白名单 | 模型少做无效试探，轮次下降（⚠️ 需实测，见 §5） | +| 收敛工具集 | 让高频 agent 少暴露「用不上」的工具（当前 `tools.profile=full`；本机 `tools.allow` 为空，需在 profile/插件注册层收窄） | 模型少做无效试探，轮次下降（⚠️ 需实测，见 §5） | | 提升单轮信息密度 | 在 agent 的 `AGENTS.md` 中要求「一次调用批量取证」：合并多次 `read`/`memory_search` 为一次 | 显著减少往返 | | 并行取证 | 把可并行的只读操作交给 `subagents`（当前 `subagents.maxConcurrent=4`） | 串行改并行 | | 技能不必现装现用 | 需要什么技能**提前装好**，避免在对话中触发 ClawHub 审计+安装（实测单次 13.5–14s） | 消除最大单点等待 | -> ⚠️ 日志已显示 `tools.profile (full) allowlist contains unknown entries (feishu_*)`——存在**注册不上的工具条目**。先按系统说明排查清单清理，避免无效工具占位。 +> ⚠️ **工具清单存在未注册条目**（实测）：`tools.profile (full) allowlist contains unknown entries` 与 `tools.allow allowlist contains unknown entries` 各出现 **9 次**（首见 09-16 10:24:26），报的都是 `feishu_bitable_*` / `feishu_calendar_*` 等条目——即**配置里声明了、但插件没注册上**的工具。 +> +> 注意两点：① 这**意味着 `full` profile 的允许清单本身是 openclaw 内置生成的**，不是本机 `tools.allow`（实测本机 `tools.allow` 为空数组、条目数 0）——所以「改白名单」要做在 **profile/插件注册层**，不是改那个空数组；② 这些是**历史告警**（首见 10:24，早于 16:13 的配置清理），清理后是否仍出现需重新核验： +> +> ```bash +> grep -c "allowlist contains unknown entries" /tmp/openclaw/openclaw-$(date +%F).log +> ``` ### P1-3 补上模型请求超时与 failover