ClawMe — 在用户的真实浏览器中执行操作

通过 ClawMe 浏览器扩展，向用户 Chrome 浏览器发送指令。每条指令均显示在侧边栏中，用户需点击“执行”按钮进行确认。与无头浏览器不同，ClawMe 运行于用户真实的浏览器环境中，并复用其当前已登录的会话。

设置：用户需安装 ClawMe Chrome 扩展，并配置 Backend URL 和 Token。

如何发送指令

如有可用，可使用 clawme_send 工具；否则，请发起 HTTP POST 请求：

POST ${CLAWME_BASE_URL:-https://api.clawme.net}/v1/instructions
Headers: Content-Type: application/json, X-ClawMe-Token: ${CLAWME_CLIENT_TOKEN}
Body: {"target":"browser","instruction":{"type":"","payload":{...}}}

指令类型

compose_tweet

当用户说“发一条关于……的推文”、“在 X 上发布……”时使用。

{"type":"compose_tweet","payload":{"text":"tweet content"}}

compose_email

当用户说“给……写一封邮件”、“发送一封邮件……”时使用。

{"type":"compose_email","payload":{"to":"email@example.com","subject":"Subject","body":"Body text","use_gmail":true}}

fill_form

当用户说“填写表单……”、“输入我的信息……”时使用。

{"type":"fill_form","payload":{"url":"https://example.com/form","fields":{"#name":"John","input[name=email]":"john@example.com","select[name=country]":"US"}}

支持的表单元素包括：input、textarea、select、checkbox、radio 及 contenteditable（如小红书、Medium）。字段键请使用 CSS 选择器。若省略 url 字段，则默认作用于当前页面。

click

当用户说“点击按钮……”、“提交表单……”时使用。

{"type":"click","payload":{"selector":"button[type=submit]","url":"https://example.com/form"}}

extract

当用户说“获取……中的文本”、“抓取……”时使用。

{"type":"extract","payload":{"selector":".results","url":"https://example.com/search"}}

提取结果（即文本内容）将回传至 agent。

open_url

{"type":"open_url","payload":{"url":"https://example.com","in_new_tab":true}}

remind

{"type":"remind","payload":{"title":"Meeting","body":"Team standup in 5 minutes"}}

多步骤工作流

通过 meta.workflow_id 和 meta.step 字段串联多个指令：

POST /v1/instructions — {"target":"browser","instruction":{"type":"open_url","payload":{"url":"..."}}, "meta":{"workflow_id":"signup","step":1}}
POST /v1/instructions — {"target":"browser","instruction":{"type":"fill_form","payload":{"fields":{...}}}, "meta":{"workflow_id":"signup","step":2}}
POST /v1/instructions — {"target":"browser","instruction":{"type":"click","payload":{"selector":"button[type=submit]"}}, "meta":{"workflow_id":"signup","step":3}}

用户将看到一个带进度条的工作流卡片，并可按顺序依次执行所有步骤。

环境变量

• CLAWME_CLIENT_TOKEN（必需）——需与 Chrome 扩展中配置的 Token 保持一致
• CLAWME_BASE_URL（可选）——默认为 https://api.clawme.net；本地调试时可设为 http://127.0.0.1:31871