Clawbsky

🦞 clawbsky v2.0.13

The ultimate AI-powered Bluesky CLI for power users, creators, and automation enthusiasts.

✨ What's New in v2.0.x

• 🤖 AI Content Studio — Generate posts, threads, alt-text, and smart replies powered by OpenAI, Anthropic, or local Ollama
• 👤 Multi-User Sessions — Login with multiple Bluesky accounts and switch between them instantly
• 📅 Post Scheduler — Schedule posts for later with a persistent SQLite-backed queue and a background daemon
• 📊 Analytics Dashboard — Track engagement stats, top posts, follower growth, and optimal posting times
• 📰 RSS Feed Automation — Subscribe to RSS feeds and auto-curate content for posting
• ✍️ Content Enhancement — Auto-generate alt-text, quote cards, and repurpose content across formats

🚀 Setup

1. Get an App Password: Go to Bluesky Settings and create a new App Password. NEVER use your main account password.
2. Install:

   npm install
   

3. Login:

   clawbsky login
   

🤖 AI Setup (Optional)

For AI features, configure your LLM provider:

# OpenAI (default)
export LLM_API_KEY="sk-..."
export LLM_MODEL="gpt-4o-mini"

# Anthropic
export LLM_PROVIDER="anthropic"
export LLM_API_KEY="sk-ant-..."

# Ollama (local, free)
export LLM_PROVIDER="openai-compatible"
export LLM_BASE_URL="http://localhost:11434/v1"
export LLM_MODEL="llama3"

Note: When used as an OpenClaw skill, AI is provided by OpenClaw's main LLM — no additional config needed!

🛠 Commands

👤 Multi-User Authentication

clawbsky login                       # Login (saves session for reuse)
clawbsky whoami                      # Show active account + other profiles
clawbsky auth list                   # List all logged-in profiles
clawbsky auth switch         # Switch active profile
clawbsky auth logout [handle]        # Logout a specific or active profile

# Run ANY command as a specific user with -u
clawbsky whoami -u other.bsky.social
clawbsky post text "Hello!" -u second-account.bsky.social

🤖 AI Content Generation

clawbsky generate "post about AI trends"                  # Generate a post
clawbsky generate "5 tips for productivity" --tone=professional
clawbsky generate "topic" --thread --posts=5              # Generate a thread
clawbsky generate --improve "Check out my project!"       # Improve text
clawbsky reply-ai at://post-uri --count=3                 # AI reply suggestions
clawbsky analyze @username                                # AI profile analysis
clawbsky analyze at://post-uri --post                     # AI post analysis

📅 Post Scheduling

clawbsky schedule "Post text" --at 2026-07-01T10:00:00Z   # Schedule at time
clawbsky schedule "Post text" --in 2h                     # Schedule in 2 hours
clawbsky scheduled                                        # List queued posts
clawbsky scheduler                                        # Start scheduler daemon

📊 Analytics & Insights

clawbsky stats --days 7              # Engagement statistics
clawbsky top --limit 10 --sort likes # Top performing posts
clawbsky growth --days 30            # Follower growth tracking
clawbsky best-times                  # AI-suggested best posting times

✍️ Content Enhancement

clawbsky alt-text "image description" # Generate accessible ALT text
clawbsky quote "quote" --author Name  # Create a quote card
clawbsky repurpose "content" -f thread # Repurpose to thread/blog/tweet/linkedin

📰 RSS Feed Automation

clawbsky rss add --name "TechCrunch" --url https://feed.url --schedule hourly
clawbsky rss list                    # List subscribed feeds
clawbsky rss process                 # Process and post curated items

🚀 Growth & Maintenance

clawbsky unfollow-non-mutuals -n 50  # Unfollow top 50 non-mutuals
clawbsky follow-all "Query" -n 20    # Auto-follow users matching a topic
clawbsky cleanup --days 90           # Find inactive followers

📝 Posting & Threads

clawbsky post text "Text"            # Create a post
clawbsky post reply "Text"      # Reply to a post
clawbsky thread "Part 1" "Part 2"    # Create a multi-post thread
clawbsky quote  "My thoughts"   # Quote a post

📖 Reading & Discovery

clawbsky read home                   # View your timeline
clawbsky read user           # Inspect a profile
clawbsky read post              # Read a single post
clawbsky read thread            # Read a full thread
clawbsky read mentions               # Check recent mentions

🗂 List Management

clawbsky list create --name "Tech"   # Create a curated list
clawbsky list add            # Add user to list
clawbsky list view                   # View your lists

💡 Advanced Usage

Global Options

• -u, --user : Execute command under a specific logged-in profile
• --json: Get raw data for piping to other tools
• --plain: Disable emojis and formatting for cleaner logs
• -n : Limit results (default: 10)
• --dry-run: Preview actions without executing
• --post: Immediately post AI-generated content

Environment Variables

BSKY_IDENTIFIER=your-handle.bsky.social
BSKY_PASSWORD=your-app-password
# (See "AI Setup" section above for LLM environment variables)

🛡️ Safety & Ethics

1. Be Human: Don't use follow tools for mass following — considered spam
2. Respect Limits: Use unfollow-non-mutuals for periodic maintenance only
3. App Passwords Only: Never use your main password
4. Rate Limiting: Built-in delays prevent API limits

Responsibility for account actions lies solely with the user.

🔗 Links

• GitHub: https://github.com/jyothish12345/Clawbsky
• ClawHub: https://clawhub.ai/jyothish12345/clawbsky
• Web Dashboard: See clawbskyweb for the Cyberpunk visual dashboard companion

---

Built for the AT Protocol community with ❤️