Agent Browser 完整命令手册

创建时间：2026-03-15
适用对象：大德米（本地Mac环境）
版本：v1.0

快速参考卡

核心工作流

# 1. 打开页面
agent-browser open <URL>

# 2. 获取页面元素
agent-browser snapshot -i

# 3. 交互操作（使用@ref）
agent-browser click @e1
agent-browser fill @e2 "文本"

# 4. 关闭浏览器
agent-browser close

完整命令列表

导航命令

页面分析

点击操作

输入操作

复选框/单选框

等待命令

滚动操作

获取信息

检查状态

截图和PDF

视频录制

Cookie和存储

状态管理（关键！）

会话管理

浏览器设置

调试命令

平台特定操作指南

知乎

# 保存登录状态（首次）
agent-browser open https://www.zhihu.com/signin
# 手动登录后...
agent-browser state save zhihu_auth.json

# 后续自动登录
agent-browser state load zhihu_auth.json
agent-browser open https://www.zhihu.com

# 发布文章
agent-browser click @write_article  # 或找到写文章按钮的ref
agent-browser fill @title_input "文章标题"
agent-browser fill @content_editor "文章内容..."
agent-browser click @publish_button
agent-browser wait --text "发布成功"

小红书

# 加载登录状态
agent-browser state load xiaohongshu_auth.json
agent-browser open https://www.xiaohongshu.com

# 发布图文
agent-browser click @publish_button
agent-browser upload @image_upload ./cover.jpg
agent-browser fill @title_input "标题"
agent-browser fill @content_editor "正文内容"
agent-browser click @publish_now

Twitter/X

agent-browser state load twitter_auth.json
agent-browser open https://twitter.com

# 发推文
agent-browser click @compose_tweet
agent-browser fill @tweet_text "推文内容"
agent-browser click @tweet_button

YouTube

agent-browser state load youtube_auth.json
agent-browser open https://studio.youtube.com

# 上传视频
agent-browser click @upload_button
agent-browser upload @file_input ./video.mp4
agent-browser fill @title "视频标题"
agent-browser fill @description "视频描述..."
agent-browser fill @tags "tag1, tag2, tag3"
agent-browser click @publish_button

实用脚本模板

模板1：自动发布文章

#!/bin/bash
# publish_article.sh

PLATFORM=$1      # zhihu, xiaohongshu, etc.
TITLE=$2
CONTENT=$3
AUTH_FILE="${PLATFORM}_auth.json"

# 加载认证
agent-browser state load $AUTH_FILE

# 打开平台
case $PLATFORM in
    "zhihu")
        agent-browser open https://zhuanlan.zhihu.com/write
        agent-browser fill @title_input "$TITLE"
        agent-browser fill @content_editor "$CONTENT"
        agent-browser click @publish_button
        ;;
    "xiaohongshu")
        agent-browser open https://www.xiaohongshu.com/explore
        agent-browser click @publish
        agent-browser fill @title "$TITLE"
        agent-browser fill @content "$CONTENT"
        agent-browser click @publish_now
        ;;
esac

# 等待发布完成
agent-browser wait --text "发布成功" --timeout 10000
echo "发布完成！"

模板2：批量获取数据

#!/bin/bash
# scrape_data.sh

URL=$1
SELECTOR=$2

agent-browser open $URL

# 获取所有匹配元素
COUNT=$(agent-browser get count "$SELECTOR")
echo "找到 $COUNT 个元素"

# 遍历获取文本
for i in $(seq 1 $COUNT); do
    TEXT=$(agent-browser get text "${SELECTOR}:nth-of-type($i)")
    echo "$i: $TEXT"
done

模板3：定时检查任务

#!/bin/bash
# check_notifications.sh

agent-browser state load zhihu_auth.json
agent-browser open https://www.zhihu.com/notifications

# 获取通知数量
NOTIF_COUNT=$(agent-browser get text @notification_count)

if [ "$NOTIF_COUNT" != "0" ]; then
    echo "您有 $NOTIF_COUNT 条新通知"
    # 发送提醒（可以调用API）
else
    echo "没有新通知"
fi

故障排查

元素找不到

# 1. 重新获取snapshot
agent-browser snapshot -i

# 2. 使用CSS选择器
agent-browser find ".button.primary" click

# 3. 使用文本查找
agent-browser find text "发布" click

# 4. 等待元素加载
agent-browser wait @e10 --timeout 5000

登录状态失效

# 1. 检查当前状态
agent-browser get url

# 2. 如果跳转到登录页，重新登录
agent-browser open https://www.zhihu.com/signin
# ... 手动登录 ...
agent-browser state save zhihu_auth.json

页面加载慢

# 增加超时时间
agent-browser open https://example.com --timeout 30000

# 等待网络空闲
agent-browser wait --load networkidle

# 等待特定元素
agent-browser wait @main_content --timeout 20000

最佳实践

1. 始终保存登录状态

   agent-browser state save platform_auth.json
   

2. 使用--headed调试

   agent-browser open URL --headed
   

3. 添加错误处理

   agent-browser click @button || echo "点击失败"
   

4. 定期更新snapshot

   • 页面导航后重新snapshot
   • 动态加载内容后重新snapshot

5. 使用JSON输出解析

   agent-browser snapshot -i --json | jq '.elements[] | select(.type == "button")'
   

参考

• 完整文档: /root/.openclaw/workspace/skills/agent-browser/SKILL.md
• GitHub: https://github.com/vercel-labs/agent-browser
• CLI-Anything配合: 见 CLI-Anything详细运用指南.md

创建者：德米
最后更新：2026-03-15