claude-connect

What This Skill Does

The claude-connect skill serves as the bridge between your existing Claude CLI authentication and the OpenClaw ecosystem. Many users encounter difficulties when initializing clawdbot onboard because the OAuth flow often fails to properly persist credentials into the auth-profiles.json file. This skill automates the entire lifecycle of your Claude session. It securely extracts OAuth tokens directly from the macOS Keychain—where the official Claude CLI stores them—and maps them into the precise format required by Clawdbot. Beyond mere initial configuration, the skill deploys a background launchd agent that proactively monitors token expiry. By executing a refresh cycle every two hours, it guarantees that your agent remains authenticated 24/7, effectively eliminating session timeouts and the need for manual re-login flows.

Installation

Installing the skill is streamlined for efficiency. Begin by navigating to your skills directory and using the Clawhub install command: clawhub install openclaw/skills/skills/tunaissacoding/claude-connect. Once the files are cloned, ensure your Claude CLI is authenticated by running claude auth and completing the web-based login. Finally, execute the ./install.sh script. This script validates your environment, configures the necessary JSON settings, and registers the background refresh job to ensure your agent stays online indefinitely.

Use Cases

• Continuous Agent Uptime: Perfect for users building long-running research or automation agents that require persistent Claude access without manual daily re-authentication.
• Fixing Broken OAuth: If you are experiencing "auth-profiles" errors during onboard, this skill acts as a automated patch to force-write the correct credentials.
• Multi-Device Synchronization: By managing the token lifecycle locally, you ensure that your Clawdbot agent always has a fresh connection, even if you rarely use the CLI directly.

Example Prompts

• "OpenClaw, verify my current Claude authentication status and check the next scheduled token refresh time."
• "Run a manual authentication force-refresh using the claude-connect script to ensure my connection is current."
• "Update my claude-oauth-refresh-config.json to increase the refresh buffer to 60 minutes and enable verbose logging."

Tips & Limitations

• Keychain Access: This skill requires that you have used the official Claude CLI on the same machine, as it depends on the presence of the OAuth tokens in your macOS Keychain.
• Monitoring: Always check ~/clawd/logs/claude-oauth-refresh.log if you notice your agent becoming unresponsive; this log file will indicate if the refresh process is failing due to expired refresh tokens.
• Security: Ensure your system user has restricted permissions to the ~/.clawdbot/ directory, as this skill writes sensitive token data to that location.