适用于 Openclaw 的 Commitment Engine

一个稳健的状态机框架,将对话中的承诺转化为持久、可追踪且自动执行的文件。

dottythehomeless
v1.0.0
2026年3月31日
0
503
0

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

npx clawhub@latest install commitment-engine

2. 手动安装

将技能文件夹复制到以下位置之一

全局模式
~/.openclaw/skills/
工作区
<project>/skills/

优先级:工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

请帮我使用 Clawhub 安装 commitment-engine。如果尚未安装 Clawhub,请先安装(npm i -g clawhub)。

更倾向于下载?

获取包含原生技能文件的ZIP压缩包。

什么是 Commitment Engine?

Commitment Engine v2 旨在克服 LLM 短期记忆的局限性。虽然传统的上下文窗口会随时间丢失信息,但该技能将意图转化为基于文件的持久化状态机。通过利用 Openclaw Skills,它确保每一个口头承诺(无论是周期性报告还是单次跟进)都被视为系统级保证,而不是易错的记忆。

其核心理念是将“意愿”转化为“状态”。通过使用预写日志 (WAL) 协议,代理在回复用户之前,必须先将任务记录在 Commitment Ledger 中。这种架构保证了代理的预定操作与活跃的对话上下文解耦,从而即使在心跳唤醒后也能可靠执行。

Commitment Engine 应用场景

  • 无需用户提醒,自动追踪每日或每周的周期性任务。
  • 为隐式任务设置强制截止日期(例如:自动为当日请求分配 21:00 的截止日期)。
  • 管理带有 1 小时内部计时器的对外跟进承诺。
  • 创建所有代理承诺及其当前执行状态的可验证审计追踪。

Commitment Engine 工作原理

  1. 代理在对话流中识别出时间敏感型任务。
  2. 在回复用户之前,代理遵循 WAL 协议将任务写入 workspace/commitments.md。
  3. 在每个心跳周期内,Openclaw Skills 协议优先扫描 Commitment Ledger。
  4. 在触发时间 30 分钟内的任务进入准备状态以生成输出。
  5. 在截止时间 10 分钟内的任务获得最高优先级,中断其他非必要进程。
  6. 状态机从活跃更新为已完成或逾期,并对任何失败发送即时通知。

Commitment Engine 配置指南

要初始化 Commitment Engine,请确保您的代理有权访问 workspace 目录并配置初始的 ledger 文件。对于周期性任务,请与 cron 系统集成:

# 为周期性承诺添加硬保证
openclaw cron add --name "daily-report-prep" --cron "50 17 * * 1-5" --message "Commitment Engine Trigger: C001. Read commitments.md and execute."

确保代理遵循 H12 硬性规则:在向用户确认任务之前写入 ledger。

Commitment Engine 数据架构与分类体系

系统以 Markdown 格式维护一个 Commitment Ledger,结构如下:

属性 描述
ID 承诺的唯一标识符
Content 任务的详细描述
Type 分类:周期性或单次
Status active, preparing, awaiting_confirm, executing, completed, failed, overdue, cancelled
Trigger Time 执行的目标时间戳
Next/Last Execution 周期性逻辑的追踪

所有状态变更都会在 ledger 和代理的每日记忆文件中记录。

Commitment Engine 高级特性

  • WAL (Write-Ahead Logging) 协议确保没有任何任务在未被记录的情况下得到确认。
  • 双层保护,结合软心跳检查与通过 Openclaw Skills 进行的硬 cron 触发。
  • 优先级升级逻辑,当承诺截止日期在 10 分钟内时,中断低优先级任务。
  • 自动状态机,处理草稿确认、执行重试和逾期提醒。

SKILL.md


加载中

Openclaw 相关技能

METADATA

Github Stars: 0
forks: 0

精选*