← Back to Skills Marketplace
736
Downloads
0
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install deterministic-controller
Description
Deterministic, evidence-gated controller templates for OpenClaw enabling repeatable orchestration loops with heartbeat, cron poll, and sprint planning.
README (SKILL.md)
Deterministic Controller for OpenClaw (Docs-only)
USE WHEN
- You want a deterministic, repeatable orchestration loop for OpenClaw (heartbeat + cron poll + subagents).
- You want evidence-gated completion (no DONE without artifact paths).
- You want a lean portfolio queue (
ACTIVITIES.md) with external sprint-plan import viaPlan Path.
DON'T USE WHEN
- You want a turnkey, self-modifying installer that patches config / creates cron jobs automatically.
- You need complex runtime code; this skill is templates + docs.
Outputs
- Template files under this skill folder:
templates/HEARTBEAT.mdtemplates/ACTIVITIES.mdtemplates/SPRINT_TEMPLATE.md
- Copy/paste prompts:
examples/setup_prompt.mdexamples/project_to_sprint_prompt.md
- Cron payload text:
docs/poll_cron_payload.txt
- Config guidance:
docs/openclaw_config_snippets.md
How to use
Start with the repo README:
README.md
Then copy templates into your workspace and set:
\x3CTELEGRAM_GROUP_ID>inHEARTBEAT.md- heartbeat prompt + cadence in
openclaw.json(seedocs/openclaw_config_snippets.md)
This skill intentionally does not execute commands or change config automatically.
Usage Guidance
This skill is documentation-only and appears to do what it says, but it gives an agent the documented ability to read and update workspace files and to send control-plane logs to a Telegram group if you configure that. Before using or arming automation: (1) inspect AGENTS.md, IDENTITY.md, USER.md, SOUL.md, MEMORY.md and any files referenced as Evidence/Output for secrets or sensitive info; (2) perform manual dry runs (MANUAL_RECONCILE) and keep the poll cron disabled until you confirm behavior; (3) if you enable Telegram logging, only send minimal control-plane lines and use a dedicated group; (4) review and apply least-privilege allowlists for subagents/models. If you want, provide the exact workspace paths you plan to use and I can point out which files to sanitize or test steps to safely arm the controller.
Capability Analysis
Type: OpenClaw Skill
Name: deterministic-controller
Version: 0.1.1
The skill bundle is designed to set up a deterministic control loop for an OpenClaw agent, involving powerful capabilities such as filesystem read/write, creating a cron job for persistence (explicitly disabled by default), spawning subagents, and network egress for control-plane logging to Telegram. While the skill includes strong prompt injection defenses and extensive security documentation (`SECURITY.md`) advising on secret hygiene and opt-in features, the broad read scope for `HEARTBEAT_TICK` (e.g., `USER.md`, `SOUL.md`, `MEMORY.md`) and explicit instructions for network egress to Telegram (`HEARTBEAT.md`) present significant attack surface and risk if the operator fails to follow security best practices. These capabilities, though documented and opt-in, elevate the risk beyond benign, classifying it as suspicious due to potential vulnerabilities rather than clear malicious intent.
Capability Assessment
Purpose & Capability
The skill declares itself as docs/templates-only and the files (HEARTBEAT.md, ACTIVITIES.md, SPRINT_TEMPLATE.md, prompts, and config snippets) match that purpose. The Telegram logging option and cron payload are coherent with a controller/observability use case.
Instruction Scope
Runtime docs instruct agents/operators to read and update workspace files (ACTIVITIES.md, HEARTBEAT.md, project plan files) and provide copy/paste prompts to perform those edits. The HEARTBEAT contract explicitly allows reading additional files (AGENTS.md, IDENTITY.md, USER.md, SOUL.md, MEMORY.md, daily memory files) when a full heartbeat is run — this is documented but expands the agent's read scope and should be reviewed before arming automation.
Install Mechanism
No install spec or code is included; nothing will be downloaded or written by the skill itself. It's instruction-only, so there is no install-time execution risk.
Credentials
The skill requests no environment variables or credentials. However, its documented runtime reads workspace files that may contain sensitive data; the SECURITY.md appropriately calls this out and recommends secret hygiene. This read scope is explainable by the controller's needs but is a sensitive capability if misused.
Persistence & Privilege
The templates and example prompts instruct operators on creating a poll cron job and configuring heartbeat cadence, which can create persistent automation if the operator enables them. The repository emphasizes keeping the cron job disabled by default and not auto-enabling anything; that operator control mitigates privilege concerns but operators must follow the checklist before arming.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install deterministic-controller - After installation, invoke the skill by name or use
/deterministic-controller - Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.1
Docs safety hardening: add SECURITY.md; clarify heartbeat full-refresh reads include memory; note Telegram logging is optional.
v0.1.0
Initial docs-only release (templates + prompts + cron payload + config snippets).
Metadata
Frequently Asked Questions
What is deterministic-controller?
Deterministic, evidence-gated controller templates for OpenClaw enabling repeatable orchestration loops with heartbeat, cron poll, and sprint planning. It is an AI Agent Skill for Claude Code / OpenClaw, with 736 downloads so far.
How do I install deterministic-controller?
Run "/install deterministic-controller" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is deterministic-controller free?
Yes, deterministic-controller is completely free (open-source). You can download, install and use it at no cost.
Which platforms does deterministic-controller support?
deterministic-controller is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created deterministic-controller?
It is built and maintained by Dan (@variable190); the current version is v0.1.1.
More Skills