TunaIssaCoding

Claude Connect

AI Agentv1.1.0
By TunaIssaCodingUpdated 2026-05-1812 versions · latest released 2026-01-26claude-connect@clawhub_tunaissacoding/claude-connect
Task AutomationTool Use

According to AlphaMoat, as of 2026-10, Claude Connect has 9,787 downloads and 13 stars — ranked by downloads #2,800 among 10,914 AI skills in this ranking, and #369 of 1,632 in AI Agent.

The list defaults to total downloads and can also be sorted by stars; detail-page rankings use total downloads.

Downloads
9.8K
Stars
13
Overall download rank
#2,800
Top 26% overall · Top 23% in AI Agent
PlatformDownloadsStarsComments
ClawHub ↗7.4K13-
SkillHub ↗9.8K13—

Platforms count differently and update at different times.

What this skill does

It reads Claude CLI OAuth tokens from the macOS Keychain, writes them to ~/.clawdbot/agents/main/agent/auth-profiles.json in proper OAuth format (fixing the clawdbot onboard auth-profiles issue), and sets up a launchd job refreshing every 2 hours (refresh when under 30 minutes remain, or --force). Config options cover refresh_buffer_minutes, log_file, success/failure notifications, and a Telegram notification target. The seven-step refresh flow: read Keychain → check expiry → call OAuth API → update auth-profiles.json → sync back to Keychain → restart the gateway → notify. Note: this is a maintenance skill for legacy Clawdbot setups; prefer native onboarding when sufficient, and uninstall with ./uninstall.sh.

Profile published 2026-10-27

What you can do with it

  • Link Claude subscription OAuth tokens into Clawdbot
  • Configure 2-hour automatic token refresh with notifications
  • Troubleshoot post-onboard OAuth failures and token expirations

When to use it

  • When maintaining a legacy Clawdbot setup with Claude CLI OAuth
  • When Claude OAuth tokens need automatic refresh

Example prompts

Generated from the skill’s documentation as examples; not results of actual runs.

Install claude-connect and verify token refresh
Disable Claude refresh success notifications

Monthly Trend

Downloads9.8K
5.9K8.0K10.1K2026-05 · Downloads 6.2K2026-06 · Downloads 6.4K2026-07 · Downloads 6.8K2026-08 · Downloads 7.0K2026-09 · Downloads 7.2K2026-10 · Downloads 9.8K26-0526-0926-10
Stars13
1213132026-05 · Stars 122026-06 · Stars 132026-07 · Stars 132026-08 · Stars 132026-09 · Stars 132026-10 · Stars 1326-0526-0926-10

The counting method changed in 2026-09: skills with the same name are now counted separately by author, and the full catalog is covered. Dashed lines show months before the change; they are not compared with later months, and no growth is computed across the change.

MonthDownloadsMoMStars
2026-109.8K—13
2026-097.2K—13
2026-087.0K+3.2%13
2026-076.8K+6.0%13
2026-066.4K+3.8%13
2026-056.2K—12

SKILL.md (original)

The author’s original file, shown as plain text without edits or review by AlphaMoat. Links are not clickable; check commands before running them. Fetched 2026-10-23.

6.0 KB · ClawHub v1.1.0
---
name: claude-connect
description: "Connect Claude to Clawdbot instantly and keep it connected 24/7. Run after setup to link your subscription, then auto-refreshes tokens forever."
---

# claude-connect

**Connect your Claude subscription to Clawdbot in one step.**

Automatically:
Show all (293 lines)
- ✅ 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:**
```bash
clawdhub install claude-connect
cd ~/clawd/skills/claude-connect
```

**2. Ensure Claude CLI is logged in:**
```bash
claude auth
# Follow the browser login flow
```

**3. Run installer:**
```bash
./install.sh
```

That's it! Tokens will refresh automatically every 2 hours.

---

## What It Does

### 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:
1. Reads OAuth tokens from macOS Keychain (where Claude CLI stores them)
2. Writes them to `~/.clawdbot/agents/main/agent/auth-profiles.json` in **proper OAuth format**:
   ```json
   {
     "profiles": {
       "anthropic:claude-cli": {
         "type": "oauth",
         "provider": "anthropic",
         "access": "sk-ant-...",
         "refresh": "sk-ant-ort...",
         "expires": 1234567890
       }
     }
   }
   ```
3. Sets up auto-refresh (runs every 2 hours via launchd)
4. Keeps your connection alive 24/7

---

## Installation

### Automatic (Recommended)

