全部故障排除指南

将社区讨论转化为权威故障排除指南的专业知识库。

Apr 20, 2026 • v0.14.x - v1.x

[编码代理技能通知因默认heartbeat.target配置被静默丢弃] - Coding-Agent Skill Notifications Silently Dropped Due to Default heartbeat.target Configuration

api channel config install macos
Apr 20, 2026

[消息丢失与重复传递修复] - Delivery Reliability — Silent Message Loss & Duplicate Delivery

api channel error
Apr 20, 2026

[危险执行模块导致插件安装被拦截] - Plugin Installation Blocked: 'dangerous-exec' Critical Security Finding

install macos runtime
Apr 20, 2026 • v2026.4.19-beta.1

[子代理不再继承调用者账户] - Agents/channels: route cross-agent subagent spawns through the target agent's bound channel account while preserving peer and workspace/role-scoped bindings, so child sessions no longer inherit the caller's account in shared rooms, workspaces, or multi-account setups.

release v2026.4.19-beta.1 troubleshooting
Apr 20, 2026 • v2026.4.19-beta.2

[保留会话令牌总数避免提供商元数据缺失时回退到未知/0%] - Agents/status: preserve carried-forward session token totals for providers that omit usage metadata, so `/status` and `openclaw sessions` keep showing the last known context usage instead of dropping back to unknown/0%.

release v2026.4.19-beta.2 troubleshooting
Apr 20, 2026 • v2026.4.19-beta.2

[按目标会话划分嵌套代理工作，避免长运行阻塞网关其他会话] - Agents/nested lanes: scope nested agent work per target session so a long-running nested run on one session no longer head-of-line blocks unrelated sessions across the gateway.

release v2026.4.19-beta.2 troubleshooting
Apr 20, 2026 • v2026.4.19-beta.2

[修复流式请求上下文使用量报告] - Agents/openai-completions: always send `stream_options.include_usage` on streaming requests, so local and custom OpenAI-compatible backends report real context usage instead of showing 0%.

release v2026.4.19-beta.2 troubleshooting
Apr 20, 2026

[支持云网关BYOK（自带密钥）] - Support BYOK (Bring Your Own Key) for Cloud Gateways

api config install
Apr 20, 2026 • v1.2.0+

[云网关支持自带密钥] - Support BYOK (Bring Your Own Key) for Cloud Gateways

api config install
Apr 20, 2026 • v2026.2.26

[OpenClaw 升级期间 npm 安装失败] - npm Install Failure During OpenClaw Upgrade on macOS

error install macos permission