标签: troubleshooting
OpenClaw Skill 安装后不生效？3 步定位白名单/配置/重启（2026）
技能已安装却无响应？用 3 步快速定位：确认安装 → 插件白名单 → 重启验证，避免误判。
OpenClaw `doctor --fix` 和 `--repair` 有什么区别？2026 安全修复教程（含可回滚步骤）
很多用户在故障时直接运行 `openclaw doctor --fix --force`，结果把自定义配置覆盖。本文给出 `--fix`/`--repair`/`--force` 的差异、可复制的安全修复流程与验证清单。
OpenClaw `web_search` 500 报错排障：工具同名冲突与参数约束修复（2026）
针对 OpenClaw 高频报错“Parameters of tool web_search must only have these properties:query”，给出可验证根因、止血步骤、长期治理方案与回归检查清单。
OpenClaw `channels status --probe` 实战：机器人在线却不回复，5 分钟定位到具体渠道（2026）
当 OpenClaw 机器人显示在线但不回复时，很多人只看 gateway 状态。本文用 `openclaw channels status --probe` 给出可复制的分层排查流程，快速定位是网关、渠道凭据、群策略还是模型层问题。
OpenClaw v2026.3.2 升级后常见回归：7 个高频问题与修复清单
基于近 7 天可验证 issue/commit，汇总 OpenClaw v2026.3.2 升级后高频报错与可执行修复步骤，覆盖 compaction 吞消息、Invalid diff、contextTokens 卡死、Telegram schema 报错等。
OpenClaw `status` 和 `gateway status` 有什么区别？5 分钟定位“在线但不回消息”问题（2026）
很多人把 `openclaw status` 和 `openclaw gateway status` 混用，导致排障方向跑偏。本文给出可复制命令、判断标准和 5 分钟决策流，快速定位“网关问题”还是“渠道问题”。
OpenClaw Gateway 启动失败 FAQ（2026）：Linux / systemd 一步步修复指南
面向高频故障的 OpenClaw Gateway 启动失败排查教程：mode 配置、端口冲突、bind/auth 拒绝、systemd 崩溃恢复。附可直接执行命令与稳定化建议。
OpenClaw 代理系列(2)：`web_search` 报 `fetch failed` 的排查与修复指南（2026）
面向用户的实战排查手册：当 OpenClaw 的 web_search/web_fetch 出现 fetch failed 时，如何快速定位、修复并配置稳定 fallback。
OpenClaw Telegram 集成成功但不回复：Webhook / 409 / 权限完整排查（2026）
Telegram 机器人显示在线却不回复？按这份 OpenClaw 排查清单逐步检查：gateway 状态、409 冲突、Webhook 配置、群组权限、模型与日志。附可直接执行命令。
OpenClaw 部署报错排查清单（2026）：Gateway 启动失败、Telegram 不回、Chrome Relay 连接失败
一篇解决 OpenClaw 三大高频部署问题的实战教程：Gateway 启动失败、Telegram 机器人不回复、Chrome Browser Relay 连不上。附可直接执行命令与稳定化建议。
OpenClaw 消息静默丢失/重复投递怎么排查？2026 可靠性实战指南
基于近 7 天真实 issue，系统排查 OpenClaw 的 silent message loss、replay、恢复链路异常与可观测性缺口，给出可执行命令与稳定化策略。
OpenClaw Telegram 报错 409 Conflict（terminated by other getUpdates request）怎么修？2026 一次性排查
针对 OpenClaw + Telegram 最常见的 409 Conflict 轮询冲突，提供可直接执行的排查命令与修复步骤，覆盖多实例冲突、Webhook 残留、systemd/容器重复进程与长期稳定方案。
OpenClaw Docker 启动失败：non-loopback Control UI / allowedOrigins 报错的根因与修复（2026）
基于最近 GitHub issue 与 release 变更，解释 OpenClaw 在 Docker/远程部署中出现 allowedOrigins 报错的原因，给出可直接执行的安全修复步骤。
OpenClaw Gateway 启动失败怎么修？2026 可执行排查清单（mode=local / EADDRINUSE / auth）
针对 OpenClaw Gateway 启动失败的高频报错，提供可直接执行的排查命令与修复步骤，覆盖 gateway.mode、端口冲突、bind/auth、安全配置与 systemd 服务异常。
OpenClaw Telegram 机器人在线但不回复：10 分钟排查与修复（2026）
针对高频问题“机器人在线但不回消息”，给出可直接执行的 OpenClaw + Telegram 排查命令：token、webhook 冲突、pairing、群组权限、网络代理与长期稳定部署。
OpenClaw Chrome 浏览器中继连不上？完整排查指南（2026）
解决 OpenClaw Chrome 扩展中继问题：标签页无法附加、徽章不亮、WebSocket 断连、浏览器操作失败。逐步排查命令，即查即用。
OpenClaw 配置文件详解与常见报错修复（2026）
系统讲解 OpenClaw openclaw.json 配置文件的核心结构、必填字段、模型路由、插件白名单配置，并逐一排查 schema 校验失败、provider 连接超时、channel 启动报错等高频问题。
OpenClaw Telegram 机器人不工作？完整排查指南（2026）
解决所有常见的 OpenClaw + Telegram 问题：机器人无响应、401 错误、配对失败、群聊问题、轮询失效、DNS/网络故障。每一步都有可直接执行的命令。
OpenClaw Gateway 启动失败 / 浏览器 Relay 连不上：完整排查指南（2026）
逐步排查 OpenClaw 两大高频问题：Gateway 启动失败（EADDRINUSE、mode 报错、服务崩溃）和 Chrome 浏览器 Relay 红色感叹号或超时。每个修复都有可直接执行的命令。
Windows 11 资源管理器 OneDrive 图标重复？一招注册表修复彻底搞定
Windows 11 文件资源管理器左侧同时出现 OneDrive 和 OneDrive - Personal 两个图标？这是微软已知的注册表残留 Bug。本文详解原因、修复步骤和预防方法。
OpenClaw + Proxychains 代理配置与问题排查（Claude 访问篇）
从 0 到 1：先配置 Proxychains 再跑 OpenClaw，并系统排查超时、429、浏览器控制失败、本地回环误代理等常见问题。
常见问题
这个标签页包含什么？
聚合所有与 troubleshooting 相关的 OpenClaw 中文实战文章。
从哪篇开始看？
先看最新故障排查文，再看进阶教程，效率最高。
多久更新一次？
有新中文文章打上这个标签后会自动更新。