chirp

使用 OpenClaw 浏览器工具操作 X/Twitter。是 bird CLI 的基于浏览器的替代方案。

前提条件

环境要求

• 已启用浏览器工具的 OpenClaw
• openclaw 浏览器配置文件
• X/Twitter 账户已登录

若为无头服务器（Headless Server）

需配置 Xvfb 虚拟显示（参见 spool 技能的 Prerequisites）

登录（仅首次需要）

browser action=start profile=openclaw
browser action=open profile=openclaw targetUrl="https://x.com/login"
# 提示用户手动完成登录

使用方法

1. 读取时间线（Timeline）

browser action=open profile=openclaw targetUrl="https://x.com/home"
browser action=snapshot profile=openclaw compact=true

可在每个 article 中查看作者、内容，以及点赞数、转发数和回复数。

2. 发送推文（Tweet）

步骤 1：在首页定位文本框

browser action=open profile=openclaw targetUrl="https://x.com/home"
browser action=snapshot profile=openclaw compact=true

→ 查找 textbox "Post text" 的 ref

步骤 2：输入内容

browser action=act profile=openclaw request={"kind":"click","ref":""}
browser action=act profile=openclaw request={"kind":"type","ref":"","text":"트윗 내용"}

步骤 3：点击 Post 按钮

browser action=snapshot profile=openclaw compact=true

→ 查找 button "Post" 的 ref（确保其未被禁用）

browser action=act profile=openclaw request={"kind":"click","ref":""}

3. 点赞（Like）

在时间线中查找 article 内的 button "Like" 或 button "X Likes. Like" 的 ref，然后执行：

browser action=act profile=openclaw request={"kind":"click","ref":""}

4. 转发（Repost）

查找 button "Repost" 或 button "X reposts. Repost" 的 ref，然后执行：

browser action=act profile=openclaw request={"kind":"click","ref":""}
browser action=snapshot profile=openclaw compact=true
# 选择 “Repost” 选项
browser action=act profile=openclaw request={"kind":"click","ref":""}

5. 回复（Reply）

方式 1：在时间线中直接回复

browser action=act profile=openclaw request={"kind":"click","ref":""}
browser action=snapshot profile=openclaw compact=true
# 在回复输入框中输入文本后，点击 Reply 按钮

方式 2：在推文详情页中回复

browser action=open profile=openclaw targetUrl="https://x.com/username/status/1234567890"
browser action=snapshot profile=openclaw compact=true
# 查找回复输入框并输入内容

6. 查看个人资料（Profile）

browser action=open profile=openclaw targetUrl="https://x.com/username"
browser action=snapshot profile=openclaw compact=true

7. 搜索（Search）

browser action=open profile=openclaw targetUrl="https://x.com/search?q=검색어&src=typed_query"
browser action=snapshot profile=openclaw compact=true

8. 关注（Follow）

在个人资料页面中查找 button "Follow" 的 ref，然后执行：

browser action=act profile=openclaw request={"kind":"click","ref":""}

关键要点

1. 先执行 snapshot —— 所有操作前务必先获取当前页面快照以确认状态
2. ref 每次均不同 —— 必须从每次 snapshot 结果中重新提取 ref
3. 使用 compact=true —— 可显著节省 token 消耗
4. article 结构 —— 每条推文均封装在 article 元素内，其中包含作者信息、正文内容及各类操作按钮
5. 发送前人工确认 —— 推文内容须经用户确认后再提交

故障排除（Troubleshooting）

vs bird CLI