{
  "schemaVersion": "1.0",
  "item": {
    "slug": "xobni",
    "name": "Xobni Email",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/ghoshsanjoy78/xobni",
    "canonicalUrl": "https://clawhub.ai/ghoshsanjoy78/xobni",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/xobni",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=xobni",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md",
      "references/api.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. 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. 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/xobni"
    },
    "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/xobni",
    "agentPageUrl": "https://openagent3.xyz/skills/xobni/agent",
    "manifestUrl": "https://openagent3.xyz/skills/xobni/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/xobni/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. 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. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Xobni.ai Email Skill",
        "body": "Give AI agents real email addresses with full inbox functionality."
      },
      {
        "title": "Quick Start",
        "body": "Create agent at xobni.ai/agents/new → gets email like your-agent@xobni.ai\nCreate API key at xobni.ai/settings/api-keys scoped to your agent\nConnect via REST API or MCP"
      },
      {
        "title": "API Key Scoping",
        "body": "Each API key is scoped to a single agent. The key can only access that agent's emails, threads, attachments, and webhooks. No need to pass account_id or agent_id — they're auto-resolved from your key.\n\nWhat scoped keys can do:\n\nRead, send, search, and manage emails\nCreate and manage webhooks\nView agent info and storage usage\n\nWhat scoped keys cannot do:\n\nAccess other agents' data (returns 403)\nCreate or delete agents\nManage API keys or billing"
      },
      {
        "title": "MCP Connection",
        "body": "URL: https://api.xobni.ai/mcp/\nTransport: Streamable HTTP\nAuth: Authorization: Bearer YOUR_API_KEY"
      },
      {
        "title": "Claude Desktop Config",
        "body": "{\n  \"mcpServers\": {\n    \"xobni\": {\n      \"url\": \"https://api.xobni.ai/mcp/\",\n      \"headers\": {\n        \"Authorization\": \"Bearer YOUR_API_KEY\"\n      }\n    }\n  }\n}"
      },
      {
        "title": "Read Inbox",
        "body": "curl -H \"Authorization: Bearer $XOBNI_KEY\" \\\n  \"https://api.xobni.ai/api/v1/emails?status=received&limit=20\""
      },
      {
        "title": "Send Email",
        "body": "curl -X POST -H \"Authorization: Bearer $XOBNI_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  \"https://api.xobni.ai/api/v1/emails/send\" \\\n  -d '{\"to\":[\"recipient@example.com\"],\"subject\":\"Hello\",\"body_text\":\"Message here\"}'"
      },
      {
        "title": "Send with Attachments",
        "body": "curl -X POST -H \"Authorization: Bearer $XOBNI_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  \"https://api.xobni.ai/api/v1/emails/send\" \\\n  -d '{\n    \"to\":[\"recipient@example.com\"],\n    \"subject\":\"Report\",\n    \"body_text\":\"See attached.\",\n    \"attachments\":[{\"filename\":\"report.pdf\",\"data\":\"<base64>\",\"content_type\":\"application/pdf\"}]\n  }'"
      },
      {
        "title": "Search (Semantic)",
        "body": "curl -X POST -H \"Authorization: Bearer $XOBNI_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  \"https://api.xobni.ai/api/v1/search\" \\\n  -d '{\"query\":\"invoices from last month\",\"limit\":10}'"
      },
      {
        "title": "Get Agent Info",
        "body": "curl -H \"Authorization: Bearer $XOBNI_KEY\" \\\n  \"https://api.xobni.ai/api/v1/agents\""
      },
      {
        "title": "Check Storage Usage",
        "body": "curl -H \"Authorization: Bearer $XOBNI_KEY\" \\\n  \"https://api.xobni.ai/api/v1/emails/storage-usage\""
      },
      {
        "title": "MCP Tools (14 total)",
        "body": "ToolPurposeget_agent_infoGet agent's name, email, slug, statusread_inboxList emails with filters (status, limit, offset)read_emailGet full email content by IDsend_emailSend with optional attachments and reply threadingget_threadGet all emails in a conversationlist_attachmentsList attachments for an emaildownload_attachmentGet pre-signed download URL (15 min)get_attachment_textExtract text from PDF/DOCX/XLSX/PPTXmark_emailUpdate status: read/unread/starred/unstarred/archivedsearch_emailsSemantic search across emails + attachmentslist_webhooksList configured webhookscreate_webhookCreate webhook for email.received/email.sentdelete_webhookRemove a webhooklist_webhook_deliveriesView webhook delivery history"
      },
      {
        "title": "Webhooks",
        "body": "Set up real-time notifications when emails arrive or are sent:\n\ncurl -X POST -H \"Authorization: Bearer $XOBNI_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  \"https://api.xobni.ai/api/v1/event-hooks\" \\\n  -d '{\n    \"url\": \"https://your-endpoint.com/webhook\",\n    \"events\": [\"email.received\"],\n    \"description\": \"Email notifications\"\n  }'\n\nSupported events: email.received, email.sent. Payloads include email metadata and a 200-character snippet. Use read_email to fetch full content."
      },
      {
        "title": "API Reference",
        "body": "See references/api.md for full endpoint documentation."
      },
      {
        "title": "Key Concepts",
        "body": "Agent-scoped keys: Each key works with one agent only. Auto-resolves IDs.\nSemantic search: Natural language queries across email bodies AND attachments (PDF, DOCX, etc.)\nAttachments: Send files via base64 (max 10 files, 10MB total)\nWebhooks: Real-time notifications for email events via n8n, Zapier, Make, or any HTTP endpoint."
      }
    ],
    "body": "Xobni.ai Email Skill\n\nGive AI agents real email addresses with full inbox functionality.\n\nQuick Start\nCreate agent at xobni.ai/agents/new → gets email like your-agent@xobni.ai\nCreate API key at xobni.ai/settings/api-keys scoped to your agent\nConnect via REST API or MCP\nAPI Key Scoping\n\nEach API key is scoped to a single agent. The key can only access that agent's emails, threads, attachments, and webhooks. No need to pass account_id or agent_id — they're auto-resolved from your key.\n\nWhat scoped keys can do:\n\nRead, send, search, and manage emails\nCreate and manage webhooks\nView agent info and storage usage\n\nWhat scoped keys cannot do:\n\nAccess other agents' data (returns 403)\nCreate or delete agents\nManage API keys or billing\nMCP Connection\n\nURL: https://api.xobni.ai/mcp/\nTransport: Streamable HTTP\nAuth: Authorization: Bearer YOUR_API_KEY\n\nClaude Desktop Config\n{\n  \"mcpServers\": {\n    \"xobni\": {\n      \"url\": \"https://api.xobni.ai/mcp/\",\n      \"headers\": {\n        \"Authorization\": \"Bearer YOUR_API_KEY\"\n      }\n    }\n  }\n}\n\nCore Operations\nRead Inbox\ncurl -H \"Authorization: Bearer $XOBNI_KEY\" \\\n  \"https://api.xobni.ai/api/v1/emails?status=received&limit=20\"\n\nSend Email\ncurl -X POST -H \"Authorization: Bearer $XOBNI_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  \"https://api.xobni.ai/api/v1/emails/send\" \\\n  -d '{\"to\":[\"recipient@example.com\"],\"subject\":\"Hello\",\"body_text\":\"Message here\"}'\n\nSend with Attachments\ncurl -X POST -H \"Authorization: Bearer $XOBNI_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  \"https://api.xobni.ai/api/v1/emails/send\" \\\n  -d '{\n    \"to\":[\"recipient@example.com\"],\n    \"subject\":\"Report\",\n    \"body_text\":\"See attached.\",\n    \"attachments\":[{\"filename\":\"report.pdf\",\"data\":\"<base64>\",\"content_type\":\"application/pdf\"}]\n  }'\n\nSearch (Semantic)\ncurl -X POST -H \"Authorization: Bearer $XOBNI_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  \"https://api.xobni.ai/api/v1/search\" \\\n  -d '{\"query\":\"invoices from last month\",\"limit\":10}'\n\nGet Agent Info\ncurl -H \"Authorization: Bearer $XOBNI_KEY\" \\\n  \"https://api.xobni.ai/api/v1/agents\"\n\nCheck Storage Usage\ncurl -H \"Authorization: Bearer $XOBNI_KEY\" \\\n  \"https://api.xobni.ai/api/v1/emails/storage-usage\"\n\nMCP Tools (14 total)\nTool\tPurpose\nget_agent_info\tGet agent's name, email, slug, status\nread_inbox\tList emails with filters (status, limit, offset)\nread_email\tGet full email content by ID\nsend_email\tSend with optional attachments and reply threading\nget_thread\tGet all emails in a conversation\nlist_attachments\tList attachments for an email\ndownload_attachment\tGet pre-signed download URL (15 min)\nget_attachment_text\tExtract text from PDF/DOCX/XLSX/PPTX\nmark_email\tUpdate status: read/unread/starred/unstarred/archived\nsearch_emails\tSemantic search across emails + attachments\nlist_webhooks\tList configured webhooks\ncreate_webhook\tCreate webhook for email.received/email.sent\ndelete_webhook\tRemove a webhook\nlist_webhook_deliveries\tView webhook delivery history\nWebhooks\n\nSet up real-time notifications when emails arrive or are sent:\n\ncurl -X POST -H \"Authorization: Bearer $XOBNI_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  \"https://api.xobni.ai/api/v1/event-hooks\" \\\n  -d '{\n    \"url\": \"https://your-endpoint.com/webhook\",\n    \"events\": [\"email.received\"],\n    \"description\": \"Email notifications\"\n  }'\n\n\nSupported events: email.received, email.sent. Payloads include email metadata and a 200-character snippet. Use read_email to fetch full content.\n\nAPI Reference\n\nSee references/api.md for full endpoint documentation.\n\nKey Concepts\nAgent-scoped keys: Each key works with one agent only. Auto-resolves IDs.\nSemantic search: Natural language queries across email bodies AND attachments (PDF, DOCX, etc.)\nAttachments: Send files via base64 (max 10 files, 10MB total)\nWebhooks: Real-time notifications for email events via n8n, Zapier, Make, or any HTTP endpoint."
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/ghoshsanjoy78/xobni",
    "publisherUrl": "https://clawhub.ai/ghoshsanjoy78/xobni",
    "owner": "ghoshsanjoy78",
    "version": "1.0.1",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/xobni",
    "downloadUrl": "https://openagent3.xyz/downloads/xobni",
    "agentUrl": "https://openagent3.xyz/skills/xobni/agent",
    "manifestUrl": "https://openagent3.xyz/skills/xobni/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/xobni/agent.md"
  }
}