pdauth

What This Skill Does

pdauth is the definitive bridge between OpenClaw AI agents and the vast ecosystem of over 2500+ APIs supported by Pipedream. Instead of hard-coding complex OAuth implementations for every single service your agent needs to interact with, pdauth handles the heavy lifting of authentication tokens, secure callbacks, and tool discovery. By acting as a secure intermediary, it allows your agent to request access to user accounts—such as Slack, Notion, or Spotify—on-the-fly. Once the user clicks the provided authentication link, the agent gains permission to invoke specific tools on their behalf, effectively expanding the agent’s capabilities into the real-world software stack used by humans.

Installation

To integrate this skill into your environment, use the OpenClaw CLI from your terminal: clawhub install openclaw/skills/skills/g9pedro/pdauth After installation, ensure you have your Pipedream credentials set up by running pdauth config. This initialization step is mandatory to link your local environment to the Pipedream platform, ensuring all API calls are authenticated correctly.

Use Cases

• Project Management Automation: Automatically create Notion pages or Linear issues based on summarized meeting notes.
• Content & Media Management: Curate Spotify playlists or manage Slack channel notifications directly through agent-initiated commands.
• Workflow Orchestration: Sync data between disparate systems like Google Sheets and Airtable without writing custom middleware.
• Communication Orchestration: Manage high-priority email threads in Gmail or automate Slack status updates during focused work sessions.

Example Prompts

1. "Check if I have access to my Slack; if not, generate an authorization link so I can start sending daily summaries to the #general channel."
2. "Can you list all my available tools for Spotify, and then add the current song to my 'Deep Focus' playlist?"
3. "I need to update my project tracker. Please create a new record in Airtable with the title 'Q4 Roadmap' using the data provided in my latest document."

Tips & Limitations

• Persistence: Always use a consistent User ID (e.g., email or unique string) to ensure the agent remembers authorization states across different sessions.
• Troubleshooting: If a tool call fails, start by running pdauth status for that user to verify if the token is still valid. If it has expired, simply re-run the connect flow.
• Security: Always be transparent with the user when requesting authorization. The agent should only request scopes necessary for the task at hand.
• Limitations: The agent cannot initiate authorization without a human user clicking the link; always design your agent responses to gracefully handle 'App not connected' errors by presenting the link clearly.