PR Custody

feat(connect): improve AI client-level instructions (DASH-342)

@devin-ai-integration[bot]checks n/achecks…devin/DASH-342-1773916019 → main4 files · +69 −16review: @palash-cupdated 2mo ago

GitHub

▸Description· 2 comments · 2 noise

Summary

Three instruction improvements for AI client setup pages, plus consolidation of duplicated prompt strings:

ChatGPT: Extended the final step to remind users to click + → More → select Composio in every new chat.
OpenClaw: Added a Plugin tab (default) with a setup prompt referencing @composio/openclaw-plugin. Existing OAuth and API Key methods relabeled as "MCP (OAuth)" / "MCP (API Key)".
Notion: Added OAuth as the default method (no API key step). Existing API Key method preserved as fallback tab.
Prompt deduplication: The OpenClaw MCP OAuth prompt string was duplicated in client-definitions.ts, client-grid.tsx, and consumer-client-selector.tsx. Consolidated into exported constants (OPENCLAW_MCP_OAUTH_PROMPT, OPENCLAW_PLUGIN_PROMPT).
Onboarding: The OpenClaw "Copy prompt" button in the onboarding flow now copies the Plugin setup prompt (with <API KEY> placeholder) instead of the MCP OAuth prompt.

Supporting changes: extended AuthMethodType with "plugin" and updated instruction-page.tsx to show the token banner for plugin-type methods.

Review & Testing Checklist for Human

OpenClaw onboarding prompt UX: The onboarding copies OPENCLAW_PLUGIN_PROMPT which contains a literal <API KEY> placeholder (since no token is available at that stage). Verify this is the intended behavior — users will need to manually replace <API KEY> with their actual consumer API key after pasting.
Notion OAuth flow accuracy: Verify that Notion's Custom MCP actually supports OAuth auto-detection. The new OAuth steps claim "Notion will detect OAuth and open a browser window" — if Notion doesn't support this, the instructions will be misleading.
OpenClaw Plugin prompt content: Confirm the npm registry URL https://registry.npmjs.org/@composio/openclaw-plugin is correct (note: uses @composio/openclaw-plugin, while the Linear issue says composio/openclaw-plugin without @).
ChatGPT step wording: Confirm "click the + icon at the bottom, then click More, and select Composio" matches the current ChatGPT UI.
Navigate to each client's instruction page (/connect/clients/chatgpt, /connect/clients/openclaw, /connect/clients/notion) and verify tabs render correctly with proper token display and tab ordering (OpenClaw: Plugin first; Notion: OAuth first).

Test Plan

Go to /connect/clients/openclaw — confirm Plugin is the first/default tab, followed by MCP (OAuth), then MCP (API Key). Confirm the API key is visible in the Plugin prompt.
Go to /connect/clients/notion — confirm OAuth is the first/default tab. Confirm the API Key tab still works with the token banner.
Go to /connect/clients/chatgpt — confirm the final step includes the + > More > Composio guidance.
Go to the main /connect/clients grid — confirm the OpenClaw card still copies the MCP OAuth prompt on click.
Go through the onboarding flow — when OpenClaw is selected, click "Copy prompt" and verify the clipboard contains the Plugin setup prompt with <API KEY> placeholder.

Notes

Could not run full typecheck locally due to the private @composio/db dependency. Relying on CI for type validation.
All changes are declarative (instruction text, type definitions, import consolidation) — no logic or API changes.
The isTokenLoaded guard in instruction-page.tsx was changed from method.type !== "api-key" to method.type === "oauth" to correctly handle the new "plugin" type needing token data.
The client grid's OpenClaw card copies the MCP OAuth prompt, while the onboarding copies the Plugin prompt — this is intentional per user request but worth confirming.

Link to Devin session: https://app.devin.ai/sessions/6840f01436ab42b1bcb649231f331b4f Requested by: @palash-c

@devin-ai-integration[bot]agent2mo ago

'Improve AI Client level instructions' (DASH-342)

User instruction: @devin can you do this again with the latest composio_dashboard code? the open claw prompt is in multiple places

@devin-ai-integration[bot]agent2mo ago

🤖 Devin AI Engineer

I'll be helping with this pull request! Here's what you should know:

✅ I will automatically:

Address comments on this PR. Add '(aside)' to your comment to have me ignore it.
Look at CI failures and help fix them

⚙️ Control Options:

Disable automatic comment and CI monitoring

▸ 2 bot/status comments hidden

@linear[bot]2mo ago

Chat GPT: Add at the end that in the chat users have to click on + and More and Choose Composio
OpenClaw needs plugin instructions (Plugin tab / MCP tab: current instructions go to the MCP)
- Set up Composio for OpenClaw. My consumer API key is: <API KEY>. Read the setup instructions from https://registry.npmjs.org/composio/openclaw-plugin and follow them exactly. Ignore any plugin name mismatch warnings. API Key show how other instructions show
Notion OAuth should work, no need for API key step
- Skip API key in this flow, avoid complication

@vercel[bot]2mo ago

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
dashboard	Ready	Preview, Comment

loading diff…