跳到主要内容

OpenClaw 入门 07|安全、版本与故障急救

· 阅读需 2 分钟

💡 阅读目标:遇到问题能自己诊断和修复,更新版本时不丢失记忆和配置。

核心认知:多数故障都与 Gateway 进程、上下文耗尽、配置缺失有关。


一、先判断故障类型

故障类型症状常见原因
失忆型新对话不认老信息MEMORY.md 无记录或路径错误
断片型聊着聊着忘前文上下文耗尽,未及时归档
发疯型回复风格异常Prompt 污染、上下文超载
罢工型完全无响应网络、Gateway 进程、权限问题

二、四步急救排查

  1. 检查 Gateway:openclaw gateway status
  2. 若未运行则重启:openclaw gateway restart
  3. 检查上下文占用,超过 60% 立即归档
  4. 检查核心文件是否存在:SOUL.mdUSER.mdMEMORY.mdHEARTBEAT.md

三、发疯型故障修复

  1. 立即开新对话,不在污染上下文里继续
  2. 把异常触发条件写入 SOUL.md 的禁止规则
  3. 检查并补齐核心安全护栏

四、版本更新前:三件必做

  1. 物理备份memory/skills/knowledge/
  2. 生成升级摘要:让 OpenClaw 输出 UPGRADE_READY.md
  3. 记录关键配置:心跳 Cron、API Key、特殊规则

五、版本更新后:灵魂接回三步

  1. 检查路径与核心文件可读性
  2. 读取 memory/UPGRADE_READY.md 恢复上下文
  3. 重新初始化关键心跳任务

六、五条安全铁律

  1. 必须设置认证密码
  2. 不要直接暴露 18789 到公网
  3. 仅安装可信来源 Skills
  4. MEMORY.md 持续备份
  5. 新版本先观察社区反馈再升级

七、常见故障速查

症状快速修复
完全无响应openclaw gateway restart
聊着忘前文归档后开新对话
新对话不认旧信息补齐 MEMORY.md 关键记录
风格突然变化新对话 + 校验 SOUL.md 护栏
心跳没触发检查 Gateway 运行状态

八、验收标准

  1. ✅ 能描述四种故障类型与排查顺序
  2. ✅ 会执行 Gateway 排查与重启
  3. ✅ 会做升级前后保护流程
  4. ✅ 能说出至少三条安全铁律

系列导航

当前为本系列第 7 / 7 篇