# Send Pipedream Connect Integration to your agent Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually. ## Fast path - 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. ## Suggested prompts ### New install ```text 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. ``` ### Upgrade existing ```text 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. ``` ## Machine-readable fields ```json { "schemaVersion": "1.0", "item": { "slug": "pipedream-connect", "name": "Pipedream Connect Integration", "source": "tencent", "type": "skill", "category": "开发工具", "sourceUrl": "https://clawhub.ai/maverick-software/pipedream-connect", "canonicalUrl": "https://clawhub.ai/maverick-software/pipedream-connect", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/pipedream-connect", "sourceDownloadUrl": "https://clawhub.ai/api/v1/download?slug=pipedream-connect", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "CHANGELOG.md", "INSTALL.md", "SKILL.md", "_meta.json", "reference/README.md", "reference/agent-pipedream-controller.ts" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "slug": "pipedream-connect", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-05-07T03:10:24.393Z", "expiresAt": "2026-05-14T03:10:24.393Z", "httpStatus": 200, "finalUrl": "https://clawhub.ai/api/v1/download?slug=pipedream-connect", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://clawhub.ai/api/v1/download?slug=pipedream-connect", "contentDisposition": "attachment; filename=\"pipedream-connect-1.6.0.zip\"", "redirectLocation": null, "bodySnippet": null, "slug": "pipedream-connect" }, "scope": "item", "summary": "Item download looks usable.", "detail": "Yavira can redirect you to the upstream package for this item.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/pipedream-connect" }, "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." ] } }, "links": { "detailUrl": "https://openagent3.xyz/skills/pipedream-connect", "downloadUrl": "https://openagent3.xyz/downloads/pipedream-connect", "agentUrl": "https://openagent3.xyz/skills/pipedream-connect/agent", "manifestUrl": "https://openagent3.xyz/skills/pipedream-connect/agent.json", "briefUrl": "https://openagent3.xyz/skills/pipedream-connect/agent.md" } } ``` ## Documentation ### Pipedream Connect Connect your AI agents to 2,000+ APIs with managed OAuth via Pipedream. Each agent gets its own isolated app connections and OAuth tokens. ### What's New (2026-03-10 v1.5.2) Added A–Z alphabet filter in the per-agent Browse Apps modal for fast app lookup by starting letter Added active letter indicator in results summary (e.g., Letter: Q) Improved app card readability in Browse Apps (wrapped names, reduced truncation) Updated reference snapshots for latest app catalog fallback + CSP compatibility path ### What's New (2026-03-10 v1.5.1) Added explicit metadata declarations for config paths, capabilities, persistence, and security notes Clarified persistent behavior (optional cron token refresh) and sensitive file access in docs Aligned docs with actual paths under ~/.openclaw/ ### What's New (2026-03-01 v1.3.0) Per-agent app connections — App connections moved to Agents → [Agent] → Tools → Pipedream Global tab = credentials only — The Pipedream tab is now for platform auth (Client ID/Secret/Project ID) only External User ID defaults to agent slug — e.g. main, scout-monitor (not a UUID) Live connected apps — Refresh queries the Pipedream API for real connected accounts Environment warning — Agent panel shows a warning when running in development mode New RPCs: pipedream.connect, pipedream.disconnect, pipedream.test (per-agent, use agentId + appSlug) ### What's New (v1.3.0) — Vault-Backed Secrets clientId and clientSecret stored in ~/.openclaw/secrets.json (OpenClaw vault) — no longer plaintext in pipedream-credentials.json PIPEDREAM_CLIENT_SECRET removed from mcporter.json env — client secret is never written to mcporter config Auto-migration: on first gateway start after upgrade, existing pipedream-credentials.json secrets are silently moved to vault and stripped from the file Token refresh script now reads from vault first (falls back to credentials.json → mcporter.json for backwards compat) pipedream-credentials.json now contains only non-sensitive fields: projectId, environment, externalUserId VirusTotal "suspicious" flag resolved — no plaintext credential files ### Architecture Global Pipedream Tab └── Platform credentials (Client ID, Secret, Project ID, Environment) └── Agent quick-links table (→ navigate to per-agent config) Agents → [Agent] → Tools → Pipedream └── External User ID (defaults to agent slug) └── Connected Apps (live from Pipedream API) └── Available Apps grid + Browse All Apps modal └── Manual slug entry ### Prerequisites Pipedream Account — pipedream.com mcporter — npm install -g mcporter OpenClaw Gateway — v2026.1.0 or later ### Step 1: Create OAuth Client & Project Go to pipedream.com/settings/api → New OAuth Client Copy Client ID and Client Secret Go to pipedream.com/projects → create a project Copy Project ID (proj_...) ### Step 2: Configure Platform Credentials OpenClaw Dashboard → Pipedream tab → Configure Enter Client ID, Client Secret, Project ID Set Environment to production (not development — development tokens expire faster and have lower rate limits) Click Save Credentials ### Step 3: Connect Apps Per Agent Go to Agents → [Agent] → Tools → Pipedream Verify the External User ID (defaults to agent slug, e.g. main) Click Connect on any app in the grid — completes OAuth in a popup Click ↻ Refresh after OAuth completes to see the app appear in Connected Apps ### Step 4: Token Refresh (Recommended) # Cron job — runs every 45 minutes (crontab -l 2>/dev/null; echo "*/45 * * * * /usr/bin/python3 $HOME/openclaw/skills/pipedream-connect/scripts/pipedream-token-refresh.py >> $HOME/openclaw/logs/pipedream-cron.log 2>&1") | crontab - ### Per-Agent Isolation Each agent uses a separate Pipedream external_user_id: AgentExternal User IDPipedream IdentitymainmainIsolated OAuth tokensscout-monitorscout-monitorIsolated OAuth tokensscout-sparkscout-sparkIsolated OAuth tokens Config stored at: ~/.openclaw/workspace/config/integrations/pipedream/{agentId}.json External User ID defaults to agent slug. Override it in Agents → Tools → Pipedream → Edit. ### Global (credentials) RPCParamsDescriptionpipedream.status—Get global credential status + agent summariespipedream.saveCredentialsclientId, clientSecret, projectId, environmentSave platform credentialspipedream.getToken—Get/refresh the platform OAuth access tokenpipedream.getConnectUrlagentId, appSlugGet OAuth connect URL for a user+apppipedream.connectAppagentId, appSlugComplete app connection + write to mcporterpipedream.disconnectAppagentId, appSlugDisconnect app + remove from mcporterpipedream.refreshTokenagentId?, appSlug?Refresh token(s) — all or specific agent/apppipedream.activateagentId, appSlugActivate an app (add to mcporter if not present) ### Per-Agent RPCParamsDescriptionpipedream.agent.statusagentIdGet config + live connected apps from APIpipedream.agent.saveagentId, externalUserIdSave per-agent configpipedream.agent.deleteagentIdRemove per-agent configpipedream.connectagentId, appSlugGet OAuth connect URL for agentpipedream.disconnectagentId, appSlugDisconnect app + remove from mcporterpipedream.testagentId, appSlugTest app connection ### Using Connected Tools # Gmail (agent: main → externalUserId: main) mcporter call pipedream-main-gmail.gmail-find-email \\ instruction="Find unread emails from today" # Google Calendar (agent: scout-monitor) mcporter call pipedream-scout-monitor-google-calendar.google-calendar-find-event \\ instruction="Find events for tomorrow" Server names follow the pattern: pipedream-{externalUserId}-{appSlug} ### Environment: Development vs Production ⚠️ Use Production for real work: Development tokens expire faster and have lower rate limits Set in: Pipedream tab → Edit credentials → Environment → Production The agent Pipedream panel shows a warning when running in development mode ### Security BehaviorDetailclientIdStored in ~/.openclaw/secrets.json (vault, 0600)clientSecretStored in ~/.openclaw/secrets.json (vault, 0600) — never in plaintext config filesNon-secret config~/.openclaw/workspace/config/pipedream-credentials.json — projectId, environment, externalUserId onlyPer-agent config~/.openclaw/workspace/config/integrations/pipedream/{agentId}.jsonAccess tokens (JWT)Short-lived Bearer token in mcporter.json Authorization header — acceptable, refreshed every 45 minmcporter envPIPEDREAM_CLIENT_SECRET is never written to mcporter.jsonExternal API callsapi.pipedream.com, remote.mcp.pipedream.netAuto-migrationExisting plaintext credentials.json secrets automatically moved to vault on first gateway start ### Troubleshooting Connected app not showing after OAuth → Click ↻ Refresh — the panel queries the Pipedream API live for connected accounts unknown method: pipedream.connect → Rebuild and restart gateway: pnpm build && openclaw gateway restart No Pipedream credentials configured → Set up credentials in the global Pipedream tab first Development environment warning → Edit credentials in Pipedream tab, change Environment to production, save Token expired → Set up the 45-minute cron job above, or click Connect again to re-authorize ### Support ClawHub: clawhub.ai/skills/pipedream-connect Pipedream Docs: pipedream.com/docs MCP Apps: mcp.pipedream.com OpenClaw Discord: discord.com/invite/clawd ### Reference Files FilePurposereference/pipedream-backend.tsGateway RPC handlers (all pipedream.* methods)reference/pipedream-views.tsGlobal Pipedream tab UI (Lit)reference/pipedream-controller.tsGlobal tab state managementreference/agent-pipedream-views.tsPer-agent Pipedream panel UI (Agents → Tools → Pipedream)reference/agent-pipedream-controller.tsPer-agent state managementreference/control-ui-csp.tsControl UI CSP policy (connect-src allowlist)reference/README.mdReference file notesscripts/Token refresh and utility scripts ## Trust - Source: tencent - Verification: Indexed source record - Publisher: maverick-software - Version: 1.5.2 ## Source health - Status: healthy - Item download looks usable. - Yavira can redirect you to the upstream package for this item. - Health scope: item - Reason: direct_download_ok - Checked at: 2026-05-07T03:10:24.393Z - Expires at: 2026-05-14T03:10:24.393Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/pipedream-connect) - [Send to Agent page](https://openagent3.xyz/skills/pipedream-connect/agent) - [JSON manifest](https://openagent3.xyz/skills/pipedream-connect/agent.json) - [Markdown brief](https://openagent3.xyz/skills/pipedream-connect/agent.md) - [Download page](https://openagent3.xyz/downloads/pipedream-connect)