概述
deterministic-controller 是一套面向 OpenClaw 的纯文档模板套件,专注于提供确定性的代理编排循环(heartbeat + cron 轮询 + 子代理管理),同时强制要求证据门控交付(无 artifact 路径则不可标记 DONE)。
核心用法
该 skill 采用"零执行"设计理念:
- 模板文件:
templates/目录下包含HEARTBEAT.md(心跳协议)、ACTIVITIES.md(精简任务队列)、SPRINT_TEMPLATE.md(迭代规划模板) - 复制即用提示词:
examples/提供设置引导与项目拆解 prompt - 配置参考:
docs/内含 cron 任务载荷文本与 OpenClaw 配置片段
用户需手动将模板复制到工作区,并替换占位符(如 <TELEGRAM_GROUP_ID>),然后在 openclaw.json 中配置心跳提示与执行节奏。
显著优点
1. 确定性承诺:明确的输入-输出契约,消除编排中的猜测性状态
2. 证据强制校验:交付物必须附带可验证的 artifact 路径,防止空完成
3. 非侵入式架构:不修改系统配置、不创建 cron 作业、不安装服务,完全由用户掌控部署时机与方式
4. 模块化设计:心跳、活动队列、Sprint 模板三者解耦,可按需组合
潜在缺点与局限性
- 非开箱即用:需手动复制、填充模板并配置外部调度器(如 cron/systemd),对自动化期望较高的用户存在摩擦
- 无运行时逻辑:仅为文档与模板,不包含实际代码执行能力
- 配置分散:需同时维护
HEARTBEAT.md占位符、openclaw.json配置及外部 cron 设置,认知负担较高
适合人群
- 追求可审计、可复现代理工作流的高级用户
- 需要将 OpenClaw 集成到现有 DevOps/运维体系(已有 cron/systemd)的团队
- 对"黑盒自动化"持谨慎态度、偏好显式配置的控制派开发者
常规风险
- 模板漂移:手动复制易导致版本不一致,建议建立模板更新检查机制
- 占位符遗漏:
<TELEGRAM_GROUP_ID>等关键变量若未替换,将导致心跳失效 - 外部依赖:cron 载荷与 OpenClaw 配置的同步需人工维护,存在脱节风险
> 来源可信度:本评估基于技能自述文档,未执行动态安全扫描。