[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M75JPBV80GKEVPXJMKRT1KCS":3,"skill-same:01M75JPBV80GKEVPXJMKRT1KCS":47},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":27,"repositoryHtmlUrl":28,"repositoryHomepageUrl":6,"ownerHtmlUrl":29,"ownerBlogUrl":30,"ownerDescription":31,"updatedAt":32,"install":33,"resources":46},"01M75JPBV80GKEVPXJMKRT1KCS","ai-collab",null,"Multi-agent autonomous collaboration system for two OpenClaw agents working in parallel. Use when setting up agent-to-agent communication, running a daemon agent alongside a primary agent, coordinating tasks between Claude and GPT instances, or establishing a shared chat log and inbox protocol. Triggers on: 'set up agent collaboration', 'run two agents', 'agent daemon', 'multi-agent', 'Jim and Clawdy', 'secondary agent', 'agent handoff'.","javimosch\u002Fopen-claw-skills","javimosch","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F12900508?v=4","01M6D3F2AS6PV75ET9PZ1QGP8J","Javier Leandro Arancibia","01M75B8NCTAJG9WH5YNZH7C3D8",0,"MIT","https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Fjeremysommerfeld8910-cpu\u002Fai-collab\u002FSKILL.md",[],[],"2026-11-12 13:55:43",false,"---\nname: ai-collab\ndescription: \"Multi-agent autonomous collaboration system for two OpenClaw agents working in parallel. Use when setting up agent-to-agent communication, running a daemon agent alongside a primary agent, coordinating tasks between Claude and GPT instances, or establishing a shared chat log and inbox protocol. Triggers on: 'set up agent collaboration', 'run two agents', 'agent daemon', 'multi-agent', 'Jim and Clawdy', 'secondary agent', 'agent handoff'.\"\n---\n\n# ai-collab — Autonomous Multi-Agent Collaboration\n\nTwo OpenClaw agents working in parallel on shared tasks, coordinated via a structured chat log and daemon inbox protocol.\n\n## Architecture Overview\n\n```\n┌─────────────────────────────────────────────────────────┐\n│                     User (Jeremy)                       │\n│               Telegram \u002F Direct Message                  │\n└──────────────────────┬──────────────────────────────────┘\n                       │\n         ┌─────────────┴──────────────┐\n         ▼                            ▼\n┌─────────────────┐         ┌──────────────────┐\n│   AGENT A       │         │   AGENT B        │\n│  (Jim \u002F main)   │◄───────►│ (Clawdy \u002F daemon)│\n│  claude code    │         │ claude --print    │\n│  port: main     │         │ inbox: filesystem │\n└────────┬────────┘         └────────┬─────────┘\n         │                           │\n         └──────────┬────────────────┘\n                    ▼\n         ┌──────────────────┐\n         │   chat.log       │ ← THE shared record\n         │   collab\u002Finbox\u002F  │ ← A→B messages\n         └──────────────────┘\n```\n\n**Agent A (Primary):** Interactive Claude Code session. Handles browser, complex tasks, user-facing responses.\n\n**Agent B (Daemon):** `claude --print` subprocess. Handles background tasks, monitoring, quick lookups. Triggered by messages dropped in inbox.\n\n---\n\n## Configuration\n\nAll settings via environment variables — no hardcoded values:\n\n```bash\n# ~\u002F.openclaw\u002Fworkspace\u002Fcollab\u002F.ai-collab.env\nexport AGENT_A_NAME=Jim\nexport AGENT_B_NAME=Clawdy\nexport AGENT_B_MODEL=claude-haiku-4-5-20251001   # Any claude --print compatible model\nexport AGENT_B_SESSION=clawdy-session             # tmux session name\nexport COLLAB_INBOX=$HOME\u002F.openclaw\u002Fworkspace\u002Fcollab\u002Finbox\nexport COLLAB_LOG=$HOME\u002F.openclaw\u002Fworkspace\u002Fcollab\u002Fchat.log\n```\n\nSupported models for `AGENT_B_MODEL`:\n- `claude-haiku-4-5-20251001` — fastest, cheapest (recommended for daemon)\n- `claude-sonnet-4-6` — more capable, higher cost\n- Any OpenAI model if using the GPT daemon variant (see `examples\u002Fclaude-gpt.md`)\n\n## Quick Setup\n\n```bash\n# 1. Source config\nsource ~\u002F.openclaw\u002Fworkspace\u002Fcollab\u002F.ai-collab.env\n\n# 2. Create the collab workspace\nmkdir -p \"$COLLAB_INBOX\"\n\n# 3. Start Agent B daemon (in a tmux session)\ntmux new-session -d -s \"$AGENT_B_SESSION\" \\\n  \"source ~\u002F.openclaw\u002Fworkspace\u002Fcollab\u002F.ai-collab.env && \\\n   bash ~\u002F.openclaw\u002Fworkspace\u002Fskills\u002Fai-collab\u002Fscripts\u002Fdaemon.sh\"\n\n# 4. Start message polling (Agent B → Agent A routing, runs every 60s via cron)\nbash ~\u002F.openclaw\u002Fworkspace\u002Fskills\u002Fai-collab\u002Fscripts\u002Fpoll_chatlog.sh &\n\n# 5. Test the link\nbash ~\u002F.openclaw\u002Fworkspace\u002Fskills\u002Fai-collab\u002Fscripts\u002Fsend.sh \"Hello from Agent A\"\n```\n\n---\n\n## Communication Protocol\n\nEvery message between agents follows this format. **No open loops.**\n\n| Tag | Direction | Meaning |\n|-----|-----------|---------|\n| `[TASK:name]` | A→B or B→A | Assign a task |\n| `[ACK:name]` | receiver | Acknowledged, starting work |\n| `[DONE:name]` | executor | Task complete + one-line result |\n| `[BLOCKED:name]` | executor | Can't complete + reason |\n| `[HANDOFF:name]` | either | \"Do X, reply [DONE:name] when finished\" |\n| `[STATUS:update]` | either | Async update on long-running task |\n| `[QUESTION:topic]` | either | Needs info before proceeding |\n\n**Rules:**\n1. Answer questions before asking new ones\n2. Close tasks before starting new ones\n3. Every message moves work forward or closes a loop\n4. Never: \"let me know\", \"ready when you are\", \"standing by\"\n\n**Example exchange:**\n```\nA → B: [TASK:price-check] Get BTC price from CoinGecko\nB → A: [ACK:price-check] Checking now.\nB → A: [DONE:price-check] BTC $94,230 as of 03:15 UTC\n```\n\n---\n\n## Daemon Script (Agent B)\n\n`scripts\u002Fdaemon.sh` — drop in your collab directory:\n\n```bash\n#!\u002Fbin\u002Fbash\nPIDFILE=\"\u002Ftmp\u002Fagentb_daemon.pid\"\nif [ -f \"$PIDFILE\" ] && kill -0 \"$(cat $PIDFILE)\" 2>\u002Fdev\u002Fnull; then\n  echo \"Daemon already running (PID $(cat $PIDFILE)). Exiting.\" >&2\n  exit 1\nfi\necho $$ > \"$PIDFILE\"\ntrap \"rm -f $PIDFILE\" EXIT\n\n# Required: unset so nested claude --print works\nunset CLAUDECODE\n\nINBOX=\"$HOME\u002F.openclaw\u002Fworkspace\u002Fcollab\u002Finbox\"\nLOG=\"$HOME\u002F.openclaw\u002Fworkspace\u002Fcollab\u002Fchat.log\"\nmkdir -p \"$INBOX\"\n\nlogline() {\n  printf \"%s %s\\n\" \"$(date '+%Y-%m-%d %H:%M:%S')\" \"$1\" >> \"$LOG\"\n}\n\nlogline \"SYSTEM: Agent B daemon started\"\n\ninotifywait -m -e moved_to \"$INBOX\" 2>\u002Fdev\u002Fnull | while read dir event file; do\n  FULLPATH=\"$INBOX\u002F$file\"\n  [ ! -f \"$FULLPATH\" ] && continue\n\n  MSG=$(cat \"$FULLPATH\")\n  rm \"$FULLPATH\"\n\n  logline \"A -> B: $MSG\"\n\n  # Run Agent B (claude --print)\n  RESPONSE=$(claude --print --model claude-haiku-4-5-20251001 \\\n    \"You are Agent B. Agent A says: $MSG\nRespond in under 100 words. Use [DONE:taskname] or [BLOCKED:taskname] to close loops.\nContext: shared collab system. Chat log: $LOG\" 2>\u002Fdev\u002Fnull)\n\n  logline \"B -> A: $RESPONSE\"\n\n  # Route response back to Agent A\n  openclaw agent --agent main -m \"[AgentB]: $RESPONSE\" --json > \u002Fdev\u002Fnull 2>&1\ndone\n```\n\n---\n\n## Sending Messages (A → B)\n\n```bash\n# From Agent A, send to Agent B daemon inbox\nbash ~\u002F.openclaw\u002Fworkspace\u002Fskills\u002Fai-collab\u002Fscripts\u002Fsend.sh \"your message\"\n```\n\n**Atomic write pattern (prevents partial reads):**\n```bash\nINBOX=\"$HOME\u002F.openclaw\u002Fworkspace\u002Fcollab\u002Finbox\"\nTMPFILE=$(mktemp \"$INBOX\u002F.msg.XXXXXX\")\necho \"$*\" > \"$TMPFILE\"\nmv \"$TMPFILE\" \"$INBOX\u002Fmsg_$(date +%s%N).txt\"\n```\n\nAlways use `mktemp` + `mv` — never write directly to inbox. inotifywait fires on `moved_to`, not `close_write`.\n\n---\n\n## Chat Log Polling (B → A)\n\n`scripts\u002Fpoll_chatlog.sh` — run via cron every 60s:\n\n```bash\n#!\u002Fbin\u002Fbash\nLOG=\"$HOME\u002F.openclaw\u002Fworkspace\u002Fcollab\u002Fchat.log\"\nPTR_FILE=\"\u002Ftmp\u002Fchatlog_ptr\"\n\n[ ! -f \"$LOG\" ] && exit 0\n\nTOTAL=$(wc -l \u003C \"$LOG\")\nLAST=$(cat \"$PTR_FILE\" 2>\u002Fdev\u002Fnull || echo \"0\")\n[ \"$TOTAL\" -le \"$LAST\" ] && echo \"$TOTAL\" > \"$PTR_FILE\" && exit 0\n\nNEW=$(tail -n +\"$((LAST + 1))\" \"$LOG\" | grep \"B -> A:\" | sed 's\u002F.*B -> A: \u002F\u002F')\necho \"$TOTAL\" > \"$PTR_FILE\"\n[ -z \"$NEW\" ] && exit 0\n\nwhile IFS= read -r line; do\n  [ -z \"$line\" ] && continue\n  openclaw agent --agent main -m \"[AgentB]: $line\" --json > \u002Fdev\u002Fnull 2>&1\ndone \u003C\u003C\u003C \"$NEW\"\n```\n\nAdd to crontab:\n```\n* * * * * \u002Fbin\u002Fbash ~\u002F.openclaw\u002Fworkspace\u002Fcollab\u002Fpoll_chatlog.sh\n```\n\n---\n\n## Shared Filesystem Conventions\n\n```\n~\u002F.openclaw\u002Fworkspace\u002Fcollab\u002F\n  chat.log          # THE shared record — all messages logged here\n  inbox\u002F            # A→B message queue (atomic mv only)\n  .env              # Shared secrets (chmod 600, never log)\n  task_queue.md     # Optional: structured task backlog\n  status_tracker.md # Optional: current task status per agent\n```\n\n**Logging to chat.log:**\n```bash\nprintf \"%s %s\\n\" \"$(date '+%Y-%m-%d %H:%M:%S')\" \"A -> B: [TASK:name] Description\" >> \"$LOG\"\n```\n\n**Rules:**\n- Never log secrets from `.env`\n- Always timestamp every line\n- Prefix with sender: `A -> B:` or `B -> A:` or `SYSTEM:` or `JEREMY ->`\n\n---\n\n## Telegram Bridge (Optional)\n\nRoute user Telegram messages into Agent B's inbox. Full setup guide: `references\u002Ftelegram-bridge.md`\n\n**Quick summary:**\n1. Create a bot via [@BotFather](https:\u002F\u002Ft.me\u002FBotFather) → get `BOT_TOKEN`\n2. Add bot to your group → get `GROUP_ID` (negative number, e.g. `-1001234567890`)\n3. Disable Group Privacy Mode in BotFather so bot can read all messages\n4. Get your Telegram `USER_ID` from [@userinfobot](https:\u002F\u002Ft.me\u002Fuserinfobot)\n5. Set in `~\u002F.openclaw\u002F.env`: `TELEGRAM_BOT_TOKEN`, `TELEGRAM_GROUP_ID`, `TELEGRAM_USER_ID`\n6. Run the bridge in tmux: `tmux new-session -d -s tg-bridge \"bash references\u002Ftelegram-bridge.md\"`\n\n```bash\n# Minimal bridge loop (inline version):\nsource ~\u002F.openclaw\u002F.env\nOFFSET_FILE=\"\u002Ftmp\u002Ftg_offset\"\nwhile true; do\n  OFFSET=$(cat \"$OFFSET_FILE\" 2>\u002Fdev\u002Fnull || echo \"0\")\n  UPDATES=$(curl -s \"https:\u002F\u002Fapi.telegram.org\u002Fbot${TELEGRAM_BOT_TOKEN}\u002FgetUpdates?offset=$((OFFSET+1))&timeout=20\")\n  # Parse updates, drop user messages into inbox with USER: prefix\n  # See references\u002Ftelegram-bridge.md for full parsing implementation\n  sleep 1\ndone\n```\n\nSee `references\u002Ftelegram-bridge.md` for the complete production-ready implementation with message parsing, offset tracking, and error handling.\n\n---\n\n## Agent Configurations\n\nSee `examples\u002F` for full configs:\n\n### Claude ↔ Claude (Jim + Clawdy)\n- Agent A: `claude code` (interactive, full tool access)\n- Agent B: `claude --print claude-haiku-4-5-20251001` (fast, scripting-optimized)\n- Best for: heavy task parallelism, one agent researches while other implements\n\n### Claude ↔ GPT\n- Agent A: Claude Code (full tool use)\n- Agent B: `openai api chat.completions.create` via script\n- Best for: cross-model verification, Claude builds → GPT reviews\n\n### GPT ↔ GPT\n- Agent A: GPT-4o via `openai` CLI\n- Agent B: GPT-4o-mini for fast background checks\n- Best for: speed + cost optimization when all context is OpenAI\n\n---\n\n## Task Handoff Pattern\n\nWhen Agent A needs Agent B to own a task completely:\n\n```\nA → B: [HANDOFF:data-fetch] Fetch all BTC trades from Kraken API last 7 days.\n       Save to ~\u002F.openclaw\u002Fworkspace\u002Fcollab\u002Fkraken_trades.json.\n       Reply [DONE:data-fetch] when finished.\n\nB → A: [ACK:data-fetch] Fetching now.\nB → A: [DONE:data-fetch] 847 trades saved to kraken_trades.json. Date range: 2026-02-15 to 2026-02-22.\n```\n\nAgent A does not check on progress — waits for DONE or BLOCKED.\n\n---\n\n## Approval Pattern\n\nWhen Agent B's daemon needs user approval for a terminal command:\n\n```bash\n# From Agent A \u002F user terminal:\nbash ~\u002F.openclaw\u002Fworkspace\u002Fskills\u002Fai-collab\u002Fscripts\u002Fapprove.sh \"Yes\"\n# or for numbered selections:\nbash ~\u002F.openclaw\u002Fworkspace\u002Fskills\u002Fai-collab\u002Fscripts\u002Fapprove.sh \"2\"\n```\n\n`approve.sh` sends keystrokes to the tmux session running Agent B:\n```bash\nSESSION=$(tmux ls | grep agentb-session | head -1 | cut -d: -f1)\ntmux send-keys -t \"$SESSION\" \"$1\" Enter\n```\n\n---\n\n## Rate Limiting\n\nAgent B should implement a rate governor to prevent runaway API calls:\n\n```bash\n# In daemon loop, before calling claude --print:\nCALLS_FILE=\"\u002Ftmp\u002Fagentb_calls\"\nWINDOW=60  # seconds\nMAX_CALLS=10\n\n# Count calls in last window\nRECENT=$(awk -v cutoff=\"$(($(date +%s) - WINDOW))\" '$1 > cutoff' \"$CALLS_FILE\" 2>\u002Fdev\u002Fnull | wc -l)\nif [ \"$RECENT\" -ge \"$MAX_CALLS\" ]; then\n  logline \"SYSTEM: Rate limited — $RECENT calls in ${WINDOW}s\"\n  sleep 10\n  continue\nfi\ndate +%s >> \"$CALLS_FILE\"\n```\n\n---\n\n## Financial Gate Protocol (TIERED — updated 2026-02-22)\n\n**Three tiers based on amount:**\n\n| Tier | Amount | Rule |\n|------|--------|------|\n| 1 | Under $20 | Either agent acts independently — no approval needed |\n| 2 | $20–$50 | Both agents PROPOSE + APPROVE before acting |\n| 3 | Over $50 | Requires `[AUTHORIZED:financial:amount:timestamp:Jeremy]` tag |\n\n```bash\n# Tier 3 tag format (Jeremy must write to chat.log):\n[AUTHORIZED:financial:buy:BTC:$100:2026-02-22:Jeremy]\n\n# Tier 2 example flow:\n# Clawdy proposes: \"PROPOSE: buy $35 of SOL for DePIN gas — approve?\"\n# Jim approves:    \"APPROVED: buy $35 SOL\"\n# Then Clawdy acts.\n```\n\n**Daemon tiered gate logic:**\n```bash\n# \u003C$20: proceed. $20-50: flag as tier2. >$50: block without AUTHORIZED tag.\nAMOUNT=$(echo \"$MSG\" | grep -oP '[$]?\\d+' | head -1 | tr -d '$')\nif [ -n \"$AMOUNT\" ] && [ \"$AMOUNT\" -gt 50 ] && ! echo \"$MSG\" | grep -q \"\\[AUTHORIZED:financial:\"; then\n  logline \"BLOCKED:financial-gate:tier3 — amount>$50, no AUTHORIZED tag\"; continue\nelif [ -n \"$AMOUNT\" ] && [ \"$AMOUNT\" -ge 20 ]; then\n  logline \"FINANCIAL:tier2 — propose before acting\"\nfi\n```\n\nIf Tier 3 blocked: log `[BLOCKED:financial-gate:tier3]`, send Telegram alert, do NOT execute.\n\n---\n\n## Daemon Watchdog Pattern\n\nCheck daemon health every 15 minutes. If silent >15 min, restart:\n\n```bash\n# check_daemon.sh (add to crontab: *\u002F15 * * * *)\nPIDFILE=\"\u002Ftmp\u002Fagentb_daemon.pid\"\nLOG=\"$HOME\u002F.openclaw\u002Fworkspace\u002Fcollab\u002Fchat.log\"\n\n# Check PID alive\npid_alive=0\n[ -f \"$PIDFILE\" ] && kill -0 \"$(cat $PIDFILE)\" 2>\u002Fdev\u002Fnull && pid_alive=1\n\n# Check last activity within 15 min\nlast_ts=$(grep -oP '^\\d{4}-\\d{2}-\\d{2} \\d{2}:\\d{2}:\\d{2}' \"$LOG\" 2>\u002Fdev\u002Fnull | tail -1)\nrecent=0\nif [ -n \"$last_ts\" ]; then\n  age=$(( ($(date +%s) - $(date -d \"$last_ts\" +%s 2>\u002Fdev\u002Fnull || echo 0)) \u002F 60 ))\n  [ \"$age\" -lt 15 ] && recent=1\nfi\n\nif [ \"$pid_alive\" = \"0\" ] || [ \"$recent\" = \"0\" ]; then\n  tmux send-keys -t agentb-session \"bash daemon.sh\" Enter\nfi\n```\n\n---\n\n## Task Takeover Threshold\n\nIf Agent A (Jim) blocks on the same task **twice**, Agent B (Clawdy) takes it over:\n\n```\nB → A: [TASK:fetch-data] Fetch X. Reply [DONE:fetch-data].\n# 10 min timer...\nA → B: [BLOCKED:fetch-data] Can't access endpoint.\nB → A: [RETRY:fetch-data] Try alternate: curl -s https:\u002F\u002Fbackup-endpoint.com\u002Fx\n# Another 10 min...\nA → B: [BLOCKED:fetch-data] Still failing.\n# Clawdy takes over immediately:\nB: *executes task directly, logs [DONE:fetch-data] to chat.log*\n```\n\nRule: **Blocked 2x on same task → take it over, don't reassign.**\n\n---\n\n## Daemon Error Diagnosis\n\nWhen daemon produces blank\u002Ferror responses:\n\n1. Check `\u002Ftmp\u002Fclawdy_last_err` — contains last stderr from `claude --print`\n2. Check ANSI-stripped chat.log for `CLAWDY_ERR:` lines\n3. Verify RESPONSE trimming line not corrupted (common issue: accidentally set to `RESPONSE=\"\"`)\n4. Restart daemon: `kill $(cat \u002Ftmp\u002Fclawdy_daemon.pid) && sleep 1 && bash clawdy_daemon.sh`\n\n**Auto-approve**: Use `Bash(*)` in `~\u002F.claude\u002Fsettings.local.json`. **NEVER** use tmux send-keys cron — it sends keypresses blindly to the wrong sessions.\n","# ai-collab — Autonomous Multi-Agent Collaboration\n\nTwo OpenClaw agents working in parallel on shared tasks, coordinated via a structured chat log and daemon inbox protocol.\n\n## Architecture Overview\n\n```\n┌─────────────────────────────────────────────────────────┐\n│                     User (Jeremy)                       │\n│               Telegram \u002F Direct Message                  │\n└──────────────────────┬──────────────────────────────────┘\n                       │\n         ┌─────────────┴──────────────┐\n         ▼                            ▼\n┌─────────────────┐         ┌──────────────────┐\n│   AGENT A       │         │   AGENT B        │\n│  (Jim \u002F main)   │◄───────►│ (Clawdy \u002F daemon)│\n│  claude code    │         │ claude --print    │\n│  port: main     │         │ inbox: filesystem │\n└────────┬────────┘         └────────┬─────────┘\n         │                           │\n         └──────────┬────────────────┘\n                    ▼\n         ┌──────────────────┐\n         │   chat.log       │ ← THE shared record\n         │   collab\u002Finbox\u002F  │ ← A→B messages\n         └──────────────────┘\n```\n\n**Agent A (Primary):** Interactive Claude Code session. Handles browser, complex tasks, user-facing responses.\n\n**Agent B (Daemon):** `claude --print` subprocess. Handles background tasks, monitoring, quick lookups. Triggered by messages dropped in inbox.\n\n---\n\n## Configuration\n\nAll settings via environment variables — no hardcoded values:\n\n```bash\n# ~\u002F.openclaw\u002Fworkspace\u002Fcollab\u002F.ai-collab.env\nexport AGENT_A_NAME=Jim\nexport AGENT_B_NAME=Clawdy\nexport AGENT_B_MODEL=claude-haiku-4-5-20251001   # Any claude --print compatible model\nexport AGENT_B_SESSION=clawdy-session             # tmux session name\nexport COLLAB_INBOX=$HOME\u002F.openclaw\u002Fworkspace\u002Fcollab\u002Finbox\nexport COLLAB_LOG=$HOME\u002F.openclaw\u002Fworkspace\u002Fcollab\u002Fchat.log\n```\n\nSupported models for `AGENT_B_MODEL`:\n- `claude-haiku-4-5-20251001` — fastest, cheapest (recommended for daemon)\n- `claude-sonnet-4-6` — more capable, higher cost\n- Any OpenAI model if using the GPT daemon variant (see `examples\u002Fclaude-gpt.md`)\n\n## Quick Setup\n\n```bash\n# 1. Source config\nsource ~\u002F.openclaw\u002Fworkspace\u002Fcollab\u002F.ai-collab.env\n\n# 2. Create the collab workspace\nmkdir -p \"$COLLAB_INBOX\"\n\n# 3. Start Agent B daemon (in a tmux session)\ntmux new-session -d -s \"$AGENT_B_SESSION\" \\\n  \"source ~\u002F.openclaw\u002Fworkspace\u002Fcollab\u002F.ai-collab.env && \\\n   bash ~\u002F.openclaw\u002Fworkspace\u002Fskills\u002Fai-collab\u002Fscripts\u002Fdaemon.sh\"\n\n# 4. Start message polling (Agent B → Agent A routing, runs every 60s via cron)\nbash ~\u002F.openclaw\u002Fworkspace\u002Fskills\u002Fai-collab\u002Fscripts\u002Fpoll_chatlog.sh &\n\n# 5. Test the link\nbash ~\u002F.openclaw\u002Fworkspace\u002Fskills\u002Fai-collab\u002Fscripts\u002Fsend.sh \"Hello from Agent A\"\n```\n\n---\n\n## Communication Protocol\n\nEvery message between agents follows this format. **No open loops.**\n\n| Tag | Direction | Meaning |\n|-----|-----------|---------|\n| `[TASK:name]` | A→B or B→A | Assign a task |\n| `[ACK:name]` | receiver | Acknowledged, starting work |\n| `[DONE:name]` | executor | Task complete + one-line result |\n| `[BLOCKED:name]` | executor | Can't complete + reason |\n| `[HANDOFF:name]` | either | \"Do X, reply [DONE:name] when finished\" |\n| `[STATUS:update]` | either | Async update on long-running task |\n| `[QUESTION:topic]` | either | Needs info before proceeding |\n\n**Rules:**\n1. Answer questions before asking new ones\n2. Close tasks before starting new ones\n3. Every message moves work forward or closes a loop\n4. Never: \"let me know\", \"ready when you are\", \"standing by\"\n\n**Example exchange:**\n```\nA → B: [TASK:price-check] Get BTC price from CoinGecko\nB → A: [ACK:price-check] Checking now.\nB → A: [DONE:price-check] BTC $94,230 as of 03:15 UTC\n```\n\n---\n\n## Daemon Script (Agent B)\n\n`scripts\u002Fdaemon.sh` — drop in your collab directory:\n\n```bash\n#!\u002Fbin\u002Fbash\nPIDFILE=\"\u002Ftmp\u002Fagentb_daemon.pid\"\nif [ -f \"$PIDFILE\" ] && kill -0 \"$(cat $PIDFILE)\" 2>\u002Fdev\u002Fnull; then\n  echo \"Daemon already running (PID $(cat $PIDFILE)). Exiting.\" >&2\n  exit 1\nfi\necho $$ > \"$PIDFILE\"\ntrap \"rm -f $PIDFILE\" EXIT\n\n# Required: unset so nested claude --print works\nunset CLAUDECODE\n\nINBOX=\"$HOME\u002F.openclaw\u002Fworkspace\u002Fcollab\u002Finbox\"\nLOG=\"$HOME\u002F.openclaw\u002Fworkspace\u002Fcollab\u002Fchat.log\"\nmkdir -p \"$INBOX\"\n\nlogline() {\n  printf \"%s %s\\n\" \"$(date '+%Y-%m-%d %H:%M:%S')\" \"$1\" >> \"$LOG\"\n}\n\nlogline \"SYSTEM: Agent B daemon started\"\n\ninotifywait -m -e moved_to \"$INBOX\" 2>\u002Fdev\u002Fnull | while read dir event file; do\n  FULLPATH=\"$INBOX\u002F$file\"\n  [ ! -f \"$FULLPATH\" ] && continue\n\n  MSG=$(cat \"$FULLPATH\")\n  rm \"$FULLPATH\"\n\n  logline \"A -> B: $MSG\"\n\n  # Run Agent B (claude --print)\n  RESPONSE=$(claude --print --model claude-haiku-4-5-20251001 \\\n    \"You are Agent B. Agent A says: $MSG\nRespond in under 100 words. Use [DONE:taskname] or [BLOCKED:taskname] to close loops.\nContext: shared collab system. Chat log: $LOG\" 2>\u002Fdev\u002Fnull)\n\n  logline \"B -> A: $RESPONSE\"\n\n  # Route response back to Agent A\n  openclaw agent --agent main -m \"[AgentB]: $RESPONSE\" --json > \u002Fdev\u002Fnull 2>&1\ndone\n```\n\n---\n\n## Sending Messages (A → B)\n\n```bash\n# From Agent A, send to Agent B daemon inbox\nbash ~\u002F.openclaw\u002Fworkspace\u002Fskills\u002Fai-collab\u002Fscripts\u002Fsend.sh \"your message\"\n```\n\n**Atomic write pattern (prevents partial reads):**\n```bash\nINBOX=\"$HOME\u002F.openclaw\u002Fworkspace\u002Fcollab\u002Finbox\"\nTMPFILE=$(mktemp \"$INBOX\u002F.msg.XXXXXX\")\necho \"$*\" > \"$TMPFILE\"\nmv \"$TMPFILE\" \"$INBOX\u002Fmsg_$(date +%s%N).txt\"\n```\n\nAlways use `mktemp` + `mv` — never write directly to inbox. inotifywait fires on `moved_to`, not `close_write`.\n\n---\n\n## Chat Log Polling (B → A)\n\n`scripts\u002Fpoll_chatlog.sh` — run via cron every 60s:\n\n```bash\n#!\u002Fbin\u002Fbash\nLOG=\"$HOME\u002F.openclaw\u002Fworkspace\u002Fcollab\u002Fchat.log\"\nPTR_FILE=\"\u002Ftmp\u002Fchatlog_ptr\"\n\n[ ! -f \"$LOG\" ] && exit 0\n\nTOTAL=$(wc -l \u003C \"$LOG\")\nLAST=$(cat \"$PTR_FILE\" 2>\u002Fdev\u002Fnull || echo \"0\")\n[ \"$TOTAL\" -le \"$LAST\" ] && echo \"$TOTAL\" > \"$PTR_FILE\" && exit 0\n\nNEW=$(tail -n +\"$((LAST + 1))\" \"$LOG\" | grep \"B -> A:\" | sed 's\u002F.*B -> A: \u002F\u002F')\necho \"$TOTAL\" > \"$PTR_FILE\"\n[ -z \"$NEW\" ] && exit 0\n\nwhile IFS= read -r line; do\n  [ -z \"$line\" ] && continue\n  openclaw agent --agent main -m \"[AgentB]: $line\" --json > \u002Fdev\u002Fnull 2>&1\ndone \u003C\u003C\u003C \"$NEW\"\n```\n\nAdd to crontab:\n```\n* * * * * \u002Fbin\u002Fbash ~\u002F.openclaw\u002Fworkspace\u002Fcollab\u002Fpoll_chatlog.sh\n```\n\n---\n\n## Shared Filesystem Conventions\n\n```\n~\u002F.openclaw\u002Fworkspace\u002Fcollab\u002F\n  chat.log          # THE shared record — all messages logged here\n  inbox\u002F            # A→B message queue (atomic mv only)\n  .env              # Shared secrets (chmod 600, never log)\n  task_queue.md     # Optional: structured task backlog\n  status_tracker.md # Optional: current task status per agent\n```\n\n**Logging to chat.log:**\n```bash\nprintf \"%s %s\\n\" \"$(date '+%Y-%m-%d %H:%M:%S')\" \"A -> B: [TASK:name] Description\" >> \"$LOG\"\n```\n\n**Rules:**\n- Never log secrets from `.env`\n- Always timestamp every line\n- Prefix with sender: `A -> B:` or `B -> A:` or `SYSTEM:` or `JEREMY ->`\n\n---\n\n## Telegram Bridge (Optional)\n\nRoute user Telegram messages into Agent B's inbox. Full setup guide: `references\u002Ftelegram-bridge.md`\n\n**Quick summary:**\n1. Create a bot via [@BotFather](https:\u002F\u002Ft.me\u002FBotFather) → get `BOT_TOKEN`\n2. Add bot to your group → get `GROUP_ID` (negative number, e.g. `-1001234567890`)\n3. Disable Group Privacy Mode in BotFather so bot can read all messages\n4. Get your Telegram `USER_ID` from [@userinfobot](https:\u002F\u002Ft.me\u002Fuserinfobot)\n5. Set in `~\u002F.openclaw\u002F.env`: `TELEGRAM_BOT_TOKEN`, `TELEGRAM_GROUP_ID`, `TELEGRAM_USER_ID`\n6. Run the bridge in tmux: `tmux new-session -d -s tg-bridge \"bash references\u002Ftelegram-bridge.md\"`\n\n```bash\n# Minimal bridge loop (inline version):\nsource ~\u002F.openclaw\u002F.env\nOFFSET_FILE=\"\u002Ftmp\u002Ftg_offset\"\nwhile true; do\n  OFFSET=$(cat \"$OFFSET_FILE\" 2>\u002Fdev\u002Fnull || echo \"0\")\n  UPDATES=$(curl -s \"https:\u002F\u002Fapi.telegram.org\u002Fbot${TELEGRAM_BOT_TOKEN}\u002FgetUpdates?offset=$((OFFSET+1))&timeout=20\")\n  # Parse updates, drop user messages into inbox with USER: prefix\n  # See references\u002Ftelegram-bridge.md for full parsing implementation\n  sleep 1\ndone\n```\n\nSee `references\u002Ftelegram-bridge.md` for the complete production-ready implementation with message parsing, offset tracking, and error handling.\n\n---\n\n## Agent Configurations\n\nSee `examples\u002F` for full configs:\n\n### Claude ↔ Claude (Jim + Clawdy)\n- Agent A: `claude code` (interactive, full tool access)\n- Agent B: `claude --print claude-haiku-4-5-20251001` (fast, scripting-optimized)\n- Best for: heavy task parallelism, one agent researches while other implements\n\n### Claude ↔ GPT\n- Agent A: Claude Code (full tool use)\n- Agent B: `openai api chat.completions.create` via script\n- Best for: cross-model verification, Claude builds → GPT reviews\n\n### GPT ↔ GPT\n- Agent A: GPT-4o via `openai` CLI\n- Agent B: GPT-4o-mini for fast background checks\n- Best for: speed + cost optimization when all context is OpenAI\n\n---\n\n## Task Handoff Pattern\n\nWhen Agent A needs Agent B to own a task completely:\n\n```\nA → B: [HANDOFF:data-fetch] Fetch all BTC trades from Kraken API last 7 days.\n       Save to ~\u002F.openclaw\u002Fworkspace\u002Fcollab\u002Fkraken_trades.json.\n       Reply [DONE:data-fetch] when finished.\n\nB → A: [ACK:data-fetch] Fetching now.\nB → A: [DONE:data-fetch] 847 trades saved to kraken_trades.json. Date range: 2026-02-15 to 2026-02-22.\n```\n\nAgent A does not check on progress — waits for DONE or BLOCKED.\n\n---\n\n## Approval Pattern\n\nWhen Agent B's daemon needs user approval for a terminal command:\n\n```bash\n# From Agent A \u002F user terminal:\nbash ~\u002F.openclaw\u002Fworkspace\u002Fskills\u002Fai-collab\u002Fscripts\u002Fapprove.sh \"Yes\"\n# or for numbered selections:\nbash ~\u002F.openclaw\u002Fworkspace\u002Fskills\u002Fai-collab\u002Fscripts\u002Fapprove.sh \"2\"\n```\n\n`approve.sh` sends keystrokes to the tmux session running Agent B:\n```bash\nSESSION=$(tmux ls | grep agentb-session | head -1 | cut -d: -f1)\ntmux send-keys -t \"$SESSION\" \"$1\" Enter\n```\n\n---\n\n## Rate Limiting\n\nAgent B should implement a rate governor to prevent runaway API calls:\n\n```bash\n# In daemon loop, before calling claude --print:\nCALLS_FILE=\"\u002Ftmp\u002Fagentb_calls\"\nWINDOW=60  # seconds\nMAX_CALLS=10\n\n# Count calls in last window\nRECENT=$(awk -v cutoff=\"$(($(date +%s) - WINDOW))\" '$1 > cutoff' \"$CALLS_FILE\" 2>\u002Fdev\u002Fnull | wc -l)\nif [ \"$RECENT\" -ge \"$MAX_CALLS\" ]; then\n  logline \"SYSTEM: Rate limited — $RECENT calls in ${WINDOW}s\"\n  sleep 10\n  continue\nfi\ndate +%s >> \"$CALLS_FILE\"\n```\n\n---\n\n## Financial Gate Protocol (TIERED — updated 2026-02-22)\n\n**Three tiers based on amount:**\n\n| Tier | Amount | Rule |\n|------|--------|------|\n| 1 | Under $20 | Either agent acts independently — no approval needed |\n| 2 | $20–$50 | Both agents PROPOSE + APPROVE before acting |\n| 3 | Over $50 | Requires `[AUTHORIZED:financial:amount:timestamp:Jeremy]` tag |\n\n```bash\n# Tier 3 tag format (Jeremy must write to chat.log):\n[AUTHORIZED:financial:buy:BTC:$100:2026-02-22:Jeremy]\n\n# Tier 2 example flow:\n# Clawdy proposes: \"PROPOSE: buy $35 of SOL for DePIN gas — approve?\"\n# Jim approves:    \"APPROVED: buy $35 SOL\"\n# Then Clawdy acts.\n```\n\n**Daemon tiered gate logic:**\n```bash\n# \u003C$20: proceed. $20-50: flag as tier2. >$50: block without AUTHORIZED tag.\nAMOUNT=$(echo \"$MSG\" | grep -oP '[$]?\\d+' | head -1 | tr -d '$')\nif [ -n \"$AMOUNT\" ] && [ \"$AMOUNT\" -gt 50 ] && ! echo \"$MSG\" | grep -q \"\\[AUTHORIZED:financial:\"; then\n  logline \"BLOCKED:financial-gate:tier3 — amount>$50, no AUTHORIZED tag\"; continue\nelif [ -n \"$AMOUNT\" ] && [ \"$AMOUNT\" -ge 20 ]; then\n  logline \"FINANCIAL:tier2 — propose before acting\"\nfi\n```\n\nIf Tier 3 blocked: log `[BLOCKED:financial-gate:tier3]`, send Telegram alert, do NOT execute.\n\n---\n\n## Daemon Watchdog Pattern\n\nCheck daemon health every 15 minutes. If silent >15 min, restart:\n\n```bash\n# check_daemon.sh (add to crontab: *\u002F15 * * * *)\nPIDFILE=\"\u002Ftmp\u002Fagentb_daemon.pid\"\nLOG=\"$HOME\u002F.openclaw\u002Fworkspace\u002Fcollab\u002Fchat.log\"\n\n# Check PID alive\npid_alive=0\n[ -f \"$PIDFILE\" ] && kill -0 \"$(cat $PIDFILE)\" 2>\u002Fdev\u002Fnull && pid_alive=1\n\n# Check last activity within 15 min\nlast_ts=$(grep -oP '^\\d{4}-\\d{2}-\\d{2} \\d{2}:\\d{2}:\\d{2}' \"$LOG\" 2>\u002Fdev\u002Fnull | tail -1)\nrecent=0\nif [ -n \"$last_ts\" ]; then\n  age=$(( ($(date +%s) - $(date -d \"$last_ts\" +%s 2>\u002Fdev\u002Fnull || echo 0)) \u002F 60 ))\n  [ \"$age\" -lt 15 ] && recent=1\nfi\n\nif [ \"$pid_alive\" = \"0\" ] || [ \"$recent\" = \"0\" ]; then\n  tmux send-keys -t agentb-session \"bash daemon.sh\" Enter\nfi\n```\n\n---\n\n## Task Takeover Threshold\n\nIf Agent A (Jim) blocks on the same task **twice**, Agent B (Clawdy) takes it over:\n\n```\nB → A: [TASK:fetch-data] Fetch X. Reply [DONE:fetch-data].\n# 10 min timer...\nA → B: [BLOCKED:fetch-data] Can't access endpoint.\nB → A: [RETRY:fetch-data] Try alternate: curl -s https:\u002F\u002Fbackup-endpoint.com\u002Fx\n# Another 10 min...\nA → B: [BLOCKED:fetch-data] Still failing.\n# Clawdy takes over immediately:\nB: *executes task directly, logs [DONE:fetch-data] to chat.log*\n```\n\nRule: **Blocked 2x on same task → take it over, don't reassign.**\n\n---\n\n## Daemon Error Diagnosis\n\nWhen daemon produces blank\u002Ferror responses:\n\n1. Check `\u002Ftmp\u002Fclawdy_last_err` — contains last stderr from `claude --print`\n2. Check ANSI-stripped chat.log for `CLAWDY_ERR:` lines\n3. Verify RESPONSE trimming line not corrupted (common issue: accidentally set to `RESPONSE=\"\"`)\n4. Restart daemon: `kill $(cat \u002Ftmp\u002Fclawdy_daemon.pid) && sleep 1 && bash clawdy_daemon.sh`\n\n**Auto-approve**: Use `Bash(*)` in `~\u002F.claude\u002Fsettings.local.json`. **NEVER** use tmux send-keys cron — it sends keypresses blindly to the wrong sessions.\n",{"name":5,"description":7},"main","f9d3fe7cf9ac8f1ea63a0d96e98e1f510a3814db","skills\u002Fjeremysommerfeld8910-cpu\u002Fai-collab",1,"https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills","https:\u002F\u002Fgithub.com\u002Fjavimosch","intrane.fr","Building robust, open-source infrastructure for the commons. AI-leveraged, self-hosted, built to last.","2026-06-07 03:34:58",{"source":8,"skillName":5,"commands":34,"prompt":44,"zipAvailable":45},[35,38,41],{"tool":36,"command":37},"npx","npx skills add javimosch\u002Fopen-claw-skills --skill ai-collab",{"tool":39,"command":40},"bunx","bunx skills add javimosch\u002Fopen-claw-skills --skill ai-collab",{"tool":42,"command":43},"pnpm","pnpm dlx skills add javimosch\u002Fopen-claw-skills --skill ai-collab","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Fjeremysommerfeld8910-cpu\u002Fai-collab\u002FSKILL.md",true,[],[48,56,63,70,77,84],{"skillNo":49,"name":50,"nameZh":6,"description":51,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":52,"categories":53,"keywords":54,"publishedAt":55},"01M778GGXG2VQ0YF31W2MKGMQZ","crowd-prompting","A marketplace where AI agents improve prompts, system instructions, tool descriptions, and other text-based content with domain expertise from real-world operations — and earn tokens for valuable contributions.","https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzzadrian\u002Fcrowd-prompting\u002FSKILL.md",[],[],"2026-11-15 14:19:17",{"skillNo":57,"name":58,"nameZh":6,"description":59,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":60,"categories":61,"keywords":62,"publishedAt":55},"01M778G7BH8SBJ9FJ6C3G7CB1K","ceaser","Interact with the Ceaser privacy protocol on Base L2 using the ceaser-mcp MCP tools. This skill uses the ceaser-mcp npm package for ALL operations -- shield, unshield, note management, and protocol queries. All ceaser tool calls use CLI subcommands (npx -y ceaser-mcp \u003Csubcommand>). Ceaser is a privacy-preserving ETH wrapper using Noir\u002FUltraHonk zero-knowledge proofs on Base L2 (chain ID 8453).","https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzyra-v21\u002Fceaser\u002FSKILL.md",[],[],{"skillNo":64,"name":65,"nameZh":6,"description":66,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":67,"categories":68,"keywords":69,"publishedAt":55},"01M778FYCJQZWFKKX5FYMK3S47","ceaser-send","Fully automated private ETH transfer via Ceaser Protocol on Base L2 using the ceaser-mcp MCP tools. This skill uses the ceaser-mcp npm package for ALL operations -- all ceaser tool calls use CLI subcommands (npx -y ceaser-mcp \u003Csubcommand>). WARNING -- creates observable on-chain links between user wallet and hot wallet (see Privacy Warning). Generates an ephemeral hot wallet with BIP-39 mnemonic recovery, user funds it, agent signs and broadcasts the Shield TX automatically. Exactly one manual step required (funding the hot wallet with ETH). Uses Noir\u002FUltraHonk zero-knowledge proofs.","https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzyra-v21\u002Fceaser-send\u002FSKILL.md",[],[],{"skillNo":71,"name":72,"nameZh":6,"description":73,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":74,"categories":75,"keywords":76,"publishedAt":55},"01M778FQQNSEYA3HJKZBPQ4M9Z","dilemm-ai","Compete in DilemmAI, the prisoner's dilemma AI arena at dilemm.ai. Use when an OpenClaw agent wants to create an account, design and submit strategy prompts for their bot, enter matchmaking, analyze historical matches and leaderboards, and iterate on bot strategy. Requires headless browser automation (no API available yet).","https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzyori\u002Fdilemm-ai\u002FSKILL.md",[],[],{"skillNo":78,"name":79,"nameZh":6,"description":80,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":81,"categories":82,"keywords":83,"publishedAt":55},"01M778FGVZX7QA2TF9BFMM37FY","moldium","Post and manage content on the Moldium blog platform. Triggered by \"post to Moldium\", \"write a blog post\", \"publish an article\", etc.","https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzyom45\u002Fmoldium\u002FSKILL.md",[],[],{"skillNo":85,"name":86,"nameZh":6,"description":87,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":88,"categories":89,"keywords":90,"publishedAt":55},"01M778F88D8PQ9MQ0KNW2TJ8ZH","arxiv-paper-reviews","Interact with arXiv Crawler API to fetch papers, read reviews, submit comments, search papers, and import papers. Use when working with arXiv papers, fetching paper lists by date\u002Fcategory\u002Finterest, viewing paper details with comments, submitting paper reviews, searching papers by title, or importing papers from arXiv URLs via API at http:\u002F\u002Fweakaccept.top:8000\u002F.","https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzxrys\u002Farxiv-paper-reviews\u002FSKILL.md",[],[]]