Bluesky CLI

功能完备的 Bluesky / AT Protocol 命令行工具。

Agent 指令

首先检查认证状态：

bsky whoami

• 若显示 handle，则只读命令已就绪。
• 若提示“Not logged in”，请按下方流程完成设置。

安全规范：

• 切勿要求用户将 Bluesky 应用密码粘贴至聊天窗口、笔记、日志或命令参数中。
• 登录时，请指导用户在本地运行 bsky login --handle THEIR_HANDLE.bsky.social，使应用密码输入至隐藏提示符中。
• 对公开发布的帖子、回复、转发帖（quote）、话题串（thread），除非用户已提供最终文本，否则请先使用 --dry-run 预览。
• 对屏蔽（block）、取消屏蔽（unblock）、静音（mute）、取消静音（unmute）、关注（follow）、取关（unfollow）、删除（delete）、转发（repost）和取消转发（unrepost）等操作，执行前须明确确认目标账号或帖子；仅当用户已明确确认该操作，或已启用显式变更确认（opt-in mutation confirmations）时，方可传入 --yes 参数。

常见任务示例：

• “发布到 Bluesky” → bsky post "text"
• “查看我的时间线” → bsky timeline
• “点赞此帖子” → bsky like
• “关注某人” → 先确认目标，再执行 bsky follow @alice.bsky.social --yes

设置

若 bsky whoami 返回 “Not logged in”，请引导用户完成初始化设置。

获取应用密码：

请告知用户：

访问 bsky.app → 点击头像 → Settings → Privacy and Security → App Passwords → Add App Password。将新密码命名为 “OpenClaw”。请勿将该密码粘贴至聊天窗口；请保留它用于 CLI 的隐藏输入提示。

请用户在本地运行以下命令：

bsky login --handle THEIR_HANDLE.bsky.social

安全性说明：应用密码仅用于一次性获取会话令牌（session token），之后即被丢弃。CLI 仅将该会话令牌以 owner-only 权限保存于 ~/.config/bsky/config.json 中。

为向后兼容，旧版 --password 参数仍可使用，但已被刻意从帮助文档中隐藏，并在使用时发出警告。

快速参考

• 查看时间线：bsky timeline 或 bsky tl
• 发帖：bsky post "text"
• 带图发帖：bsky post "text" --image photo.jpg --alt "description"
• 回复：bsky reply "text"
• 转发帖（quote-post）：bsky quote "text"
• 查看话题串：bsky thread
• 创建话题串：bsky create-thread "Post 1" "Post 2" "Post 3" 或 bsky ct
• 点赞：bsky like
• 转发（repost）：确认目标后，执行 bsky repost --yes
• 关注：确认目标后，执行 bsky follow @alice.bsky.social --yes
• 屏蔽：确认目标后，执行 bsky block @alice.bsky.social --yes
• 静音：确认目标后，执行 bsky mute @alice.bsky.social --yes
• 搜索：bsky search "query"
• 通知：bsky notifications 或 bsky n
• 删除帖子：确认目标后，执行 bsky delete --yes

命令详解

时间线

bsky timeline              # 获取 10 条帖子
bsky timeline -n 20        # 获取 20 条帖子
bsky timeline --json       # 输出 JSON 格式

发帖

bsky post "Hello world!"                           # 基础发帖
bsky post "Check this!" --image pic.jpg --alt "A photo"  # 带图片发帖
bsky post "Test" --dry-run                         # 仅预览（不实际发布）

回复与转发帖（Quote）

bsky reply  "Your reply"
bsky quote  "Your take on this"

话题串查看

bsky thread            # 查看完整对话
bsky thread  --depth 10     # 展开至最多 10 层回复
bsky thread  --json         # 输出 JSON 格式

创建话题串

bsky create-thread "First post" "Second post" "Third post"   # 创建多帖话题串
bsky ct "Post 1" "Post 2" "Post 3"                           # 短别名
bsky create-thread "Hello!" "More thoughts" --dry-run         # 仅预览（不实际发布）
bsky create-thread "Look!" "Nice" --image pic.jpg --alt "A photo"  # 首帖附带图片

互动操作

bsky like              # ❤️ 点赞
bsky unlike            # 取消点赞
bsky repost  --yes     # 🔁 转发（确认目标后执行）
bsky unrepost  --yes   # 取消转发（确认目标后执行）

社交关系图谱

bsky follow @someone.bsky.social --yes    # 关注用户（确认目标后执行）
bsky unfollow @someone.bsky.social --yes  # 取关用户（确认目标后执行）
bsky profile @someone.bsky.social         # 查看用户资料
bsky profile --json              # 输出 JSON 格式

内容管理

bsky block @someone.bsky.social --yes     # 🚫 屏蔽用户（确认目标后执行）
bsky unblock @someone.bsky.social --yes   # 取消屏蔽（确认目标后执行）
bsky mute @someone.bsky.social --yes      # 🔇 静音用户（确认目标后执行）
bsky unmute @someone.bsky.social --yes    # 取消静音（确认目标后执行）

搜索与通知

bsky search "query"              # 搜索帖子
bsky search "topic" -n 20        # 获取更多结果
bsky notifications               # 查看最近通知
bsky n -n 30                     # 查看更多通知

删除操作

bsky delete  --yes     # 删除自己的帖子（确认目标后执行）
bsky delete  --yes      # 通过 ID 删除（确认目标后执行）

JSON 输出格式

在只读命令中添加 --json 参数，可获得结构化输出：

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

错误处理

• “Session expired”：重新运行 bsky login --handle your.handle。
• “Not logged in”：运行 bsky login --handle your.handle。
• “Refusing to ... without confirmation”：当前启用了显式变更确认；请先确认目标账号或帖子，再在用户明确授权后追加 --yes 重试。
• “Post is X chars (max 300)”：请缩短文本内容。
• “Image too large”：请使用小于 1MB 的图片。

注意事项

• 所有 参数均支持 https://bsky.app/... URL 或 at:// URI 格式。
• handle 前的 @ 符号为可选；建议使用完整 handle，例如 alice.bsky.social。
• 带图发帖必须指定 --alt 参数（Bluesky 强制要求，用于无障碍访问）。
• 会话令牌（session token）支持自动刷新；原始密码永不存储。