{
  "schemaVersion": "1.0",
  "item": {
    "slug": "maton-agent-tools",
    "name": "Maton MCP Tools",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/maverick-software/maton-agent-tools",
    "canonicalUrl": "https://clawhub.ai/maverick-software/maton-agent-tools",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/maton-agent-tools",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=maton-agent-tools",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md",
      "reference/README.md",
      "reference/maton-controller.ts",
      "reference/maton-backend.ts",
      "reference/maton-views.ts"
    ],
    "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-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-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/maton-agent-tools"
    },
    "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/maton-agent-tools",
    "agentPageUrl": "https://openagent3.xyz/skills/maton-agent-tools/agent",
    "manifestUrl": "https://openagent3.xyz/skills/maton-agent-tools/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/maton-agent-tools/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": "Maton AI",
        "body": "Connect your AI agent to SaaS tools via Maton's OAuth connection management. This skill provides:\n\nFull UI Dashboard — Configure API key, view connections, initiate OAuth flows\nMulti-App Support — Gmail, Slack, Notion, HubSpot, Jira, Google Workspace, and more\nConnection Management — Create, monitor, and delete app connections\nAPI Keys Integration — Maton API key appears in the API Keys tab for easy configuration"
      },
      {
        "title": "Overview",
        "body": "Maton provides a unified API for connecting to SaaS tools via OAuth. Once connected, you can interact with these tools through Maton's AI capabilities or directly via their API."
      },
      {
        "title": "Prerequisites",
        "body": "Maton Account — Sign up at maton.ai\nAPI Key — Get your API key from the Maton dashboard\nClawdbot Gateway — v2026.1.0 or later with UI enabled"
      },
      {
        "title": "Step 1: Get Your API Key",
        "body": "Go to maton.ai and sign in\nNavigate to Settings → API Keys\nCreate or copy your API key"
      },
      {
        "title": "Step 2: Configure in Clawdbot UI",
        "body": "Option A: Via API Keys tab\n\nOpen Clawdbot Dashboard → Settings → API Keys\nFind \"Maton\" in the Environment Keys section\nEnter your API key and click Save\n\nOption B: Via Maton tab\n\nOpen Clawdbot Dashboard → Tools → Maton\nClick Configure\nPaste your API key\nClick Save"
      },
      {
        "title": "Step 3: Connect Apps",
        "body": "Go to Tools → Maton\nClick Connect App and select an app (e.g., Gmail, Slack)\nComplete the OAuth flow in the popup window\nOnce status shows ACTIVE, the connection is ready"
      },
      {
        "title": "Supported Apps",
        "body": "Maton supports 50+ SaaS applications including:\n\nCategoryAppsGoogle WorkspaceGmail, Calendar, Docs, Sheets, Drive, Slides, Ads, AnalyticsProductivityNotion, Airtable, Jira, CalendlyCommunicationSlack, OutlookCRMHubSpot, ApolloMediaYouTube"
      },
      {
        "title": "Base URL",
        "body": "https://ctrl.maton.ai"
      },
      {
        "title": "Authentication",
        "body": "All requests require a Bearer token:\n\ncurl https://ctrl.maton.ai/connections \\\n  -H \"Authorization: Bearer YOUR_API_KEY\""
      },
      {
        "title": "Endpoints",
        "body": "MethodEndpointDescriptionGET/connectionsList all connectionsPOST/connectionsCreate new connectionGET/connections/{id}Get connection detailsDELETE/connections/{id}Delete connection"
      },
      {
        "title": "Connection Status",
        "body": "StatusDescriptionPENDINGOAuth flow not completed; url contains OAuth linkACTIVEConnection established and ready to useFAILEDConnection failed; reconnection required"
      },
      {
        "title": "Configuration Storage",
        "body": "The Maton API key is stored in the main Clawdbot config file:\n\n{\n  \"env\": {\n    \"MATON_API_KEY\": \"your-api-key-here\"\n  }\n}\n\nThis integrates with the API Keys tab for centralized key management."
      },
      {
        "title": "Backend RPC Methods",
        "body": "MethodPurposematon.statusGet API key status and connection countmaton.saveValidate and store API keymaton.testTest the API keymaton.disconnectRemove API keymaton.connectionsList all connectionsmaton.connectCreate a new connection (returns OAuth URL)maton.deleteDelete a connectionmaton.appsList supported apps"
      },
      {
        "title": "UI Components",
        "body": "FilePurposematon-backend.tsGateway RPC handlersmaton-controller.tsUI state managementmaton-views.tsLit HTML templates"
      },
      {
        "title": "Installation",
        "body": "See reference/README.md for detailed integration instructions."
      },
      {
        "title": "Quick Integration",
        "body": "Copy backend handler to src/gateway/server-methods/maton.ts\nCopy UI files to ui/src/ui/views/ and ui/src/ui/controllers/\nAdd \"maton\" tab to navigation\nAdd MATON_API_KEY to API keys discovery\nRebuild and restart"
      },
      {
        "title": "Maton Tab (Tools → Maton)",
        "body": "Connection status with active/pending counts\nAPI key configuration form\nConnected apps list with status badges\nApp picker modal for new connections\nOne-click OAuth flow initiation"
      },
      {
        "title": "API Keys Tab Integration",
        "body": "Shows \"Maton\" in Environment Keys section\nDirect input field for API key\nSave/Clear functionality"
      },
      {
        "title": "Security",
        "body": "AspectImplementationKey StorageMain config file (~/.clawdbot/clawdbot.json)Key AccessNever exposed to AI agentOAuth TokensManaged by Maton (automatic refresh)\n\nBest practices:\n\nRotate API keys periodically\nReview connected apps regularly\nDisconnect unused connections"
      },
      {
        "title": "\"Unauthorized\" error",
        "body": "Verify your API key is correct\nCheck that the key hasn't been revoked\nRegenerate in Maton dashboard if needed"
      },
      {
        "title": "Connection stuck in PENDING",
        "body": "OAuth flow wasn't completed\nTry the OAuth URL again\nDelete and recreate if URL expired"
      },
      {
        "title": "Connection shows FAILED",
        "body": "OAuth token may have expired\nDelete the connection and create new one"
      },
      {
        "title": "Maton not in API Keys tab",
        "body": "Ensure you're on Clawdbot v2026.1.0+\nRefresh the page after gateway restart"
      },
      {
        "title": "Reference Files",
        "body": "reference/maton-backend.ts — Gateway RPC handlers\nreference/maton-controller.ts — UI controller logic\nreference/maton-views.ts — UI rendering (Lit)\nreference/README.md — Installation guide"
      },
      {
        "title": "Support",
        "body": "Maton: maton.ai\nClawdHub: clawdhub.com/skills/maton\nDiscord: discord.com/invite/clawd"
      }
    ],
    "body": "Maton AI\n\nConnect your AI agent to SaaS tools via Maton's OAuth connection management. This skill provides:\n\nFull UI Dashboard — Configure API key, view connections, initiate OAuth flows\nMulti-App Support — Gmail, Slack, Notion, HubSpot, Jira, Google Workspace, and more\nConnection Management — Create, monitor, and delete app connections\nAPI Keys Integration — Maton API key appears in the API Keys tab for easy configuration\nOverview\n\nMaton provides a unified API for connecting to SaaS tools via OAuth. Once connected, you can interact with these tools through Maton's AI capabilities or directly via their API.\n\nPrerequisites\nMaton Account — Sign up at maton.ai\nAPI Key — Get your API key from the Maton dashboard\nClawdbot Gateway — v2026.1.0 or later with UI enabled\nQuick Start\nStep 1: Get Your API Key\nGo to maton.ai and sign in\nNavigate to Settings → API Keys\nCreate or copy your API key\nStep 2: Configure in Clawdbot UI\n\nOption A: Via API Keys tab\n\nOpen Clawdbot Dashboard → Settings → API Keys\nFind \"Maton\" in the Environment Keys section\nEnter your API key and click Save\n\nOption B: Via Maton tab\n\nOpen Clawdbot Dashboard → Tools → Maton\nClick Configure\nPaste your API key\nClick Save\nStep 3: Connect Apps\nGo to Tools → Maton\nClick Connect App and select an app (e.g., Gmail, Slack)\nComplete the OAuth flow in the popup window\nOnce status shows ACTIVE, the connection is ready\nSupported Apps\n\nMaton supports 50+ SaaS applications including:\n\nCategory\tApps\nGoogle Workspace\tGmail, Calendar, Docs, Sheets, Drive, Slides, Ads, Analytics\nProductivity\tNotion, Airtable, Jira, Calendly\nCommunication\tSlack, Outlook\nCRM\tHubSpot, Apollo\nMedia\tYouTube\nAPI Reference\nBase URL\nhttps://ctrl.maton.ai\n\nAuthentication\n\nAll requests require a Bearer token:\n\ncurl https://ctrl.maton.ai/connections \\\n  -H \"Authorization: Bearer YOUR_API_KEY\"\n\nEndpoints\nMethod\tEndpoint\tDescription\nGET\t/connections\tList all connections\nPOST\t/connections\tCreate new connection\nGET\t/connections/{id}\tGet connection details\nDELETE\t/connections/{id}\tDelete connection\nConnection Status\nStatus\tDescription\nPENDING\tOAuth flow not completed; url contains OAuth link\nACTIVE\tConnection established and ready to use\nFAILED\tConnection failed; reconnection required\nArchitecture\nConfiguration Storage\n\nThe Maton API key is stored in the main Clawdbot config file:\n\n{\n  \"env\": {\n    \"MATON_API_KEY\": \"your-api-key-here\"\n  }\n}\n\n\nThis integrates with the API Keys tab for centralized key management.\n\nBackend RPC Methods\nMethod\tPurpose\nmaton.status\tGet API key status and connection count\nmaton.save\tValidate and store API key\nmaton.test\tTest the API key\nmaton.disconnect\tRemove API key\nmaton.connections\tList all connections\nmaton.connect\tCreate a new connection (returns OAuth URL)\nmaton.delete\tDelete a connection\nmaton.apps\tList supported apps\nUI Components\nFile\tPurpose\nmaton-backend.ts\tGateway RPC handlers\nmaton-controller.ts\tUI state management\nmaton-views.ts\tLit HTML templates\nInstallation\n\nSee reference/README.md for detailed integration instructions.\n\nQuick Integration\nCopy backend handler to src/gateway/server-methods/maton.ts\nCopy UI files to ui/src/ui/views/ and ui/src/ui/controllers/\nAdd \"maton\" tab to navigation\nAdd MATON_API_KEY to API keys discovery\nRebuild and restart\nUI Features\nMaton Tab (Tools → Maton)\nConnection status with active/pending counts\nAPI key configuration form\nConnected apps list with status badges\nApp picker modal for new connections\nOne-click OAuth flow initiation\nAPI Keys Tab Integration\nShows \"Maton\" in Environment Keys section\nDirect input field for API key\nSave/Clear functionality\nSecurity\nAspect\tImplementation\nKey Storage\tMain config file (~/.clawdbot/clawdbot.json)\nKey Access\tNever exposed to AI agent\nOAuth Tokens\tManaged by Maton (automatic refresh)\n\nBest practices:\n\nRotate API keys periodically\nReview connected apps regularly\nDisconnect unused connections\nTroubleshooting\n\"Unauthorized\" error\nVerify your API key is correct\nCheck that the key hasn't been revoked\nRegenerate in Maton dashboard if needed\nConnection stuck in PENDING\nOAuth flow wasn't completed\nTry the OAuth URL again\nDelete and recreate if URL expired\nConnection shows FAILED\nOAuth token may have expired\nDelete the connection and create new one\nMaton not in API Keys tab\nEnsure you're on Clawdbot v2026.1.0+\nRefresh the page after gateway restart\nReference Files\nreference/maton-backend.ts — Gateway RPC handlers\nreference/maton-controller.ts — UI controller logic\nreference/maton-views.ts — UI rendering (Lit)\nreference/README.md — Installation guide\nSupport\nMaton: maton.ai\nClawdHub: clawdhub.com/skills/maton\nDiscord: discord.com/invite/clawd"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/maverick-software/maton-agent-tools",
    "publisherUrl": "https://clawhub.ai/maverick-software/maton-agent-tools",
    "owner": "maverick-software",
    "version": "1.0.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/maton-agent-tools",
    "downloadUrl": "https://openagent3.xyz/downloads/maton-agent-tools",
    "agentUrl": "https://openagent3.xyz/skills/maton-agent-tools/agent",
    "manifestUrl": "https://openagent3.xyz/skills/maton-agent-tools/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/maton-agent-tools/agent.md"
  }
}