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

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

版本说明

V2 (当前版本)

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

V2 新增功能:

  • :red_circle: 复杂任务管理(计划文件 + Checkpoint)

  • :locked: Session 隔离规则(防止跨 session 混淆)

  • :counterclockwise_arrows_button: GatewayRestart 强制恢复行为

  • :microphone: 主动 Interview(需求澄清)

  • :high_voltage: 并行执行优化

  • :bookmark: Checkpoint 机制

V1

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

  • 主动性增强(Heartbeat 机制)

  • 可重入性增强(Memory Flush Protocol)

  • Agential Thinking(任务执行优先级)

使用方法

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

运行后,工具会:

  1. 如果检测到 OpenClaw workspace,自动保存配置文件

  2. 如果没有检测到,输出配置内容供你复制

V2 vs V1 核心差异

维度 V1 V2
任务管理 简单记录 计划文件 + Checkpoint
Session 隔离 强制隔离规则
重启恢复 检查待办 强制汇报 + 检查所有 session
需求澄清 主动 Interview
执行效率 串行 并行执行
外部监控 完整的健康检查系统

升级内容详解

V1 核心能力

1. 主动性增强

  • Heartbeat 机制优化

  • 主动检查项目进度

  • 智能汇报时机

2. 可重入性增强

  • Session 重启恢复检查

  • Memory Flush Protocol

  • 上下文管理优化

3. Agential Thinking

  • 任务执行优先级

  • API > CLI > Skill > 浏览器

  • 效率最大化

V2 新增能力

1. 复杂任务管理(Claude Code 模式)

  • 强制要求先写计划文件(temp/任务名-plan.md

  • 每完成一步更新计划文件

  • Context 压缩时依赖文件而非记忆

  • 完成后汇报 + 清理

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

2. 任务记录规则

  • 收到任务立即记录到 memory/YYYY-MM-DD.md

  • 记录状态、进度、上次汇报时间

  • 完成时更新状态

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

3. Session 隔离规则

  • 每次回复前检查 inbound_meta

  • 只基于当前 session 的聊天记录

  • 禁止跨 session 查找 context

  • 禁止假设 context

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

4. GatewayRestart 强制行为

  • 立即汇报重启原因

  • 检查恢复文件(temp/recovery-*.json

  • 检查任务状态

  • 检查所有 session 的最后一条消息

  • 继续推进任务

  • 不要静默

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

5. 任务执行前检查

  • STOP:不要立刻回复

  • SEARCH:搜索 workspace 中的相关文件

  • RECORD:立即记录到 memory

  • PLAN:复杂任务写计划文件

  • THEN ACT:找到 context 后再执行

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

6. 主动 Interview

  • 需求模糊时必须先 interview

  • 用选择题而非开放题

  • 最多 2 轮 interview

  • 2 轮后必须开始执行

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

7. 并行执行

  • 独立任务必须并行

  • 多个不相关的 tool call 同时发出

  • 多个独立的 sub-agent 任务同时 spawn

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

8. Checkpoint 机制

  • 复杂任务每完成一个 Phase 就 git commit

  • 计划文件 + git checkpoint = 完整的任务状态

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

健康检查脚本(V2 新增)

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 混淆

  • 强制汇报 → 确保用户知道发生了什么

Vue3的组合式API真香