OpenClaw 入门 07|安全、版本与故障急救
· 阅读需 2 分钟
💡 阅读目标:遇到问题能自己诊断和修复,更新版本时不丢失记忆和配置。
核心认知:多数故障都与 Gateway 进程、上下文耗尽、配置缺失有关。
一、先判断故障类型
| 故障类型 | 症状 | 常见原因 |
|---|---|---|
| 失忆型 | 新对话不认老信息 | MEMORY.md 无记录或路径错误 |
| 断片型 | 聊着聊着忘前文 | 上下文耗尽,未及时归档 |
| 发疯型 | 回复风格异常 | Prompt 污染、上下文超载 |
| 罢工型 | 完全无响应 | 网络、Gateway 进程、权限问题 |
二、四步急救排查
- 检查 Gateway:
openclaw gateway status - 若未运行则重启:
openclaw gateway restart - 检查上下文占用,超过 60% 立即归档
- 检查核心文件是否存在:
SOUL.md、USER.md、MEMORY.md、HEARTBEAT.md
三、发疯型故障修复
- 立即开新对话,不在污染上下文里继续
- 把异常触发条件写入
SOUL.md的禁止规则 - 检查并补齐核心安全护栏
四、版本更新前:三件必做
- 物理备份:
memory/、skills/、knowledge/ - 生成升级摘要:让 OpenClaw 输出
UPGRADE_READY.md - 记录关键配置:心跳 Cron、API Key、特殊规则
五、版本更新后:灵魂接回三步
- 检查路径与核心文件可读性
- 读取
memory/UPGRADE_READY.md恢复上下文 - 重新初始化关键心跳任务
六、五条安全铁律
- 必须设置认证密码
- 不要直接暴露
18789到公网 - 仅安装可信来源 Skills
MEMORY.md持续备份- 新版本先观察社区反馈再升级
七、常见故障速查
| 症状 | 快速修复 |
|---|---|
| 完全无响应 | openclaw gateway restart |
| 聊着忘前文 | 归档后开新对话 |
| 新对话不认旧信息 | 补齐 MEMORY.md 关键记录 |
| 风格突然变化 | 新对话 + 校验 SOUL.md 护栏 |
| 心跳没触发 | 检查 Gateway 运行状态 |
八、验收标准
- ✅ 能描述四种故障类型与排查顺序
- ✅ 会执行 Gateway 排查与重启
- ✅ 会做升级前后保护流程
- ✅ 能说出至少三条安全铁律