{
  "schemaVersion": "1.0",
  "item": {
    "slug": "mailbox-bot",
    "name": "mailbox.bot",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/arbengine/mailbox-bot",
    "canonicalUrl": "https://clawhub.ai/arbengine/mailbox-bot",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/mailbox-bot",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=mailbox-bot",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "README.md",
      "SKILL.md"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-07T17:22:31.273Z",
      "expiresAt": "2026-05-14T17:22:31.273Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report",
        "contentDisposition": "attachment; filename=\"afrexai-annual-report-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/mailbox-bot"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/mailbox-bot",
    "agentPageUrl": "https://openagent3.xyz/skills/mailbox-bot/agent",
    "manifestUrl": "https://openagent3.xyz/skills/mailbox-bot/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/mailbox-bot/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "mailbox.bot",
        "body": "Get a shipping address for your AI agent.\n\nSpin up a physical logistics endpoint for your agents. Receive from FedEx, UPS, DHL, Amazon. Scan, webhook, store, forward — a fulfillment node your agent can call like any other API."
      },
      {
        "title": "Agent protocol support",
        "body": "MCP — Model Context Protocol\nA2A — Agent-to-Agent discovery\nOpenClaw — Agent discovery via /.well-known/agent.json\nREST — Standard RESTful API"
      },
      {
        "title": "What your agent gets",
        "body": "A micro fulfillment node your agent controls via API.\n\nA facility that receives for your agent — Your agent gets a reference code and a real address at our warehouse. Packages ship here from any private carrier — held as bailee until your agent acts.\n\nEvery package scanned & photographed — Weight, dimensions, carrier, tracking, high-res photos. Structured data the moment it arrives — no commingling.\n\nInstant webhook notifications — Webhook fires with a JSON payload the second a package arrives. Your agent decides: forward, store, scan, or return.\n\nReturns go back automatically — Outbound shipments get a return destination. Returns route back to your agent via reference code — no manual intervention."
      },
      {
        "title": "How it works",
        "body": "Verify & get your reference code — KYC via Stripe Identity. Your agent gets a unique shipping address at our warehouse.\nShip packages to your agent — Use our facility address + your reference code at checkout. All major private carriers.\nWe receive & document — Every package scanned, weighed, photographed. Structured data the moment it arrives.\nYour agent decides what's next — Webhook fires instantly with photos, tracking, metadata. Forward, store, scan, or return."
      },
      {
        "title": "Use cases",
        "body": "Hardware procurement — Agents that order, receive, and inventory components, sensors, boards, cables, and equipment\nAutonomous logistics — Operations agents that reorder when stock runs low and route incoming shipments automatically\nEdge infrastructure — Servers, sensors, networking gear, field devices — received, documented, and staged\nDocument intake — Legal and financial agents receiving physical contracts and filings via private courier, scanned as structured data\nReturn handling — Using the physical endpoint as a return shipment destination, with returns automatically routed back to the agent\nPackage forwarding — Agents that receive packages at the facility and autonomously request forwarding to end destinations"
      },
      {
        "title": "Private carriers only (v1.0)",
        "body": "We do NOT accept USPS mail. This is a package receiving facility, not a mail service or CMRA. Any USPS deliveries will be returned to sender. We accept packages from FedEx, UPS, DHL, Amazon, OnTrac, LaserShip, GSO, Spee-Dee, and other private carriers only. Your property, held as bailee."
      },
      {
        "title": "Current status: v1.0 — Live",
        "body": "Available now:\n\nWaitlist signup via /api/v1/waitlist (no auth required)\nFull onboarding: KYC, plan selection, payment, agent creation\nOperator Dashboard for human oversight\nREST API with package tracking, photos, forwarding\nWebhook notifications on package arrival\nAgent protocol support (MCP, A2A, OpenClaw, REST)"
      },
      {
        "title": "When to use this skill",
        "body": "Trigger this skill when user says:\n\n\"I need a shipping address for my agent\"\n\"Can my agent receive packages?\"\n\"How do I receive packages through an API?\"\n\"My agent needs to order physical hardware\"\n\"Can my agent handle returns and RMAs?\"\n\"I need a fulfillment node for my agent\"\n\"How do I get webhook notifications for package arrivals?\"\n\"Can my agent forward packages?\"\n\nWhat to do:\n\nExplain the vision — mailbox.bot gives your agent a physical shipping address at our warehouse. Packages from FedEx, UPS, DHL, Amazon arrive, get scanned, photographed, and your agent gets a JSON webhook instantly. Forward, store, scan, or return — all via API.\nCheck if they have an API key — If MAILBOX_BOT_API_KEY is set, use the live API endpoints below.\nIf no API key — Add them to the waitlist via /api/v1/waitlist and let them know early access members go first."
      },
      {
        "title": "Configuration",
        "body": "Optional (for members with API access):\n\nexport MAILBOX_BOT_API_KEY=\"your_api_key_here\"\n\nGet your API key at https://mailbox.bot/dashboard/api-keys (after onboarding)."
      },
      {
        "title": "1. Join waitlist (no auth required)",
        "body": "curl -X POST https://mailbox.bot/api/v1/waitlist \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"email\": \"agent@yourcompany.com\"}'\n\nResponse:\n\n{\n  \"success\": true,\n  \"message\": \"You're on the waitlist. We'll notify you when we launch.\"\n}\n\nRate limit: 30 requests/minute per IP."
      },
      {
        "title": "2. List packages (authenticated)",
        "body": "curl -s https://mailbox.bot/api/v1/packages \\\n  -H \"Authorization: Bearer $MAILBOX_BOT_API_KEY\"\n\nResponse:\n\n{\n  \"packages\": [\n    {\n      \"id\": \"pkg_abc123\",\n      \"mailbox_id\": \"MB-7F3A\",\n      \"tracking_number\": \"794644790132\",\n      \"carrier\": \"fedex\",\n      \"status\": \"received\",\n      \"weight_oz\": 12.4,\n      \"dimensions\": { \"l\": 12, \"w\": 8, \"h\": 6 },\n      \"received_at\": \"2026-02-09T14:32:00Z\",\n      \"photos_count\": 3\n    }\n  ],\n  \"pagination\": {\n    \"total\": 1,\n    \"limit\": 20,\n    \"offset\": 0,\n    \"has_more\": false\n  }\n}"
      },
      {
        "title": "3. Get package detail (authenticated)",
        "body": "curl -s https://mailbox.bot/api/v1/packages/pkg_abc123 \\\n  -H \"Authorization: Bearer $MAILBOX_BOT_API_KEY\"\n\nResponse includes:\n\nFull package metadata (carrier, tracking, weight, dimensions)\nArray of high-res photo URLs\nExtracted label data (sender, tracking, carrier)\nContent scan results (if requested)\nForwarding history if applicable"
      },
      {
        "title": "4. Request forwarding (authenticated)",
        "body": "curl -X POST https://mailbox.bot/api/v1/packages/pkg_abc123/forward \\\n  -H \"Authorization: Bearer $MAILBOX_BOT_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"address\": {\n      \"name\": \"John Doe\",\n      \"street1\": \"456 Destination Ave\",\n      \"city\": \"Austin\",\n      \"state\": \"TX\",\n      \"zip\": \"78701\"\n    },\n    \"carrier\": \"fedex\",\n    \"service_level\": \"ground\"\n  }'"
      },
      {
        "title": "Webhook payload",
        "body": "When a package arrives, we POST structured data to your agent's webhook URL:\n\n{\n  \"event\": \"package.received\",\n  \"ref\": \"MB-7F3A\",\n  \"carrier\": \"fedex\",\n  \"tracking\": \"794644790132\",\n  \"weight_oz\": 12.4,\n  \"dimensions\": { \"l\": 12, \"w\": 8, \"h\": 6 },\n  \"photos\": [\"https://cdn.mailbox.bot/...\"],\n  \"received_at\": \"2026-02-09T14:32:00Z\"\n}"
      },
      {
        "title": "Pricing",
        "body": "PlanPriceWhat you getEndpoint OnlyFreeLogistics endpoint, return routing, webhook notifications, REST API, agent endpointReceiver$10/moEndpoint + private carrier receiving. 5 packages/mo, photo docs, webhook on arrival, 14-day bailee storage. Extra packages $5 eachSwarm$25/mo5 physical endpoints, 25 packages/mo, content scanning, 30-day storage, forwarding, consolidation, dedicated supportEnterpriseCustomUnlimited endpoints, unlimited packages, custom processing rules, SLA, reserved facility space, 24/7 support\n\nEarly access for waitlist members."
      },
      {
        "title": "Links",
        "body": "Website: https://mailbox.bot\nDashboard: https://mailbox.bot/dashboard\nAPI Docs: https://mailbox.bot/api-docs\nImplementation: https://mailbox.bot/implementation\nSupport: support@mailbox.bot"
      },
      {
        "title": "For OpenClaw Agent Developers",
        "body": "This skill enables your agent to:\n\nProvision a physical shipping address at our warehouse\nReceive packages from all major private carriers\nAccess high-res photos and structured metadata on arrival\nGet instant webhook notifications with JSON payload\nRequest forwarding, content scanning, or returns via API\nDiscover and communicate via MCP, A2A, OpenClaw, REST protocols\n\nThe mailbox.bot API is RESTful, returns structured JSON, and works with any HTTP client. No SDK required."
      }
    ],
    "body": "mailbox.bot\n\nGet a shipping address for your AI agent.\n\nSpin up a physical logistics endpoint for your agents. Receive from FedEx, UPS, DHL, Amazon. Scan, webhook, store, forward — a fulfillment node your agent can call like any other API.\n\nAgent protocol support\nMCP — Model Context Protocol\nA2A — Agent-to-Agent discovery\nOpenClaw — Agent discovery via /.well-known/agent.json\nREST — Standard RESTful API\nWhat your agent gets\n\nA micro fulfillment node your agent controls via API.\n\nA facility that receives for your agent — Your agent gets a reference code and a real address at our warehouse. Packages ship here from any private carrier — held as bailee until your agent acts.\n\nEvery package scanned & photographed — Weight, dimensions, carrier, tracking, high-res photos. Structured data the moment it arrives — no commingling.\n\nInstant webhook notifications — Webhook fires with a JSON payload the second a package arrives. Your agent decides: forward, store, scan, or return.\n\nReturns go back automatically — Outbound shipments get a return destination. Returns route back to your agent via reference code — no manual intervention.\n\nHow it works\nVerify & get your reference code — KYC via Stripe Identity. Your agent gets a unique shipping address at our warehouse.\nShip packages to your agent — Use our facility address + your reference code at checkout. All major private carriers.\nWe receive & document — Every package scanned, weighed, photographed. Structured data the moment it arrives.\nYour agent decides what's next — Webhook fires instantly with photos, tracking, metadata. Forward, store, scan, or return.\nUse cases\nHardware procurement — Agents that order, receive, and inventory components, sensors, boards, cables, and equipment\nAutonomous logistics — Operations agents that reorder when stock runs low and route incoming shipments automatically\nEdge infrastructure — Servers, sensors, networking gear, field devices — received, documented, and staged\nDocument intake — Legal and financial agents receiving physical contracts and filings via private courier, scanned as structured data\nReturn handling — Using the physical endpoint as a return shipment destination, with returns automatically routed back to the agent\nPackage forwarding — Agents that receive packages at the facility and autonomously request forwarding to end destinations\nPrivate carriers only (v1.0)\n\nWe do NOT accept USPS mail. This is a package receiving facility, not a mail service or CMRA. Any USPS deliveries will be returned to sender. We accept packages from FedEx, UPS, DHL, Amazon, OnTrac, LaserShip, GSO, Spee-Dee, and other private carriers only. Your property, held as bailee.\n\nCurrent status: v1.0 — Live\n\nAvailable now:\n\nWaitlist signup via /api/v1/waitlist (no auth required)\nFull onboarding: KYC, plan selection, payment, agent creation\nOperator Dashboard for human oversight\nREST API with package tracking, photos, forwarding\nWebhook notifications on package arrival\nAgent protocol support (MCP, A2A, OpenClaw, REST)\nWhen to use this skill\n\nTrigger this skill when user says:\n\n\"I need a shipping address for my agent\"\n\"Can my agent receive packages?\"\n\"How do I receive packages through an API?\"\n\"My agent needs to order physical hardware\"\n\"Can my agent handle returns and RMAs?\"\n\"I need a fulfillment node for my agent\"\n\"How do I get webhook notifications for package arrivals?\"\n\"Can my agent forward packages?\"\n\nWhat to do:\n\nExplain the vision — mailbox.bot gives your agent a physical shipping address at our warehouse. Packages from FedEx, UPS, DHL, Amazon arrive, get scanned, photographed, and your agent gets a JSON webhook instantly. Forward, store, scan, or return — all via API.\nCheck if they have an API key — If MAILBOX_BOT_API_KEY is set, use the live API endpoints below.\nIf no API key — Add them to the waitlist via /api/v1/waitlist and let them know early access members go first.\nConfiguration\n\nOptional (for members with API access):\n\nexport MAILBOX_BOT_API_KEY=\"your_api_key_here\"\n\n\nGet your API key at https://mailbox.bot/dashboard/api-keys (after onboarding).\n\nAPI Endpoints\n1. Join waitlist (no auth required)\ncurl -X POST https://mailbox.bot/api/v1/waitlist \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"email\": \"agent@yourcompany.com\"}'\n\n\nResponse:\n\n{\n  \"success\": true,\n  \"message\": \"You're on the waitlist. We'll notify you when we launch.\"\n}\n\n\nRate limit: 30 requests/minute per IP.\n\n2. List packages (authenticated)\ncurl -s https://mailbox.bot/api/v1/packages \\\n  -H \"Authorization: Bearer $MAILBOX_BOT_API_KEY\"\n\n\nResponse:\n\n{\n  \"packages\": [\n    {\n      \"id\": \"pkg_abc123\",\n      \"mailbox_id\": \"MB-7F3A\",\n      \"tracking_number\": \"794644790132\",\n      \"carrier\": \"fedex\",\n      \"status\": \"received\",\n      \"weight_oz\": 12.4,\n      \"dimensions\": { \"l\": 12, \"w\": 8, \"h\": 6 },\n      \"received_at\": \"2026-02-09T14:32:00Z\",\n      \"photos_count\": 3\n    }\n  ],\n  \"pagination\": {\n    \"total\": 1,\n    \"limit\": 20,\n    \"offset\": 0,\n    \"has_more\": false\n  }\n}\n\n3. Get package detail (authenticated)\ncurl -s https://mailbox.bot/api/v1/packages/pkg_abc123 \\\n  -H \"Authorization: Bearer $MAILBOX_BOT_API_KEY\"\n\n\nResponse includes:\n\nFull package metadata (carrier, tracking, weight, dimensions)\nArray of high-res photo URLs\nExtracted label data (sender, tracking, carrier)\nContent scan results (if requested)\nForwarding history if applicable\n4. Request forwarding (authenticated)\ncurl -X POST https://mailbox.bot/api/v1/packages/pkg_abc123/forward \\\n  -H \"Authorization: Bearer $MAILBOX_BOT_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"address\": {\n      \"name\": \"John Doe\",\n      \"street1\": \"456 Destination Ave\",\n      \"city\": \"Austin\",\n      \"state\": \"TX\",\n      \"zip\": \"78701\"\n    },\n    \"carrier\": \"fedex\",\n    \"service_level\": \"ground\"\n  }'\n\nWebhook payload\n\nWhen a package arrives, we POST structured data to your agent's webhook URL:\n\n{\n  \"event\": \"package.received\",\n  \"ref\": \"MB-7F3A\",\n  \"carrier\": \"fedex\",\n  \"tracking\": \"794644790132\",\n  \"weight_oz\": 12.4,\n  \"dimensions\": { \"l\": 12, \"w\": 8, \"h\": 6 },\n  \"photos\": [\"https://cdn.mailbox.bot/...\"],\n  \"received_at\": \"2026-02-09T14:32:00Z\"\n}\n\nPricing\nPlan\tPrice\tWhat you get\nEndpoint Only\tFree\tLogistics endpoint, return routing, webhook notifications, REST API, agent endpoint\nReceiver\t$10/mo\tEndpoint + private carrier receiving. 5 packages/mo, photo docs, webhook on arrival, 14-day bailee storage. Extra packages $5 each\nSwarm\t$25/mo\t5 physical endpoints, 25 packages/mo, content scanning, 30-day storage, forwarding, consolidation, dedicated support\nEnterprise\tCustom\tUnlimited endpoints, unlimited packages, custom processing rules, SLA, reserved facility space, 24/7 support\n\nEarly access for waitlist members.\n\nLinks\nWebsite: https://mailbox.bot\nDashboard: https://mailbox.bot/dashboard\nAPI Docs: https://mailbox.bot/api-docs\nImplementation: https://mailbox.bot/implementation\nSupport: support@mailbox.bot\nFor OpenClaw Agent Developers\n\nThis skill enables your agent to:\n\nProvision a physical shipping address at our warehouse\nReceive packages from all major private carriers\nAccess high-res photos and structured metadata on arrival\nGet instant webhook notifications with JSON payload\nRequest forwarding, content scanning, or returns via API\nDiscover and communicate via MCP, A2A, OpenClaw, REST protocols\n\nThe mailbox.bot API is RESTful, returns structured JSON, and works with any HTTP client. No SDK required."
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/arbengine/mailbox-bot",
    "publisherUrl": "https://clawhub.ai/arbengine/mailbox-bot",
    "owner": "arbengine",
    "version": "2.0.1",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/mailbox-bot",
    "downloadUrl": "https://openagent3.xyz/downloads/mailbox-bot",
    "agentUrl": "https://openagent3.xyz/skills/mailbox-bot/agent",
    "manifestUrl": "https://openagent3.xyz/skills/mailbox-bot/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/mailbox-bot/agent.md"
  }
}