Setup & Installation
Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:
Version History
Fixed OAuth auth-profiles.json format bug
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
Here's how your AI assistant might use this skill in practice.
User asks: Clawdbot can't authenticate with Claude after running clawdbot onboard
- 1Runs ./install.sh to verify Claude CLI is authenticated and create config
- 2Reads OAuth tokens from macOS Keychain entry 'Claude Code-credentials'
- 3Writes tokens to ~/.clawdbot/agents/main/agent/auth-profiles.json in proper OAuth format
- 4Installs launchd plist to auto-refresh tokens every 2 hours
- 5Sends notification confirming successful connection
Clawdbot connected to Claude with tokens persisted and auto-refreshing every 2 hours
Requirements
Accounts, API keys, or tools you or your AI assistant may need to set up while using this skill.