Bluesky命令行界面

适用于Bluesky/AT协议的全功能命令行工具。

代理指令

第一步：检查是否已登录

bsky whoami

• 如果显示用户句柄 → 可立即使用以下命令
• 如果显示"未登录" → 引导用户完成设置部分

常用任务：

• "发布到Bluesky" →bsky post "文本内容"
• "查看我的时间线" →bsky timeline
• "点赞这条帖子" →bsky like <帖子链接>
• "关注某人" →bsky follow @用户句柄

设置

如果用户未登录（运行 bsky whoami显示"未登录"），引导其完成设置：

获取应用密码

告知用户：

前往bsky.app → 点击你的头像 → 设置 → 隐私与安全 → 应用密码 → 添加应用密码。将其命名为"OpenClaw"并复制密码（例如xxxx-xxxx-xxxx-xxxx）。此密码仅显示一次！

登录

获取应用密码后，运行：

bsky login --handle THEIR_HANDLE.bsky.social --password THEIR_APP_PASSWORD

示例：

bsky login --handle alice.bsky.social --password abcd-1234-efgh-5678

安全性：密码仅用于获取会话令牌一次，随后立即丢弃。从不存储在磁盘上。会话会自动刷新。

快速参考

命令

时间线

bsky timeline              # 10 posts
bsky timeline -n 20        # 20 posts
bsky timeline --json       # JSON output

发帖

bsky post "Hello world!"                           # Basic post
bsky post "Check this!" --image pic.jpg --alt "A photo"  # With image
bsky post "Test" --dry-run                         # Preview only

回复与引用

bsky reply <post-url> "Your reply"
bsky quote <post-url> "Your take on this"

主题视图

bsky thread <post-url>           # View conversation
bsky thread <url> --depth 10     # More replies
bsky thread <url> --json         # JSON output

创建主题

bsky create-thread "First post" "Second post" "Third post"   # Create a thread
bsky ct "Post 1" "Post 2" "Post 3"                           # Short alias
bsky create-thread "Hello!" "More thoughts" --dry-run         # Preview only
bsky create-thread "Look!" "Nice" --image pic.jpg --alt "A photo"  # Image on first post

互动

bsky like <post-url>             # ❤️ Like
bsky unlike <post-url>           # Remove like
bsky repost <post-url>           # 🔁 Repost (aliases: boost, rt)
bsky unrepost <post-url>         # Remove repost

社交图谱

bsky follow @someone             # Follow user
bsky unfollow @someone           # Unfollow user
bsky profile @someone            # View profile
bsky profile --json              # JSON output

内容管理

bsky block @someone              # 🚫 Block user
bsky unblock @someone            # Unblock
bsky mute @someone               # 🔇 Mute user
bsky unmute @someone             # Unmute

搜索与通知

bsky search "query"              # Search posts
bsky search "topic" -n 20        # More results
bsky notifications               # Recent notifications
bsky n -n 30                     # More notifications

删除

bsky delete <post-url>           # Delete your post
bsky delete <post-id>            # By ID

JSON输出

添加--json以读取结构化输出的命令：

bsky timeline --json
bsky search "topic" --json
bsky notifications --json
bsky profile @someone --json
bsky thread <url> --json

错误处理

备注

• 全部<URL>参数接受https://bsky.app/...URL或at://URI
• 自动追加处理.bsky.social如未指定域名
• 图片帖子需要--alt以实现无障碍访问（Bluesky平台要求）
• 会话令牌自动刷新；密码永不存储