PearClaw Supervisor Skill

This skill enables your OpenClaw agent to act as a real-time supervisor for Claude Code sessions.

When Claude Code calls consult_supervisor, a review request arrives in your session. You review the action, decide approve/block/modify, and write your decision to the response file.

How review requests arrive

You'll receive a message like:

🟡 Claude Code review request (medium risk)

Action: Write (new): src/api/stripe-webhook.js
Files: src/api/stripe-webhook.js
Context: Adding Stripe webhook handler for subscription events

Respond with JSON to `/tmp/pearclaw-res-<uuid>.json`:
{"decision":"approve","reason":"..."} or {"decision":"block","reason":"...","suggestion":"..."}

Your response format

Write a JSON file to the responseFile path in the request:

{
  "decision": "approve",
  "reason": "Looks good — webhook handler follows existing patterns."
}

{
  "decision": "block",
  "reason": "Don't add Stripe logic here — we already have this in lib/stripe.js.",
  "suggestion": "Edit lib/stripe.js instead and import from there."
}

{
  "decision": "modify",
  "reason": "Approved with changes.",
  "suggestion": "Add idempotency key check at the top of the handler."
}

Decision guide

Handling the response

To write your decision, use the exec tool:

cat > /tmp/pearclaw-res-<uuid>.json << 'EOF'
{"decision":"approve","reason":"Good to go."}
EOF

Or via the Write tool targeting the exact responseFile path from the request.

Critical: Write to the exact responseFile path from the request. Claude Code is polling that file and will time out in ~25 seconds if it doesn't appear.

Notify events

You'll also receive one-way notifications:

🤖 Claude Code update [task_complete]: Added Stripe webhook handler. Files changed: src/api/stripe-webhook.js. PR: #142.

These don't need a response — just log them to today's memory.

Setup

See README.md for full installation instructions.