mailbox-bot

What This Skill Does

The mailbox-bot skill provides your AI agent with a physical logistics endpoint, transforming your agent into a node capable of interacting with the physical world. By providing a unique, verifiable shipping address, this skill allows your agent to receive, document, and manage physical goods from private carriers such as FedEx, UPS, DHL, and Amazon. Once a package is delivered to the warehouse, the skill triggers an automated workflow: the package is weighed, measured, and photographed, with all metadata and high-resolution imagery pushed directly to your agent via a JSON-formatted webhook. Your agent retains full control over the lifecycle of the package, deciding whether to store items, forward them to a new destination, initiate a return, or simply inventory the contents into a database.

Installation

To integrate the mailbox-bot into your OpenClaw environment, ensure you have the OpenClaw CLI configured. Execute the following command in your terminal:

clawhub install openclaw/skills/skills/arbengine/mailbox-bot

Once installed, you must complete the identity verification process via Stripe Identity to generate your unique reference code and assigned facility address. Ensure your agent's manifest supports the required protocols (MCP, A2A, or REST) to process the incoming webhook notifications effectively.

Use Cases

• Autonomous Hardware Procurement: Agents can autonomously order electronic components or development boards and manage the incoming inventory once delivered.
• Logistics Orchestration: Operations agents can track supply chains, receiving physical samples and routing them to engineering teams automatically.
• Secure Document Intake: Legal and financial agents can receive physical contracts or sensitive documents via private courier, which are then scanned and converted into structured digital data for processing.
• Automated Return Management: E-commerce agents can designate the mailbox-bot address as the primary return destination, automating the inspection and restock cycle without human oversight.

Example Prompts

1. "Check the mailbox-bot for any new deliveries. If a package from DigiKey arrived, photograph the contents and create a new inventory entry in my database."
2. "I'm expecting a shipment of sensors today. Can you monitor the webhook and alert me as soon as the weight matches the tracking manifest?"
3. "The last package we received is a return. Please forward it to the main fulfillment center and provide me with the new tracking number."

Tips & Limitations

• Carrier Restrictions: This service is strictly for private carriers. Do not ship via USPS, as those items will be returned to the sender automatically.
• Security: Treat your reference code as sensitive credentials; it is the link between your digital agent and physical property.
• Automation Strategy: Leverage the instant webhook notifications to build real-time inventory systems. If your agent is offline when a package arrives, ensure you have a state-persistence layer to handle the event logs when the agent reconnects.