Workspace Organizer

任务优先文件组织。创建 YYYY-MM-DD描述/01步骤/ 结构。

核心规则

1. 路径基准

• - 工作空间根目录 = .openclaw\workspace\
• 正确示例: output/2026-03-19_任务/
• 验证位置: pwd 应显示工作空间根目录

2. 智能记忆保存

Python可用时（推荐）

Python不可用时（备用方案）

如果需要PowerShell版本，将 safe-writer-ps1.txt 重命名为 safe-writer.ps1

powershell scripts/safe-writer.ps1 开始任务: [描述] --task-id YYYY-MM-DD描述 --step 01开始

3. 规划-执行流程

1. 1. 完整规划：明确所有步骤（01步骤名、02步骤名...）
2. 创建结构：output/YYYY-MM-DD描述/01步骤/
3. 保存检查点：立即执行智能写入命令
4. 顺序执行：按步骤目录顺序工作，每阶段保存进展

AI工作流程

开始新任务

1. 1. 规划步骤：分析任务，确定3-5个主要阶段
2. 验证位置：确保在工作空间根目录
3. 创建目录：output/YYYY-MM-DD_描述/ 及所有步骤子目录
4. 保存记忆：运行智能写入命令记录任务开始
5. 执行工作：按步骤顺序进行，定期保存进展

恢复任务

• - 说恢复上次任务或运行 task-memory-manager.py recovery
• 系统显示未完成任务列表供选择

核心脚本

• - safe-writer.py - Python版记忆写入（原子操作+双写保证，推荐使用）
• task-memory-manager.py - 任务扫描与恢复管理
• task-recovery-check.py - 自动检查未完成任务（Python版本）

备用脚本（如需PowerShell版本）

• - safe-writer-ps1.txt - PowerShell备用版本（重命名为 .ps1 使用）
• task-recovery-check-ps1.txt - PowerShell包装器（重命名为 .ps1 使用）
• workspace-commands-ps1.txt - PowerShell快捷命令（重命名为 .ps1 使用）

环境检测

• - Python可用 → 使用 safe-writer.py（功能完整，推荐）
• Python不可用 → 可将 safe-writer-ps1.txt 重命名为 safe-writer.ps1 使用（基础功能）

快速检查

验证当前位置

如有嵌套错误

Heartbeat 自动检查

1. 1. 配置方法：查看 templates/HEARTBEAT-guide.md 文件
2. 执行频率：每2-4小时自动检查未完成任务
3. 行为：

1. 4. 手动检查：py scripts/task-recovery-check.py notify

关键命令速查

• - safe-writer.py <内容> --task-id --step <步骤> - 保存记忆
• task-memory-manager.py recovery - 恢复界面
• task-memory-manager.py scan - 扫描任务
• task-recovery-check.py notify - 心跳检查（Python版本）