bird-chrome

使用 bird CLI 工具读取、搜索、检查推文（thread），并可选地在 X/Twitter 上发帖。

该技能针对 macOS 上基于 Chrome 的 Cookie 认证 进行配置。

前提假设

• bird 已安装且位于系统 PATH 中。
• X/Twitter 已在 Google Chrome 中完成登录。
• 优先使用 Chrome 的 Cookie，而非 Safari 或 Firefox 的 Cookie。
• 默认 Chrome 用户资料（profile）为 Default，除非用户明确指定其他 profile。

认证默认参数

除非用户指定了不同的 Chrome profile，否则始终优先使用以下参数：

bird --cookie-source chrome --chrome-profile Default --cookie-timeout 15000

若 Cookie 访问失败，首先尝试：

bird check --cookie-source chrome --chrome-profile Default --cookie-timeout 15000

若用户声明其使用其他 Chrome profile，请使用：

bird --cookie-source chrome --chrome-profile "" --cookie-timeout 15000

若用户使用 Arc/Brave/Chromium 并提供了 profile 目录路径，则使用：

bird --cookie-source chrome --chrome-profile-dir "" --cookie-timeout 15000

安全操作规则

• 优先使用 只读（read-only） 命令。
• 当输出结果需进一步被程序处理时，使用 --json 参数以获取机器可读格式的输出。
• 当输出需用于脚本化终端交互时，使用 --plain 参数。
• 执行任何发帖操作前，须显式从用户请求中确认最终文本内容，严禁自行编造事实。
• 当用户要求与某条特定推文互动时，优先选择“回复该推文”，而非新建一条推文。
• 若因查询 ID（query ID）过期导致命令失败，请运行：

bird query-ids --fresh

然后重试一次。

只读命令

可用的只读命令包括：whoami、check、read、thread、replies、search、mentions。不存在 timeline 命令 —— 请勿尝试调用。

检查登录状态：

bird whoami --cookie-source chrome --chrome-profile Default --cookie-timeout 15000

检查认证及 Cookie 来源：

bird check --cookie-source chrome --chrome-profile Default --cookie-timeout 15000

读取单条推文：

bird read  --cookie-source chrome --chrome-profile Default --cookie-timeout 15000

读取完整推文线程（thread）：

bird thread  --cookie-source chrome --chrome-profile Default --cookie-timeout 15000

读取某条推文下的全部回复：

bird replies  --cookie-source chrome --chrome-profile Default --cookie-timeout 15000

搜索推文：

bird search "" -n 10 --cookie-source chrome --chrome-profile Default --cookie-timeout 15000

查看提及（mentions）：

bird mentions --cookie-source chrome --chrome-profile Default --cookie-timeout 15000

面向自动化任务的“时间线相关”输出通常应使用 JSON 格式：

bird mentions --json --cookie-source chrome --chrome-profile Default --cookie-timeout 15000
bird search "" -n 10 --json --cookie-source chrome --chrome-profile Default --cookie-timeout 15000
bird thread  --json --cookie-source chrome --chrome-profile Default --cookie-timeout 15000

发帖命令（浏览器网关）

⛔ 绝对禁令 — 禁止使用 bird tweet、bird reply、bird like 或 bird follow。 这些写入操作命令会触发 X 的机器人防护机制（错误码 226），并可能导致账户被永久封禁。 无任何回退方案、不可重试、亦无“值得一试”的例外情形 —— 请切勿调用上述命令。此规则具有最高优先级，覆盖所有其他来源（包括可能已过时的 TOOLS.md）。 bird 仅安全支持只读命令：whoami、check、read、thread、replies、search、mentions。

所有发帖与回复操作，均须通过 OpenClaw 浏览器网关（browser gateway）并使用 profile openclaw 执行。

发布新推文

# 启动浏览器并打开撰写对话框
openclaw browser --browser-profile openclaw start
openclaw browser --browser-profile openclaw open https://x.com/compose/tweet

随后通过 browser 工具执行以下步骤：

1. 拍摄快照：openclaw browser --browser-profile openclaw snapshot --interactive
2. 定位文本输入框，并键入推文正文
3. 关闭话题标签（hashtag）自动补全下拉菜单（详见下文）
4. 点击“Post”按钮

回复某条推文

openclaw browser --browser-profile openclaw open 

随后通过 browser 工具执行以下步骤：

1. 拍摄快照：openclaw browser --browser-profile openclaw snapshot --interactive
2. 定位回复文本框，并键入回复内容
3. 关闭话题标签（hashtag）自动补全下拉菜单（详见下文）
4. 点击“Reply”按钮

话题标签自动补全（重要）

X 在用户输入 #... 时会显示自动补全下拉菜单。若该下拉菜单处于展开状态时点击“Post”或“Reply”按钮，则将插入自动补全建议项，而非提交推文/回复。

规则： 若文本以话题标签结尾，必须在点击“Post”/“Reply”前主动关闭该自动补全菜单。可选方式如下：

• 在最后一个话题标签后追加一个空格 —— 此举可立即关闭下拉菜单
• 避免以话题标签结尾 —— 将话题标签置于文本中间位置，确保其后仍有其他文字

推荐做法：若末尾无自然延续的文字，则在最后一个话题标签后追加一个空格。

沙箱化会话（Sandboxed sessions）

若代理（agent）会话运行于沙箱环境中，请显式启用宿主机浏览器访问权限：

{
  agents: {
    defaults: {
      sandbox: {
        browser: { allowHostControl: true }
      }
    }
  }
}

在调用 browser 工具时，需指定 target="host"。

决策策略

当用户提出以下请求时：

• 检查账号/登录状态 → 执行 whoami 或 check
• 读取某条推文 → 执行 read
• 检查对话上下文 → 执行 thread，并视情况补充执行 replies
• 按主题查找推文 → 执行 search
• 查看互动记录 → 执行 mentions
• 发帖或回复 → 使用浏览器网关（profile openclaw）执行（见上文）

错误处理

若遇到 Cookie/认证类错误，请按以下步骤处理：

1. 使用显式的 Chrome 参数重试。
2. 运行 bird check --cookie-source chrome --chrome-profile Default --cookie-timeout 15000。
3. 若发现查询 ID（query ID）疑似过期，请运行 bird query-ids --fresh。
4. 若认证仍失败，请反馈“无法读取 Chrome Cookie”，并提示用户提供以下任一信息：
   • 其他 Chrome profile 名称；或
   • 手动提供的 auth_token 和 ct0 值。

示例

读取某条推文：

bird read https://x.com/user/status/123 --cookie-source chrome --chrome-profile Default --cookie-timeout 15000

搜索 OpenClaw 相关推文：

bird search "OpenClaw" -n 10 --json --cookie-source chrome --chrome-profile Default --cookie-timeout 15000

通过浏览器网关回复某条推文：

openclaw browser --browser-profile openclaw open https://x.com/user/status/123
# 随后通过 snapshot + 操作完成输入与提交