hydra-head-operator

name	hydra-head-operator
description	Execute Hydra operations: init, commit, open, close, fanout. Manual invoke only due to L1 state changes.
argument-hint	<shell command>
allowed-tools	["Bash(hydra-node:*)","Bash(hydra-tui:*)","Bash(curl:*)","Bash(docker:*)","Bash(cat:*)","Read","Write"]
disable-model-invocation	true
user-invocable	true
command-dispatch	tool
command-tool	exec
command-arg-mode	raw
context	["!hydra-node --version 2>&1 | head -3","!hydra-node run --help 2>&1 | head -30"]
metadata	{"openclaw":{"emoji":"🗯","requires":{"anyBins":["hydra-node","docker"],"bins":["curl"]},"install":[{"id":"brew","kind":"brew","formula":"colima docker docker-compose curl","bins":["colima","docker","docker-compose","curl"],"label":"Install Docker runtime (Colima) + Docker CLI + Compose + curl (brew)","os":["darwin","linux"]}],"homepage":"https://docs.openclaw.ai/tools/exec"}}

hydra-head-operator

OPERATOR SKILL: Executes Hydra Head operations that affect L1 state. Requires explicit human invocation.

When to use

• When ready to start hydra-node, init head, commit funds, or close/fanout
• After reviewing guidance from hydra-head

Operating rules (must follow)

• Confirm network and scripts tx id before starting
• Verify all peer configurations match
• REQUIRE explicit confirmation before Init, Close, Fanout
• Keep logs for debugging
• Test on devnet/preview before mainnet

OpenClaw exec dispatch mode

This skill also functions as a deterministic exec gateway for OpenClaw: when you run the slash command, OpenClaw bypasses the model and forwards your arguments straight to the Exec Tool (command-dispatch: tool).

Safety first: force approvals + allowlist mode

Before using as an operator, set Exec defaults for the session:

• /exec host=gateway security=allowlist ask=on-miss

Allowlist-safe shortcut (recommended)

If your Exec allowlist is strict, allowlist one entrypoint and route everything through it:

• Allowlist: ~/Projects/**/cardano-agent-skills/scripts/oc-safe.sh (adjust glob)
• Run:
  • /hydra_head_operator ./scripts/oc-safe.sh hydra --help
  • /hydra_head_operator ./scripts/oc-safe.sh hydra gen-hydra-key --output-file hydra
  • /hydra_head_operator ./scripts/oc-safe.sh hydra-api 4001 head

Docker fallback mode

If hydra-node is not installed locally, use the wrapper script in this skill folder to run hydra-node inside Docker:

chmod +x {baseDir}/scripts/hydra-node.sh
{baseDir}/scripts/hydra-node.sh --help

Quick API probes (curl wrapper):

chmod +x {baseDir}/scripts/hydra-api.sh
{baseDir}/scripts/hydra-api.sh 4001 head
{baseDir}/scripts/hydra-api.sh 4001 metrics

Pre-flight checklist