claude-connect
by tunaissacoding
Clawdbot ToolsBrief
Connect Claude to Clawdbot instantly and keep.
Description
What This Skill Does
Bridges a Claude CLI subscription to Clawdbot by reading OAuth tokens from macOS Keychain and writing them in the format Clawdbot expects. Fixes a known bug in `clawdbot onboard --auth-choice claude-cli` that leaves auth-profiles.json incomplete. Sets up a launchd job to refresh tokens every 2 hours.
Eliminates the manual workaround required when clawdbot onboard leaves OAuth tokens in an unusable state, and prevents repeated auth failures by running automatic refreshes in the background.
When to Use It
- Fixing broken Claude auth after clawdbot onboard fails silently
- Keeping Clawdbot connected to Claude without manual token refreshes
- Initial Claude-to-Clawdbot setup on a new macOS machine
- Diagnosing why Clawdbot reports expired or missing Claude tokens
- Automating token refresh to prevent 8-hour expiry interruptions
Example Workflow
User asks: Clawdbot can't authenticate with Claude after running clawdbot onboard
- 1
Runs ./install.sh to verify Claude CLI is authenticated and create config
- 2
Reads OAuth tokens from macOS Keychain entry 'Claude Code-credentials'
- 3
Writes tokens to ~/.clawdbot/agents/main/agent/auth-profiles.json in proper OAuth format
- 4
Installs launchd plist to auto-refresh tokens every 2 hours
- 5
Sends notification confirming successful connection
Clawdbot connected to Claude with tokens persisted and auto-refreshing every 2 hours
Requirements
- Active Claude subscription with Claude CLI installed and authenticated via 'claude auth'
- Clawdbot installed
- macOS (requires Keychain and launchd)
Installation
clawhub install tunaissacoding/claude-connectRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.