{ "schemaVersion": "1.0", "item": { "slug": "scalekit-agent-auth", "name": "Scalekit-Agent-Auth", "source": "tencent", "type": "skill", "category": "效率提升", "sourceUrl": "https://clawhub.ai/Avinash-Kamath/scalekit-agent-auth", "canonicalUrl": "https://clawhub.ai/Avinash-Kamath/scalekit-agent-auth", "targetPlatform": "OpenClaw" }, "install": { "downloadMode": "redirect", "downloadUrl": "/downloads/scalekit-agent-auth", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=scalekit-agent-auth", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "installMethod": "Manual import", "extraction": "Extract archive", "prerequisites": [ "OpenClaw" ], "packageFormat": "ZIP package", "includedAssets": [ "README.md", "SKILL.md", "agent_wrapper.py", "pyproject.toml", "requirements.txt", "tool_exec.py" ], "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-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/scalekit-agent-auth" }, "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/scalekit-agent-auth", "agentPageUrl": "https://openagent3.xyz/skills/scalekit-agent-auth/agent", "manifestUrl": "https://openagent3.xyz/skills/scalekit-agent-auth/agent.json", "briefUrl": "https://openagent3.xyz/skills/scalekit-agent-auth/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": "OpenClaw Tool Executor", "body": "General-purpose tool executor for OpenClaw agents. Uses Scalekit Connect to discover and run tools for any connected service — OAuth (Notion, Slack, Gmail, GitHub, etc.) or non-OAuth (API Key, Bearer, Basic auth)." }, { "title": "Environment Variables", "body": "Required in .env:\n\nTOOL_CLIENT_ID=\nTOOL_CLIENT_SECRET=\nTOOL_ENV_URL=\nTOOL_IDENTIFIER= # optional but recommended\n\nTOOL_IDENTIFIER is used as the default --identifier for all operations. If not set, the script will prompt the user at runtime and display a warning advising them to set it in .env." }, { "title": "Execution Flow", "body": "When the user asks to perform an action on a connected service, follow these steps in order:" }, { "title": "Step 1 — Discover the Connection", "body": "Dynamically resolve the connection_name by listing all configured connections for the provider. The API paginates automatically through all pages:\n\nuv run tool_exec.py --list-connections --provider \n\nUse the key_id from the first result as for all subsequent steps.\nIf no connection found → inform the user that no connection is configured in Scalekit and stop.\nIf multiple connections found → the first one is selected automatically (a warning is shown)." }, { "title": "Step 2 — Check & Authorize", "body": "Run --generate-link for the connection. The tool automatically detects the connection type (OAuth vs non-OAuth) and applies the correct auth flow:\n\nuv run tool_exec.py --generate-link \\\n --connection-name \n\nOAuth connections:\n\nIf already ACTIVE → proceed to Step 3.\nIf not active → a magic link is generated. Present it to the user, wait for them to complete the flow, then proceed to Step 3.\n\nNon-OAuth connections (BEARER, BASIC, API Key, etc.):\n\nIf account not found → stop. Tell the user: \"Please create and configure the connection in the Scalekit Dashboard.\"\nIf account exists but not active → stop. Tell the user: \"Please activate the connection in the Scalekit Dashboard.\"\nIf ACTIVE → proceed to Step 3.\n\nNever use --get-authorization in the execution flow — that is only for inspecting raw OAuth tokens and does not work for non-OAuth connections." }, { "title": "Step 3 — Discover Available Tools", "body": "Fetch the list of tools available for the provider:\n\nuv run tool_exec.py --get-tool --provider \n\nLook for a tool that matches the user's intent (e.g. notion_page_get for reading a page).\nIf a matching tool exists → go to Step 3b.\nIf no matching tool exists → go to Step 5 (proxy fallback)." }, { "title": "Step 3b — Fetch Tool Schema (mandatory before executing)", "body": "Always fetch the schema of the matched tool before constructing the input. This tells you the exact parameter names, types, required vs optional fields, and valid enum values:\n\nuv run tool_exec.py --get-tool --tool-name \n\nRead the input_schema.properties from the response — use only the parameter names defined there.\nNote which fields are in required — these must always be included in --tool-input.\nUse description and display_properties to understand what each field expects.\nNever guess parameter names — always derive them from the schema." }, { "title": "Step 4 — Execute the Tool", "body": "Construct the tool input using only parameters from the schema fetched in Step 3b, then run:\n\nuv run tool_exec.py --execute-tool \\\n --tool-name \\\n --connection-name \\\n --tool-input ''\n\nReturn the result to the user." }, { "title": "Step 5 — Proxy Fallback (only if no tool exists)", "body": "If no Scalekit tool covers the required action, attempt a proxied HTTP request directly to the provider's API:\n\nuv run tool_exec.py --proxy-request \\\n --connection-name \\\n --path \\\n --method \\\n --query-params '' \\ # optional\n --body '' # optional\n\nNote: Proxy may be disabled on some environments. If it returns TOOL_PROXY_DISABLED, inform the user that this action isn't supported by the current Scalekit tool catalog and suggest they request a new tool from Scalekit." }, { "title": "Example: Search LinkedIn (via HarvestAPI)", "body": "User: \"Find software engineers in San Francisco on LinkedIn\"\n\n--list-connections --provider HARVESTAPI → key_id: harvestapi-xxxx, type: API_KEY\n--generate-link --connection-name harvestapi-xxxx → detects API_KEY, checks account → ACTIVE\n--get-tool --provider HARVESTAPI → finds harvestapi_search_people\n3b. --get-tool --tool-name harvestapi_search_people → schema shows valid params: first_names, last_names, search, locations, current_job_titles, etc.\n--execute-tool --tool-name harvestapi_search_people --connection-name harvestapi-xxxx --tool-input '{\"first_names\": \"John\", \"locations\": \"San Francisco\", \"current_job_titles\": \"Software Engineer\"}'\n→ returns matching LinkedIn profiles\n\nAny LinkedIn-related request (profiles, jobs, companies, posts, people search, ads, groups) → use provider HARVESTAPI." }, { "title": "Example: Search the web with Exa (API Key connection)", "body": "User: \"Search for latest AI news using Exa\"\n\n--list-connections --provider EXA → key_id: exa, type: API_KEY\n--generate-link --connection-name exa → detects API_KEY, checks account → ACTIVE\n--get-tool --provider EXA → finds exa_search\n3b. --get-tool --tool-name exa_search → schema shows query (required), num_results, type, etc.\n--execute-tool --tool-name exa_search --connection-name exa --tool-input '{\"query\": \"latest AI news\"}'\n→ returns search results" }, { "title": "Example: Read a Notion Page (OAuth connection)", "body": "User: \"Read my Notion page https://notion.so/...\"\n\n--list-connections --provider NOTION → key_id: notion-ijIQedmJ, type: OAUTH\n--generate-link --connection-name notion-ijIQedmJ → detects OAuth, already ACTIVE\n--get-tool --provider NOTION → finds notion_page_get\n3b. --get-tool --tool-name notion_page_get → schema shows page_id (required)\n--execute-tool --tool-name notion_page_get --connection-name notion-ijIQedmJ --tool-input '{\"page_id\": \"...\"}'\n→ returns page metadata" }, { "title": "Example: Action Not Yet in Scalekit", "body": "User: \"Fetch the blocks of a Notion page\"\n\n--list-connections --provider NOTION → key_id: notion-ijIQedmJ\n--generate-link --connection-name notion-ijIQedmJ → ACTIVE\n--get-tool --provider NOTION → no notion_blocks_fetch tool found\n--proxy-request --path \"/blocks//children\" → fallback attempt\nIf proxy disabled → inform user the action isn't available yet" }, { "title": "Supported Providers", "body": "Any provider configured in Scalekit (Notion, Slack, Gmail, Google Sheets, GitHub, Salesforce, HubSpot, Linear, and 50+ more). Use the provider name in uppercase for --provider (e.g. NOTION, SLACK, GOOGLE)." } ], "body": "OpenClaw Tool Executor\n\nGeneral-purpose tool executor for OpenClaw agents. Uses Scalekit Connect to discover and run tools for any connected service — OAuth (Notion, Slack, Gmail, GitHub, etc.) or non-OAuth (API Key, Bearer, Basic auth).\n\nEnvironment Variables\n\nRequired in .env:\n\nTOOL_CLIENT_ID=\nTOOL_CLIENT_SECRET=\nTOOL_ENV_URL=\nTOOL_IDENTIFIER= # optional but recommended\n\n\nTOOL_IDENTIFIER is used as the default --identifier for all operations. If not set, the script will prompt the user at runtime and display a warning advising them to set it in .env.\n\nExecution Flow\n\nWhen the user asks to perform an action on a connected service, follow these steps in order:\n\nStep 1 — Discover the Connection\n\nDynamically resolve the connection_name by listing all configured connections for the provider. The API paginates automatically through all pages:\n\nuv run tool_exec.py --list-connections --provider \n\nUse the key_id from the first result as for all subsequent steps.\nIf no connection found → inform the user that no connection is configured in Scalekit and stop.\nIf multiple connections found → the first one is selected automatically (a warning is shown).\nStep 2 — Check & Authorize\n\nRun --generate-link for the connection. The tool automatically detects the connection type (OAuth vs non-OAuth) and applies the correct auth flow:\n\nuv run tool_exec.py --generate-link \\\n --connection-name \n\n\nOAuth connections:\n\nIf already ACTIVE → proceed to Step 3.\nIf not active → a magic link is generated. Present it to the user, wait for them to complete the flow, then proceed to Step 3.\n\nNon-OAuth connections (BEARER, BASIC, API Key, etc.):\n\nIf account not found → stop. Tell the user: \"Please create and configure the connection in the Scalekit Dashboard.\"\nIf account exists but not active → stop. Tell the user: \"Please activate the connection in the Scalekit Dashboard.\"\nIf ACTIVE → proceed to Step 3.\n\nNever use --get-authorization in the execution flow — that is only for inspecting raw OAuth tokens and does not work for non-OAuth connections.\n\nStep 3 — Discover Available Tools\n\nFetch the list of tools available for the provider:\n\nuv run tool_exec.py --get-tool --provider \n\nLook for a tool that matches the user's intent (e.g. notion_page_get for reading a page).\nIf a matching tool exists → go to Step 3b.\nIf no matching tool exists → go to Step 5 (proxy fallback).\nStep 3b — Fetch Tool Schema (mandatory before executing)\n\nAlways fetch the schema of the matched tool before constructing the input. This tells you the exact parameter names, types, required vs optional fields, and valid enum values:\n\nuv run tool_exec.py --get-tool --tool-name \n\nRead the input_schema.properties from the response — use only the parameter names defined there.\nNote which fields are in required — these must always be included in --tool-input.\nUse description and display_properties to understand what each field expects.\nNever guess parameter names — always derive them from the schema.\nStep 4 — Execute the Tool\n\nConstruct the tool input using only parameters from the schema fetched in Step 3b, then run:\n\nuv run tool_exec.py --execute-tool \\\n --tool-name \\\n --connection-name \\\n --tool-input ''\n\n\nReturn the result to the user.\n\nStep 5 — Proxy Fallback (only if no tool exists)\n\nIf no Scalekit tool covers the required action, attempt a proxied HTTP request directly to the provider's API:\n\nuv run tool_exec.py --proxy-request \\\n --connection-name \\\n --path \\\n --method \\\n --query-params '' \\ # optional\n --body '' # optional\n\n\nNote: Proxy may be disabled on some environments. If it returns TOOL_PROXY_DISABLED, inform the user that this action isn't supported by the current Scalekit tool catalog and suggest they request a new tool from Scalekit.\n\nExample: Search LinkedIn (via HarvestAPI)\nUser: \"Find software engineers in San Francisco on LinkedIn\"\n\n--list-connections --provider HARVESTAPI → key_id: harvestapi-xxxx, type: API_KEY\n--generate-link --connection-name harvestapi-xxxx → detects API_KEY, checks account → ACTIVE\n--get-tool --provider HARVESTAPI → finds harvestapi_search_people 3b. --get-tool --tool-name harvestapi_search_people → schema shows valid params: first_names, last_names, search, locations, current_job_titles, etc.\n--execute-tool --tool-name harvestapi_search_people --connection-name harvestapi-xxxx --tool-input '{\"first_names\": \"John\", \"locations\": \"San Francisco\", \"current_job_titles\": \"Software Engineer\"}' → returns matching LinkedIn profiles\n\nAny LinkedIn-related request (profiles, jobs, companies, posts, people search, ads, groups) → use provider HARVESTAPI.\n\nExample: Search the web with Exa (API Key connection)\nUser: \"Search for latest AI news using Exa\"\n\n--list-connections --provider EXA → key_id: exa, type: API_KEY\n--generate-link --connection-name exa → detects API_KEY, checks account → ACTIVE\n--get-tool --provider EXA → finds exa_search 3b. --get-tool --tool-name exa_search → schema shows query (required), num_results, type, etc.\n--execute-tool --tool-name exa_search --connection-name exa --tool-input '{\"query\": \"latest AI news\"}' → returns search results\nExample: Read a Notion Page (OAuth connection)\nUser: \"Read my Notion page https://notion.so/...\"\n\n--list-connections --provider NOTION → key_id: notion-ijIQedmJ, type: OAUTH\n--generate-link --connection-name notion-ijIQedmJ → detects OAuth, already ACTIVE\n--get-tool --provider NOTION → finds notion_page_get 3b. --get-tool --tool-name notion_page_get → schema shows page_id (required)\n--execute-tool --tool-name notion_page_get --connection-name notion-ijIQedmJ --tool-input '{\"page_id\": \"...\"}' → returns page metadata\nExample: Action Not Yet in Scalekit\nUser: \"Fetch the blocks of a Notion page\"\n\n--list-connections --provider NOTION → key_id: notion-ijIQedmJ\n--generate-link --connection-name notion-ijIQedmJ → ACTIVE\n--get-tool --provider NOTION → no notion_blocks_fetch tool found\n--proxy-request --path \"/blocks//children\" → fallback attempt\nIf proxy disabled → inform user the action isn't available yet\nSupported Providers\n\nAny provider configured in Scalekit (Notion, Slack, Gmail, Google Sheets, GitHub, Salesforce, HubSpot, Linear, and 50+ more). Use the provider name in uppercase for --provider (e.g. NOTION, SLACK, GOOGLE)." }, "trust": { "sourceLabel": "tencent", "provenanceUrl": "https://clawhub.ai/Avinash-Kamath/scalekit-agent-auth", "publisherUrl": "https://clawhub.ai/Avinash-Kamath/scalekit-agent-auth", "owner": "Avinash-Kamath", "version": "2.2.0", "license": null, "verificationStatus": "Indexed source record" }, "links": { "detailUrl": "https://openagent3.xyz/skills/scalekit-agent-auth", "downloadUrl": "https://openagent3.xyz/downloads/scalekit-agent-auth", "agentUrl": "https://openagent3.xyz/skills/scalekit-agent-auth/agent", "manifestUrl": "https://openagent3.xyz/skills/scalekit-agent-auth/agent.json", "briefUrl": "https://openagent3.xyz/skills/scalekit-agent-auth/agent.md" } }