第 10 章
疑难排查
🔧 常见问题
| 问题 | 排查步骤 |
|---|---|
| 安装后 Agent 不响应 |
openclaw doctor --fix → 检查 allowFrom 白名单 → openclaw status
|
| BOOTSTRAP 没有自动执行 | 手动发送"读取 BOOTSTRAP.md 并引导我完成配置" |
| memoryFlush 未触发 |
确认 enabled: true → 启用 /verbose → 进行 100+ 轮对话测试
|
| 子 Agent 失败 |
降低 maxConcurrent → 增加 timeout → 确认任务适合并行
|
| Cron 未执行 |
用 crontab.guru 验证表达式 → 检查 timezone → openclaw cron list
|
| memorySearch 无结果 | 检查 embedding 配置 → 按规范重写日志 → 补充检索标签 |
| 配置修改不生效 |
大多数配置热加载无需重启；gateway.* 等少数字段需要 openclaw restart
|