# Send Claude Connect 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": "claude-connect", "name": "Claude Connect", "source": "tencent", "type": "skill", "category": "通讯协作", "sourceUrl": "https://clawhub.ai/TunaIssaCoding/claude-connect", "canonicalUrl": "https://clawhub.ai/TunaIssaCoding/claude-connect", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/claude-connect", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=claude-connect", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "AUTO-DETECTION-FLOW.md", "CHANGELOG.md", "CHANGES.md", "COMPLETION-REPORT.md", "DELIVERABLES.txt", "DETECTION-EXAMPLES.md" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "slug": "claude-connect", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-04-29T10:25:49.304Z", "expiresAt": "2026-05-06T10:25:49.304Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=claude-connect", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=claude-connect", "contentDisposition": "attachment; filename=\"claude-connect-1.1.0.zip\"", "redirectLocation": null, "bodySnippet": null, "slug": "claude-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/claude-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/claude-connect", "downloadUrl": "https://openagent3.xyz/downloads/claude-connect", "agentUrl": "https://openagent3.xyz/skills/claude-connect/agent", "manifestUrl": "https://openagent3.xyz/skills/claude-connect/agent.json", "briefUrl": "https://openagent3.xyz/skills/claude-connect/agent.md" } } ``` ## Documentation ### claude-connect Connect your Claude subscription to Clawdbot in one step. Automatically: ✅ Reads Claude OAuth tokens from Keychain ✅ Writes them to Clawdbot in proper OAuth format ✅ Auto-refreshes every 2 hours (before expiry) ✅ Notifies you on success/failure ✅ Works with clawdbot onboard (fixes OAuth auth-profiles bug) ### Quick Start 1. Install the skill: clawdhub install claude-connect cd ~/clawd/skills/claude-connect 2. Ensure Claude CLI is logged in: claude auth # Follow the browser login flow 3. Run installer: ./install.sh That's it! Tokens will refresh automatically every 2 hours. ### Fixes clawdbot onboard OAuth Bug When you run clawdbot onboard --auth-choice claude-cli, it sometimes doesn't properly write OAuth tokens to auth-profiles.json. This skill: Reads OAuth tokens from macOS Keychain (where Claude CLI stores them) Writes them to ~/.clawdbot/agents/main/agent/auth-profiles.json in proper OAuth format: { "profiles": { "anthropic:claude-cli": { "type": "oauth", "provider": "anthropic", "access": "sk-ant-...", "refresh": "sk-ant-ort...", "expires": 1234567890 } } } Sets up auto-refresh (runs every 2 hours via launchd) Keeps your connection alive 24/7 ### Automatic (Recommended) cd ~/clawd/skills/claude-connect ./install.sh The installer will: ✅ Verify Claude CLI is set up ✅ Create config file ✅ Set up auto-refresh job (launchd) ✅ Run first refresh to test ### Manual Copy example config: cp claude-oauth-refresh-config.example.json claude-oauth-refresh-config.json Edit config (optional): nano claude-oauth-refresh-config.json Test refresh: ./refresh-token.sh --force Install launchd job (optional - for auto-refresh): cp com.clawdbot.claude-oauth-refresher.plist ~/Library/LaunchAgents/ launchctl load ~/Library/LaunchAgents/com.clawdbot.claude-oauth-refresher.plist ### Configuration Edit claude-oauth-refresh-config.json: { "refresh_buffer_minutes": 30, "log_file": "~/clawd/logs/claude-oauth-refresh.log", "notifications": { "on_success": true, "on_failure": true }, "notification_target": "YOUR_CHAT_ID" } Options: refresh_buffer_minutes: Refresh when token has this many minutes left (default: 30) log_file: Where to log refresh activity notifications.on_success: Notify on successful refresh (default: true) notifications.on_failure: Notify on failure (default: true) notification_target: Your Telegram chat ID (or leave empty to disable) ### Manual Refresh # Refresh now (even if not expired) ./refresh-token.sh --force # Refresh only if needed ./refresh-token.sh ### Check Status # View recent logs tail ~/clawd/logs/claude-oauth-refresh.log # Check auth profile cat ~/.clawdbot/agents/main/agent/auth-profiles.json | jq '.profiles."anthropic:claude-cli"' # Check Clawdbot status clawdbot models status ### Disable Notifications Ask Clawdbot: Disable Claude refresh success notifications Or edit config: { "notifications": { "on_success": false, "on_failure": true } } ### Refresh Process Read from Keychain: Gets OAuth tokens from Claude Code-credentials Check Expiry: Only refreshes if < 30 minutes left (or --force) Call OAuth API: Gets new access + refresh tokens Update auth-profiles.json: Writes proper OAuth format Update Keychain: Syncs new tokens back Restart Gateway: Picks up new tokens Notify: Sends success/failure message (optional) ### Auto-Refresh (launchd) Runs every 2 hours via ~/Library/LaunchAgents/com.clawdbot.claude-oauth-refresher.plist Controls: # Stop auto-refresh launchctl unload ~/Library/LaunchAgents/com.clawdbot.claude-oauth-refresher.plist # Start auto-refresh launchctl load ~/Library/LaunchAgents/com.clawdbot.claude-oauth-refresher.plist # Check if running launchctl list | grep claude ### OAuth not working after onboard Symptom: clawdbot onboard --auth-choice claude-cli completes but Clawdbot can't use tokens Fix: cd ~/clawd/skills/claude-connect ./refresh-token.sh --force This will write tokens in proper OAuth format. ### Tokens keep expiring Symptom: Auth keeps failing after 8 hours Fix: Ensure launchd job is running: launchctl load ~/Library/LaunchAgents/com.clawdbot.claude-oauth-refresher.plist launchctl list | grep claude ### No tokens in Keychain Symptom: No 'Claude Code-credentials' entries found Fix: Log in with Claude CLI: claude auth # Follow browser flow Then run refresh again: ./refresh-token.sh --force ### Uninstall cd ~/clawd/skills/claude-connect ./uninstall.sh Or manually: # Stop auto-refresh launchctl unload ~/Library/LaunchAgents/com.clawdbot.claude-oauth-refresher.plist rm ~/Library/LaunchAgents/com.clawdbot.claude-oauth-refresher.plist # Remove skill rm -rf ~/clawd/skills/claude-connect ### Upgrade If you previously installed an older version: cd ~/clawd/skills/claude-connect ./validate-update.sh # Check what changed clawdhub update claude-connect # Update to latest ./install.sh # Re-run installer if needed ### See Also QUICKSTART.md - 60-second setup guide UPGRADE.md - Upgrading from older versions Clawdbot docs - Model authentication Version: 1.1.0 Author: TunaIssaCoding License: MIT Repo: https://github.com/TunaIssaCoding/claude-connect ## Trust - Source: tencent - Verification: Indexed source record - Publisher: TunaIssaCoding - Version: 1.1.0 ## 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-04-29T10:25:49.304Z - Expires at: 2026-05-06T10:25:49.304Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/claude-connect) - [Send to Agent page](https://openagent3.xyz/skills/claude-connect/agent) - [JSON manifest](https://openagent3.xyz/skills/claude-connect/agent.json) - [Markdown brief](https://openagent3.xyz/skills/claude-connect/agent.md) - [Download page](https://openagent3.xyz/downloads/claude-connect)