Appearance
问题排查总索引
按症状找到对应排查页面。
安装相关 → 安装问题
| 症状 | 问题编号 |
|---|---|
| Windows CLI 冷启动需要 10-14 秒 | #30072 |
| Docker 容器重启后无限登录循环（缺少 Set-Cookie） | #29955 |
| QNAP NAS / 非标准 Docker 部署 Gateway 卡死无响应 | #30080 |
Gateway 启动 / 运行 → Gateway 问题
| 症状 | 问题编号 |
|---|---|
配置 auth token 后 CLI 报 token_mismatch | #38617 |
| 切换网络后 Gateway 崩溃（AssertionError，IPv4 undefined） | #38628 |
| macOS VPN 断线重连后 Gateway 不自动恢复 | #38682 |
openclaw stop 超时，Gateway 进程无法干净退出 | #38721 |
渠道连接 → 渠道问题
| 症状 | 问题编号 |
|---|---|
| Telegram 消息被重复接收和处理 | #38681 |
| Telegram 消息不触发 Agent（WebChat 正常） | #38606 |
| WhatsApp 渠道状态显示 Connected 但消息发送失败 | #38734 |
| 飞书渠道有处理日志但回复消息未发送到飞书 | #38686 |
提供商配置 → 提供商问题
| 症状 | 问题编号 |
|---|---|
| Ollama 本地模型在配置 UI 中无法保存（保存按钮无响应） | #38563 |
| Cron 任务或子 Agent 提示 provider 未配置 | #29886 |
AWS Bedrock 部分模型报 text field is blank | #30117 |
| Memory Search 功能网络超时（中国大陆用户） | #38503 |
通用调试命令
遇到问题时，先运行以下命令收集信息：
bash
openclaw status --all # 最全面的只读调试报告
openclaw health # Gateway 健康快照
openclaw doctor # 环境检查如需提交 issue，建议附上 openclaw status --all 的输出（注意脱敏 API Key）。