browsex

使用 OpenClaw 浏览器工具操作 X（原 Twitter）。这是 bird CLI 的浏览器端替代方案。

前提条件

环境要求

• 已启用浏览器工具的 OpenClaw
• openclaw 浏览器配置文件
• 已登录的 X/Twitter 账户 （仅发布、点赞、转发、回复、关注等写入操作需要）

只读浏览（查看个人资料、单条推文、搜索）无需登录即可使用。 X 可能在未认证会话中弹出登录窗口——可直接关闭或忽略。

无头服务器环境

需配置 Xvfb 虚拟显示（参见 spool skill 的前提条件）

登录（仅写入操作需要）

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

使用方法

只读操作（无需登录）

以下操作无需 X/Twitter 账户即可执行。X 可能在浏览若干页面后弹出登录模态框——请在快照中查找“关闭”或“忽略”按钮并点击。

1. 查看某条特定推文

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

2. 查看用户个人资料页

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

3. 搜索

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

需登录的操作

以下操作需已通过身份验证的会话，请先完成前提条件中的登录步骤。

4. 查看时间线（Timeline）

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

每条推文（article）中均可看到作者、正文内容，以及点赞数、转发数和回复数。

5. 发布推文

步骤 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":"tweet content"}

步骤 3：点击“Post”按钮

browser action=snapshot profile=openclaw compact=true

→ 在快照中查找 button "Post" 的 ref（选择状态为启用、非禁用的按钮）

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

6. 点赞推文

在时间线中，于某条推文（article）内查找 button "Like" 或 button "X Likes. Like" 的 ref：

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

7. 转发（Retweet）

查找 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":""}

8. 回复推文

方法 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
# 查找回复输入框并输入文字

9. 关注用户

在个人资料页上，查找 button "Follow" 的 ref：

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

关键要点

1. 先执行快照（snapshot） —— 任何操作前务必检查当前页面状态
2. ref 每次都会变化 —— 务必从最新快照中重新获取 ref
3. 使用 compact=true —— 节省 token 消耗
4. 推文结构为 article 元素 —— 每条推文均以 article 元素封装，内部包含作者、内容及各类按钮
5. 发布前务必确认 —— 需获得用户对发布内容的明确确认

故障排查

与 bird CLI 对比