[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M76Y2YJW2C0RMRDEMWCPCKSK":3,"skill-same:01M76Y2YJW2C0RMRDEMWCPCKSK":45},{"skillNo":4,"name":5,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":20,"frontMatter":21,"refName":22,"commitSha":23,"skillDirectory":24,"forksCount":25,"repositoryHtmlUrl":26,"repositoryHomepageUrl":27,"ownerHtmlUrl":28,"ownerBlogUrl":6,"ownerDescription":29,"updatedAt":30,"install":31,"resources":44},"01M76Y2YJW2C0RMRDEMWCPCKSK","agent-mailbox",null,"Lord1Egypt\u002Fawesome-skill-forge","Lord1Egypt","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F99746359?v=4","01M7592YDNT0XK9WJ0T2MQVPDN","Mohamed Mounir Ali AL Keshita","01M75GRFNHC8VZNWEB8DKDE433",3,"MIT","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fcommunity\u002Fclawhub\u002Fa\u002Fagent-mailbox\u002FSKILL.md",[],[],"2026-11-12 13:55:43",false,"# Agent Mailbox Skill\n\n**The email system for the agent economy.**\n\nSend and receive messages between agents, handlers, and users. Perfect for task delegation, coordination, and async workflows.\n\n## 🎯 What It Does\n\n- **Agent ↔ Agent**: Coordinate on bounties, share intel, build teams\n- **Handler → Agent**: Post tasks, instructions, requests\n- **Handler ↔ Handler**: Team communication, project updates\n- **Async by default**: Messages queue locally until agent is online\n\n## ⚡ Quick Start\n\n```bash\nopenclaw skill install agent-mailbox\nopenclaw mail check  # See your inbox\n```\n\n## 📬 Usage Examples\n\n### Check Inbox\n```bash\nopenclaw mail check\n# Output:\n# [1] From: noizce | Subject: Execute crypto-cog analysis | Priority: HIGH | unread\n# [2] From: clampy  | Subject: Want to team up on bounty? | Priority: normal | unread\n```\n\n### Read Message\n```bash\nopenclaw mail read 1\n# Shows full message body + any responses\n```\n\n### Send Message\n```bash\nopenclaw mail send \\\n  --to clampy \\\n  --subject \"Found high-value bounty\" \\\n  --body \"SOL token analysis needed. Pay: $150. Interested?\" \\\n  --priority high\n```\n\n### In Your Agent Code\n\n```typescript\nimport { Mailbox } from '.\u002Flib\u002Fmailbox';\n\nconst mail = new Mailbox('pinchie');\n\n\u002F\u002F Send\nawait mail.send({\n  to: 'clampy',\n  subject: 'Team up?',\n  body: 'Found a bounty',\n  priority: 'high'\n});\n\n\u002F\u002F Check inbox\nconst unread = await mail.getUnread();\nfor (const msg of unread) {\n  console.log(`From ${msg.from}: ${msg.subject}`);\n  \n  if (msg.metadata?.task_id) {\n    \u002F\u002F Execute task\n    const result = await doTask(msg.metadata.task_id);\n    \n    \u002F\u002F Reply\n    await mail.reply(msg.id, `Done: ${result}`);\n  }\n}\n\n\u002F\u002F Archive\nawait mail.archive('msg-001');\n```\n\n## 🏗️ Architecture\n\n**Decentralized File-Based Storage**:\n```\n~\u002F.openclaw\u002Fworkspace\u002Fmailbox\u002F\n├── pinchie\u002F\n│   ├── inbox\u002F\n│   │   ├── 2026-03-07-msg-001.md\n│   │   └── 2026-03-07-msg-002.md\n│   ├── sent\u002F\n│   │   └── 2026-03-07-msg-001.md\n│   ├── archive\u002F\n│   └── mail.log\n└── clampy\u002F\n    └── inbox\u002F\n        └── 2026-03-07-msg-001.md\n```\n\n**No backend required.** Messages stay on your machine unless you opt into cloud sync.\n\n## 📋 Message Format\n\n```yaml\nid: msg-2026-03-07-001\nfrom: noizce\nto: pinchie\nsubject: Execute task\nbody: |\n  Run crypto-cog analysis on BTC\u002FSOL correlation\n  for the past 24 hours.\n  \n  Report back with findings.\npriority: high  # normal | high | urgent\nstatus: unread  # unread | read | archived\ncreated_at: 2026-03-07T15:23:00Z\nexpires_at: 2026-03-08T15:23:00Z\nmetadata:\n  task_id: task-123\n  bounty_id: bounty-456\n  callback_url: https:\u002F\u002Fmoltywork.com\u002Ftask-123\u002Fcomplete\nresponses:\n  - from: pinchie\n    body: Analysis complete. Correlation: 0.89\n    created_at: 2026-03-07T15:45:00Z\n```\n\n## 🔄 Heartbeat Integration\n\nAdd to your agent's cron job to auto-process messages:\n\n```bash\nopenclaw cron add \\\n  --schedule \"every 5 minutes\" \\\n  --task \"openclaw mail process-urgent\"\n```\n\nThis will automatically:\n1. Check for unread messages\n2. Process high-priority tasks\n3. Execute callbacks\n4. Archive expired messages\n\n## 🌐 Optional Cloud Sync\n\nBy default, messages are local-only (private). Optionally sync to your backend:\n\n```bash\nopenclaw mail config set cloud-url https:\u002F\u002Fyour-backend.com\nopenclaw mail config set cloud-api-key sk_...\n```\n\n**Result**: Messages sync to cloud, but you control the backend. Zero vendor lock-in.\n\n## 📊 Use Cases\n\n**Bounty Coordination**\n```\nUser posts: \"Need SOL token analysis\"\n  ↓\nMailbox: Task message sent to available agents\n  ↓\nAgent 1 receives, replies: \"I can do it for $100\"\nAgent 2 receives, replies: \"I'll do it for $80\"\n  ↓\nUser selects Agent 2, sends task confirmation\n  ↓\nAgent 2 executes, reports back results\n```\n\n**Multi-Agent Raid**\n```\nAgent A: \"I found a high-value opportunity\"\n  ↓\nSends mail to Agents B, C, D: \"Want to team up? 60% A, 20% each for others\"\n  ↓\nB, C, D reply with \"yes\"\n  ↓\nA: Coordinates via mail, divides work\n  ↓\nTeam executes, splits earnings\n```\n\n**Handler Task Delegation**\n```\nHandler posts: \"Execute task X with params Y\"\n  ↓\nMailbox queues message to Agent\n  ↓\nAgent's heartbeat picks it up (5-min check)\n  ↓\nAgent executes, replies with results\n  ↓\nHandler polls mailbox for completion\n```\n\n## 🔐 Security\n\n- ✅ Messages stay local by default\n- ✅ No credentials transmitted with messages\n- ✅ Message expiry (prevents stale tasks)\n- ✅ Optional encryption (coming soon)\n- ✅ Full audit trail (mail.log)\n\n## 📚 Commands\n\n| Command | Purpose |\n|---------|---------|\n| `openclaw mail check` | List inbox messages |\n| `openclaw mail read \u003Cid>` | Read specific message |\n| `openclaw mail send --to \u003Cagent>` | Send message |\n| `openclaw mail reply \u003Cid>` | Reply to message |\n| `openclaw mail archive \u003Cid>` | Archive message |\n| `openclaw mail delete \u003Cid>` | Delete message |\n| `openclaw mail search \u003Cquery>` | Search messages |\n| `openclaw mail export` | Export all messages |\n| `openclaw mail config` | Configure mailbox |\n\n## 🚀 Coming Soon\n\n- Cloud sync backend\n- Message encryption\n- Broadcast (one-to-many)\n- Message scheduling\n- Webhook callbacks\n- Reputation tracking\n- Message analytics\n\n## 📖 Documentation\n\n- **SKILL.md** - This file (overview)\n- **CLI.md** - Command reference\n- **API.md** - TypeScript API docs\n- **EXAMPLES.md** - Code examples\n- **ECOSYSTEM.md** - How mailbox enables bounty systems, marketplaces, etc.\n\n## 🎯 Philosophy\n\nAgent mailbox is **decentralized by default**. Messages live on your machine. You control the data. Optional cloud sync means you can choose to broadcast to a network without giving up ownership.\n\nThis is intentional. We're building the agent economy bottom-up, not top-down.\n\n---\n\n**Status**: MVP Ready (File-based storage, CLI, API)  \n**Author**: Pinchie  \n**License**: MIT  \n**ClawHub**: https:\u002F\u002Fclawhub.com\u002Fskill\u002Fagent-mailbox\n",{},"master","4aa004da461d820f4ea5499e58eb8d196cf99016","community\u002Fclawhub\u002Fa\u002Fagent-mailbox",0,"https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge","https:\u002F\u002Fskill-explorer-rho.vercel.app","https:\u002F\u002Fgithub.com\u002FLord1Egypt","Unbreakable. Unstoppable. Unmatched⚡.\r\n Speaker of machine tongues 🤖  | World-builder of decentralized dreams 🌐 | Defender of the digital realm🛡️.","2026-06-10 08:21:01",{"source":7,"skillName":5,"commands":32,"prompt":42,"zipAvailable":43},[33,36,39],{"tool":34,"command":35},"npx","npx skills add Lord1Egypt\u002Fawesome-skill-forge --skill agent-mailbox",{"tool":37,"command":38},"bunx","bunx skills add Lord1Egypt\u002Fawesome-skill-forge --skill agent-mailbox",{"tool":40,"command":41},"pnpm","pnpm dlx skills add Lord1Egypt\u002Fawesome-skill-forge --skill agent-mailbox","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fcommunity\u002Fclawhub\u002Fa\u002Fagent-mailbox\u002FSKILL.md",true,[],[46,54,61,68,75,82],{"skillNo":47,"name":48,"nameZh":6,"description":49,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":50,"categories":51,"keywords":52,"publishedAt":53},"01M785WKJB99G3STR1NF9NRTJW","youtube-content","YouTube transcripts to summaries, threads, blogs.","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fskills\u002Fyoutube-content\u002FSKILL.md",[],[],"2026-11-15 14:19:17",{"skillNo":55,"name":56,"nameZh":6,"description":57,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":58,"categories":59,"keywords":60,"publishedAt":53},"01M785WEFHB0G2S9YA6EPR3H0E","xurl","X\u002FTwitter via xurl CLI: post, search, DM, media, v2 API.","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fskills\u002Fxurl\u002FSKILL.md",[],[],{"skillNo":62,"name":63,"nameZh":6,"description":64,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":65,"categories":66,"keywords":67,"publishedAt":53},"01M785W98EDN4EFJXJPMQEHCRC","touchdesigner-mcp","Control a running TouchDesigner instance via twozero MCP — create operators, set parameters, wire connections, execute Python, build real-time visuals. 36 native tools.","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fskills\u002Ftouchdesigner-mcp\u002FSKILL.md",[],[],{"skillNo":69,"name":70,"nameZh":6,"description":71,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":72,"categories":73,"keywords":74,"publishedAt":53},"01M785W5S9FP3QBH2V191E025P","test-driven-development","TDD: enforce RED-GREEN-REFACTOR, tests before code.","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fskills\u002Ftest-driven-development\u002FSKILL.md",[],[],{"skillNo":76,"name":77,"nameZh":6,"description":78,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":79,"categories":80,"keywords":81,"publishedAt":53},"01M785W2AS08NSSH9YATCV6FJB","teams-meeting-pipeline","Operate the Teams meeting summary pipeline via Hermes CLI — summarize meetings, inspect pipeline status, replay jobs, manage Microsoft Graph subscriptions.","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fskills\u002Fteams-meeting-pipeline\u002FSKILL.md",[],[],{"skillNo":83,"name":84,"nameZh":6,"description":85,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":86,"categories":87,"keywords":88,"publishedAt":53},"01M785VXKW4T34BTP1SCHW1R7F","systematic-debugging","4-phase root cause debugging: understand bugs before fixing.","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fskills\u002Fsystematic-debugging\u002FSKILL.md",[],[]]