OpenClaw 项目经理配置升级工具 - 让你的 AI Agent 成为优秀的项目经理。

V2 在 V1 基础上增加了任务管理、Session 隔离、自动恢复等核心能力。

V2 新增功能：

• 🔴 复杂任务管理（计划文件 + Checkpoint）
• 🔒 Session 隔离规则（防止跨 session 混淆）
• 🔄 GatewayRestart 强制恢复行为
• 🎤 主动 Interview（需求澄清）
• ⚡ 并行执行优化
• 🔖 Checkpoint 机制

V1 提供了 3 个核心能力增强：

• 主动性增强（Heartbeat 机制）
• 可重入性增强（Memory Flush Protocol）
• Agential Thinking（任务执行优先级）

# 安装 V2 配置
npx @1va7/openclaw-pm

运行后，工具会：

1. 如果检测到 OpenClaw workspace，自动保存配置文件
2. 如果没有检测到，输出配置内容供你复制

• Heartbeat 机制优化
• 主动检查项目进度
• 智能汇报时机

• Session 重启恢复检查
• Memory Flush Protocol
• 上下文管理优化

• 任务执行优先级
• API > CLI > Skill > 浏览器
• 效率最大化

• 强制要求先写计划文件（temp/任务名-plan.md）
• 每完成一步更新计划文件
• Context 压缩时依赖文件而非记忆
• 完成后汇报 + 清理

为什么重要：复杂任务跨越多个 session 时，计划文件是唯一可靠的状态记录。

• 收到任务立即记录到 memory/YYYY-MM-DD.md
• 记录状态、进度、上次汇报时间
• 完成时更新状态

为什么重要：Heartbeat 检查时才能发现有任务在进行中。

• 每次回复前检查 inbound_meta
• 只基于当前 session 的聊天记录
• 禁止跨 session 查找 context
• 禁止假设 context

为什么重要：防止把私人信息发到群聊，或把群聊信息发到 DM。

• 立即汇报重启原因
• 检查恢复文件（temp/recovery-*.json）
• 检查任务状态
• 检查所有 session 的最后一条消息
• 继续推进任务
• 不要静默

为什么重要：重启后不能静默，必须恢复所有未完成的工作。

• STOP：不要立刻回复
• SEARCH：搜索 workspace 中的相关文件
• RECORD：立即记录到 memory
• PLAN：复杂任务写计划文件
• THEN ACT：找到 context 后再执行

为什么重要：用户让你做一件事，说明你已经有这件事的 context。

• 需求模糊时必须先 interview
• 用选择题而非开放题
• 最多 2 轮 interview
• 2 轮后必须开始执行

为什么重要：需求模糊时埋头苦干，做出来不是用户想要的。

• 独立任务必须并行
• 多个不相关的 tool call 同时发出
• 多个独立的 sub-agent 任务同时 spawn

为什么重要：串行执行独立任务 = 浪费时间。

• 复杂任务每完成一个 Phase 就 git commit
• 计划文件 + git checkpoint = 完整的任务状态

为什么重要：Session 崩溃时能从 git 历史恢复。

V2 包含一套完整的外部健康检查系统，位于 scripts/ 目录：

• gateway-health-check.sh — 自动检查和恢复 Gateway

  • 检测多个 Gateway 进程
  • 清理过期的 session lock
  • 检测崩溃并自动重启
  • 检测消息队列卡住
  • 检测飞书 WebSocket 断连

• check-unanswered.sh — 检测未回复的消息

  • 扫描所有 agent 的 session
  • 检查最后一条消息是否未回复
  • 支持 JSON 输出

• heartbeat-check.sh — 统一执行 HEARTBEAT.md 检查

  • Context Health 检查
  • 进行中任务检查
  • Cron 任务检查

• check-missed-crons.sh — 检查 cron 任务执行状态

  • 查询 cron API
  • 检查关键任务是否执行
  • 支持自动补执行

• quick-diagnose.sh — 一键诊断常见问题

  • Gateway 进程状态
  • Session lock 文件
  • 飞书 WebSocket 连接
  • 消息队列状态
  • LLM 错误

• morning-briefing.sh — 晨间简报

  • 系统健康状态
  • 昨夜活动摘要
  • Cron 任务执行状态
  • 待办事项检查

• daily-stats.sh — 每日活动统计

  • 消息收发统计
  • 按小时分布的消息量
  • 错误分析
  • Gateway 状态

# 复制脚本到 workspace
cp scripts/*.sh ~/.openclaw/workspace/scripts/
chmod +x ~/.openclaw/workspace/scripts/*.sh

# 验证安装
~/.openclaw/workspace/scripts/quick-diagnose.sh

详细使用说明请参考 scripts/README.md。

来自 VA7 的 OpenClaw 调教经验分享。

为什么需要这些调教？

LLM 是无状态的，每次对话都是"新生"。官方设定假设：

• 用户会主动管理 agent
• Session 不会中断
• 任务都是简单的

现实情况：

• 用户希望 agent 自主运行
• Gateway 会重启、崩溃
• 任务可能很复杂，跨越多个 session

V1 解决了什么？

核心洞察：Agent 需要"记忆外化"。

• Memory Flush Protocol → 把记忆写到文件
• 待办检查 → 把任务状态写到文件
• 任务优先级 → 把执行策略写到文件

V2 解决了什么？

核心洞察：Agent 需要"自我监控"。

• 健康检查脚本 → 外部监控 agent 状态
• Session 隔离 → 防止跨 session 混淆
• 强制汇报 → 确保用户知道发生了什么

• 小红书：VA7
• GitHub: https://github.com/1va7/openclaw-pm
• 详细对比报告：config/V2-升级指南.md