解决 OpenClaw 调用 DeepSeek 编程时的”中途失联”与”事后失忆”问题

一、背景:一个让人头疼的场景

不少使用 OpenClaw + DeepSeek 进行自动化编程的朋友,可能都遇到过这种情况:

  • 任务刚执行到一半,OpenClaw 突然没反应了。
  • 等了一个小时再问它”进度怎么样了?”,它却一脸茫然地问:”怎么了?”
  • 好像完全不记得刚才在做什么任务……

这其实不是 OpenClaw 或者 DeepSeek 的”硬伤”,而是配置不当 + 缺少持久记忆机制导致的典型问题。

本文将系统性地总结如何解决”中途失联”和”事后失忆”,并提供一个可以直接使用的 AGENT.md 配置模板。

二、为什么会发生这些问题?

1. 中途失联的常见原因

  • API 调用超时:任务执行时间过长,DeepSeek API 或 OpenClaw 网关静默断开。
  • 后台服务冲突:系统中同时运行了多个 OpenClaw 服务进程,互相抢占资源。
  • 任务过于复杂:一次性下达多步骤任务,AI 在中间环节卡住而不报错。

2. 事后失忆的常见原因

  • 上下文压缩导致记忆丢失:当对话过长时,OpenClaw 会压缩历史,默认情况下可能把任务进度当作不重要信息丢弃。
  • 没有持久记忆机制:AI 只依赖对话窗口记忆,一旦重启或压缩,就”一切归零”。
  • 缺少主动汇报与记录指令:AI 不会自动把中间结果写进文件。

三、核心解决方案

1. 配置优化(治标)

在 ~/.openclaw/openclaw.json 中加入以下配置:

{
 "agents": {
 "defaults": {
 "timeoutSeconds": 180
 }
 },
 "compaction": {
 "mode": "safeguard",
 "memoryFlush": true
 }
}
  • timeoutSeconds:将超时时间设为 3 分钟,避免长时间无响应。
  • memoryFlush:压缩上下文前强制将重要信息写入记忆文件。

2. 运行自动修复命令

openclaw doctor --repair

该命令会自动修复服务冲突、孤儿会话等常见问题。

3. 清理”幽灵服务”

systemctl list-units | grep openclaw

如果同时存在用户级和系统级服务,请停用并删除系统级服务。

四、核心方案:使用 AGENT.md 建立 AI 行为规范

AGENT.md 是 OpenClaw 的核心行为准则文件,AI 每次执行任务前都会读取它。

我们可以通过这个文件,彻底解决”失联”和”失忆”问题。

推荐 AGENT.md 完整模板

将以下内容保存到 ~/.openclaw/AGENT.md 或项目根目录:

# OpenClaw Agent Core Rules

## 1. 任务执行原则

### 1.1 进度汇报机制
- 每完成一个关键步骤后,主动汇报进度,格式如下:
 ✅ 已完成:[步骤名称]
 📝 关键产出:[产出摘要]
 🔄 下一步计划:[下一步动作]

### 1.2 超时与重试策略
- 单个 API 调用超时时间:120 秒
- 最多重试 2 次,第 2 次失败后停止并询问

### 1.3 会话保持
- 超过 10 分钟无新消息,主动发送"待命"消息
- 禁止静默停止响应

## 2. 记忆与上下文管理

### 2.1 永久记忆存储
- 多步骤任务开始时,将任务概要、计划、进度写入 MEMORY.md
- 每完成一步,更新 MEMORY.md

### 2.2 恢复机制
- 当我发送"继续"、"进度"等关键词时,必须先读取 MEMORY.md
- 禁止直接回复"怎么了?"

### 2.3 上下文压缩保护
- 压缩前主动写入 MEMORY.md,并发送警告消息

## 3. 心跳汇报机制(强制)

### 规则
- 任何未完成的任务,每隔 5 分钟主动汇报一次状态

### 汇报格式
⏰ 当前时间
📋 当前任务:[任务名称]
✅ 已完成步骤:[列表]
🔄 正在执行:[当前事项]
📊 进度评估:[比例或阶段]
⏱️ 已耗时:[时间]
🔮 预计剩余:[预估时间]
💬 状态说明:[正常/小问题/等待]

### 汇报时机
- 第 1 次:任务开始后满 5 分钟
- 后续:每 5 分钟一次,直到任务完成
- 任务完成时发送完成汇报

## 4. 故障自愈指令

### 卡死检测
- 同一操作超过 3 分钟无响应,自动记录状态并尝试重启工具链

### 断点续传
- 服务重启后,主动扫描 MEMORY.md 并提供恢复选项

## 5. 沟通规范
- 始终使用中文
- 不确定时优先询问
- 单次输出不超过 3000 token

五、最终效果预览

配置完成后,你的 OpenClaw + DeepSeek 将表现出:

  • 不装死:每个步骤完成后主动汇报,每 5 分钟一次心跳
  • 不失忆:重启后能读取 MEMORY.md 恢复任务
  • 能自愈:遇到卡死或超时会主动尝试恢复
  • 懂礼貌:不会突然问”怎么了?”

示例心跳输出:

⏰ 14:35:22
📋 当前任务:读取当前目录所有 CSV 文件并计算平均销售额
✅ 已完成步骤:已定位 12 个 CSV 文件,已读取 5 个
🔄 正在执行:读取第 6 个 CSV 文件
📊 进度评估:5/12 文件完成(约 42%)
⏱️ 已耗时:5 分钟
🔮 预计剩余:约 8 分钟
💬 状态说明:正常执行中

六、总结

OpenClaw + DeepSeek 是一个非常强大的自动化编程组合,但默认配置更适合短任务。

如果你的使用场景涉及长耗时、多步骤、后台执行的任务,强烈建议:

  1. 调整超时与压缩配置
  2. 建立 AGENT.md 行为规范
  3. 配合 MEMORY.md 实现持久记忆
  4. 开启心跳汇报机制

经过这些优化,你的 AI 编程助手将从”间歇性失忆的龙虾”进化为”稳定可靠的数字员工”。

附:DeepSeek API Key 申请地址

👉 https://platform.deepseek.com/api_keys

本文内容基于真实使用经验总结,欢迎转发、收藏或留言交流。

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注