Integrations

Connect your agents to external services via secure OAuth

What It Is

Integrations let your agents interact with external services — Gmail, Slack, Google Drive, GitHub, Notion, and 60+ more. OverClaw uses Composio for OAuth-based connections, generating per-user tool definitions in OpenAI function-calling format (cached with 5-minute TTL).

How to Use It

Connecting a Service

Go to Settings → Connections in your workspace
Browse available toolkits grouped by category (filtered to exclude already-connected and no-auth services)
Tap a toolkit — a confirmation alert warns about AI access scope
ASWebAuthenticationSession opens the Composio OAuth URL with overclaw:// callback scheme
After authorization, AVA calls confirmConnection() to finalize
The integration is immediately available to all agents in your workspace

Agents automatically detect required integrations during the Precheck phase of task execution (Phase 3). If a connection is missing, the task blocks and prompts you to authorize before continuing.

Custom API Connections

For services not in the Composio catalog:

Go to Settings → Custom Connections
Enter API base URL and authentication details
Test the connection
Agents can call your custom endpoints via the custom_api tool

How It Works Internally

Composio client initialized as singleton using COMPOSIO_API_KEY
Per-user ToolRouter sessions manage connections and action execution
Connected tools converted to OpenAI function-calling format via composio.tools.getRawComposioTools()
Tool definitions cached per user with 5-minute TTL
In-memory catalog cache refreshed every 6 hours
Actions routed through user's session with normalized success/failure responses

What You Need to Know

Workspace-scoped. All agents share the same connections within a workspace.
Encrypted storage. OAuth tokens encrypted with AES-256-GCM (12-byte IV, 16-byte auth tag).
Instant revocation. Disconnecting removes agent access immediately.
Dynamic tool lists. getEnabledToolsForUser() dynamically builds each agent's tool list based on active connections, cloud shell, custom APIs, and NotebookLM status.

Available Services

60+ services available via Composio, including:

Category	Examples
Email & Calendar	Gmail, Outlook, Google Calendar
Productivity	Google Drive, Google Docs, Notion, Todoist
Development	GitHub, GitLab, Jira, Linear
Commerce	Shopify, Stripe, Square
Marketing	Mailchimp, HubSpot, Google Analytics
Communication	Slack, Microsoft Teams, Discord
Social	Twitter/X, LinkedIn, Reddit
Automation	IFTTT, Zapier
Cloud	AWS, Vercel, OneDrive

FAQ

Is my data shared between workspaces? No. Each workspace has isolated connections.

Can I restrict which agents use a connection? Not currently — all agents in a workspace share all connections. Per-agent restrictions are planned for OverClaw Enterprise.

What does the Precheck phase check? Gemini Flash analyzes the task's required actions and verifies the necessary Composio toolkits are connected. If critical connections are missing, the task blocks with a prompt to authorize.