Openclaw Skills

OpenClaw Skills

This folder is the canonical home for The Nine Skills used to operate OpenClaw configuration. These skills are executable standards, not passive docs: every supported agent must use the relevant skill instead of reconstructing OpenClaw procedures from memory.

The skills are designed for deterministic use through direct skill loading, MCP middleware, CLI wrappers, editor rules, or Perpetua-Tools dispatch. They must produce the same files, naming, model routing, stow behavior, and restart flow regardless of the invoking agent.

The Nine Skills

Universal Invocation Protocol

All agents must follow references/universal-skill-protocol.md.

The required invocation envelope is:

{
  "skill_id": "openclaw-add-secret",
  "args": {
    "secret_name": "telegram-bot-token"
  },
  "agent_id": "codex",
  "openclaw_home": "/absolute/path/to/openclaw-home"
}

The required result shape is:

{
  "status": "ok",
  "files_modified": [],
  "follow_up_actions": []
}

Wrappers may add transport metadata, but they must preserve the envelope fields and the result fields. Skill chaining is allowed only when the parent skill declares the internal call and preserves the same openclaw_home.

Default Model Routing

Use references/openrouter-defaults.md as the source of truth for default model routing.

Local-first on Mac:

1. ollama/qwen3.5:9b-nvfp4
2. qwen3-coder:480b-cloud when loaded for heavy code work
3. OpenRouter fallback stack

OpenRouter fallback stack:

Gemini is specialized only and is not the default fallback. Reserve it for visual diff, screenshot comparison, whole-repo architecture mapping, stale-doc detection, or explicit second-opinion review.

PT-Orama Recursive Spawn

OpenClaw deployment is recursive across three layers:

Standard L3 to L1 dispatch:

orama-system
  -> Perpetua-Tools skill dispatcher
  -> openclaw-skills/{skill_id}
  -> target OpenClaw home
  -> files changed, stowed, restarted, verified

Nested OpenClaw recursion:

parent OpenClaw agent
  -> emits universal skill envelope
  -> Perpetua-Tools resolves child openclaw_home
  -> child OpenClaw invokes the same canonical skill
  -> child may later repeat the same pattern for its own sub-instance

Recursive spawn constraints:

1. Every invocation must carry an explicit openclaw_home.
2. A nested call must use the same skill IDs listed in this master file.
3. A sub-agent must be wired to its parent's allowAgents list in openclaw.json.
4. The parent may delegate, but the skill remains authoritative for naming, file layout, stow, restart, and verification.
5. Results must bubble upward in the universal output format so L3, L2, and L1 can audit the same record.

Naming Conventions Enforced

Every generated agent requires:

Every secret touches all three files:

Operational Rules

1. Never freestyle OpenClaw configuration. Use the relevant skill for every configuration change.
2. Run openclaw-status before changes to understand current gateway, launchd, channel, agent, cron, and error state.
3. Run openclaw-restart after config changes. Do not use raw launchctl kickstart as the operational restart path.
4. Treat ~/.openclaw/cron/jobs.json as transient. The gateway regenerates it on startup; never treat it as source of truth.
5. Never echo secrets to terminal, files, logs, prompts, result envelopes, or git history.
6. When creating a sub-agent, wire it to the parent's allowAgents list in openclaw.json.
7. Use stow --no-folding for all stow operations so the symlink structure is preserved.
8. After updating the source skill distribution, re-run stow if new skills were added.

Quick Reference

Agent Compatibility Notes

If an agent cannot load markdown skills directly, it must use Perpetua-Tools or an equivalent wrapper that reads this folder and executes the same procedures.

Attribution

The Nine Skills originate from cc-openclaw (MIT, Rahul Subramanian). The upstream lives at cc-openclaw/ (git submodule).

Extensions in this directory (references/, templates/, scripts/, this SKILL.md) are orama-system additions and are NOT in the upstream repo.

Layer 0 (provider substrate): v1/OpenRouter.md — free model stack, openclaw.json shape, rate limits. See references/openrouter-defaults.md for the distilled routing table.

cc-openclaw = v1/OpenRouter.md (Layer 0 substrate) + openclaw-skills/ (Layer 1 ops). The upstream Nine Skills are in openclaw-skills/cc-openclaw/ (submodule). Our extensions live at openclaw-skills/ root.

Search Frugality Rule

RULE: Never guess when information is scarce. Search in this order — stop at the first satisfying result:

1. /sync-gbrain + gbrain query "<question>" — local semantic memory, zero cost
2. code-review-graph: semantic_search_nodes — structural code context
3. Brave Search API — web facts, current state
4. Perplexity API (inline) — deep web synthesis
5. Grok API — last resort only

NEVER: parallel-fire all search tools. Use the cheapest first. ALWAYS: AskUserQuestion for decisions — never auto-select between ambiguous options.

Windows Coder Policy

RULE: Every available Windows coder MUST be given work as soon as it is idle.

Endpoint pool: $WIN_CODER_ENDPOINTS (default: 192.168.254.103:1234)

Dispatch protocol:

1. Before routing any task to Mac-only paths, check if a Windows coder is free.
2. If free AND task is compatible (Python, Go, TypeScript, general coding): → dispatch to Windows coder FIRST.
3. If offline or no model loaded: skip silently, log WARN, do not fail.
4. As more Windows coders are added to $WIN_CODER_ENDPOINTS, they join the pool automatically — same rule applies to all.

Never leave a Windows coder idle if pending compatible work exists.

Source: diazMelgarejo/orama-system — distributed by TomeVault.