bluesky

---
name: bluesky
version: 1.6.0
description: "Complete Bluesky CLI: post, reply, like, repost, follow, block, mute, search, threads, images. Everything you need to engage on Bluesky from the terminal."
homepage: https://bsky.app
metadata:
  openclaw:
    emoji: "🦋"
    requires:
      bins: ["python3"]
    tags: ["social", "bluesky", "at-protocol", "cli"]
---

# Bluesky CLI

Full-featured CLI for Bluesky/AT Protocol.

## Agent Instructions

**First: Check if logged in**
```bash
bsky whoami
```

- If shows handle → ready to use commands below
- If "Not logged in" → guide user through Setup section

**Common tasks:**
- "Post to Bluesky" → `bsky post "text"`
- "Check my timeline" → `bsky timeline`
- "Like this post" → `bsky like <url>`
- "Follow someone" → `bsky follow @handle`

## Setup

If user isn't logged in (`bsky whoami` shows "Not logged in"), guide them through setup:

### Getting an App Password

Tell the user:
> Go to bsky.app → click your avatar → Settings → Privacy and Security → App Passwords → Add App Password. Name it "OpenClaw" and copy the password (like `xxxx-xxxx-xxxx-xxxx`). You'll only see it once!

### Logging In

Once they have the app password, run:
```bash
bsky login --handle THEIR_HANDLE.bsky.social --password THEIR_APP_PASSWORD
```

Example:
```bash
bsky login --handle alice.bsky.social --password abcd-1234-efgh-5678
```

**Security:** Password is used once to get a session token, then immediately discarded. Never stored on disk. Session auto-refreshes.

## Quick Reference

| Action | Command |
|--------|---------|
| View timeline | `bsky timeline` or `bsky tl` |
| Post | `bsky post "text"` |
| Post with image | `bsky post "text" --image photo.jpg --alt "description"` |
| Reply | `bsky reply <url> "text"` |
| Quote-post | `bsky quote <url> "text"` |
| View thread | `bsky thread <url>` |
| Create thread | `bsky create-thread "Post 1" "Post 2" "Post 3"` or `bsky ct` |
| Like | `bsky like <url>` |
| Repost | `bsky repost <url>` |
| Follow | `b