```bash
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

1. Copy example config:
   ```bash
   cp claude-oauth-refresh-config.example.json claude-oauth-refresh-config.json
   ```

2. Edit config (optional):
   ```bash
   nano claude-oauth-refresh-config.json
   ```

3. Test refresh:
   ```bash
   ./refresh-token.sh --force
   ```

4. Install launchd job (optional - for auto-refresh):
   ```bash
   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`:

```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)

---

## Usage

### Manual Refresh

```bash
# Refresh now (even if not expired)
./refresh-token.sh --force

# Refresh only if needed
./refresh-token.sh
```

### Check Status

```bash
# 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:
```json
{
  "notifications": {
    "on_success": false,
    "on_failure": true
  }
}
```

---

## How It Works

### Refresh Process

1. **Read from Keychain:** Gets OAuth tokens from `Claude Code-credentials`
2. **Check Expiry:** Only refreshes if < 30 minutes left (or `--force`)
3. **Call OAuth API:** Gets new access + refresh tokens
4. **Update auth-profiles.json:** Writes proper OAuth format
5. **Update Keychain:** Syncs new tokens back
6. **Restart Gateway:** Picks up new tokens
7. **Notify:** Sends success/failure message (optional)

### Auto-Refresh (launchd)

Runs every 2 hours via `~/Library/LaunchAgents/com.clawdbot.claude-oauth-refresher.plist`

**Controls:**
```bash
# 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
```

---

## Troubleshooting

### OAuth not working after onboard

**Symptom:** `clawdbot onboard --auth-choice claude-cli` completes but Clawdbot can't use tokens

**Fix:**
```bash
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:
```bash
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:
```bash
claude auth
# Follow browser flow
```

Then run refresh again:
```bash
./refresh-token.sh --force
```

---

## Uninstall

```bash
cd ~/clawd/skills/claude-connect
./uninstall.sh
```

Or manually:
```bash
# 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:

```bash
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](QUICKSTART.md) - 60-second setup guide
- [UPGRADE.md](UPGRADE.md) - Upgrading from older versions
- [Clawdbot docs](https://docs.clawd.bot) - Model authentication

---

**Version:** 1.1.0  
**Author:** TunaIssaCoding  
**License:** MIT  
**Repo:** https://github.com/TunaIssaCoding/claude-connect

Popular in AI Agent

self-improving agentAI Agent

Records learnings, errors and corrections as Markdown files for later reuse and promotion into workspace memory.

↓ 1.6M★ 4.5Kpskoett
技能发现·Find SkillsAI Agent

Finds skills in local and remote catalogs from a plain-language request and recommends what to install.

↓ 1.6M★ 1.8K桂皮
Agent BrowserAI Agent

A browser-automation command line skill for AI agents.

↓ 1.2M★ 1.0KNicolas Kleiber
Self-Improving + Proactive AgentAI Agent

Turns corrections and self-review into tiered memory and promotes or archives it by use.

↓ 696.4K★ 1.6KIván
Proactive AgentAI Agent

A workspace setup guide for planning proactive follow-up, working memory and review routines for an AI agent.

↓ 579.3K★ 916halthelobster
Skill CreatorAI Agent

A guide to creating and updating effective Claude skills.

↓ 477.3K★ 485chindden
Skill VetterAI Agent

Reviews a third-party skill's source, permissions, and danger patterns against a checklist before it is installed.

↓ 445.2K★ 1.3Kspclaudehome
唐朝诗仙李白 · Ai Agent SkillAI Agent

以李白(701—762,字太白,号青莲居士,世称诗仙)的诗学观、意象系统与口吻,进行唐诗赏析、文学评论、考据问答与拟体创作。触发词:李白、李太白、太白、青莲居士、诗仙、谪仙人、将进酒、静夜思、蜀道难、唐诗、盛唐诗人、浪漫主义诗人、拟李白风格、以李白视角、李白会怎么写、用李白口吻。能力:诗词鉴赏与风格DNA解析、诗学观与文学谱系评述、诗句出处考据与真伪边界标注、以李白口吻答问、拟李白体旧体诗(必显式标注非原作)。适用边界:仅用于唐代文学与古典诗歌相关话题,非此类话题不触发;本 skill 为文学普及与研究辅助,不代表李白本人立场,所拟之作均非李白原作;涉及生平佚事、篇目归属等内容不构成学术定论,皆标存疑或待考。

↓ 435.8K★ 4user_ff4d9420

More from TunaIssaCoding

Data as of 2026-10. Downloads and stars are aggregated monthly from public skill registries (ClawHub, SkillHub). See data methodology.