快速开始

Chrome 与 Firefox 可以并行使用，且各自独立配对。

系统需求复制锚点链接

• Chrome 156 或更新版本，或 Firefox 153 或更新版本。
• macOS 或 Linux，且与浏览器在同一台电脑上。
• 解开发布版本封存盘需要 zstd。
• 从源代码构建需要 Go 1.27.3、Node 24 与 pnpm 11。

安装 daemon复制锚点链接

zstd -dc omw-<version>-darwin-arm64.tar.zst | tar -xf - -C "$HOME/.local"

安装扩展程序复制锚点链接

设置浏览器复制锚点链接

安装扩展程序后，会打开初始设置页面。浏览器尚未配对、daemon 未运行，或 daemon 拒绝连接时，可在弹出式窗口中按打开初始设置重新打开该页面。

Firefox 在最后一步之前多一个步骤：允许脚本，其按钮使用相同的文字。evaluate 动作需要选用的用户脚本权限；你可以在该步骤授予，也可以之后到设置，再到网页授予。

扩展程序的页面、弹出式窗口与工具栏提示使用浏览器的语言。若要改用其他语言，请在初始设置页或设置页侧栏底部打开语言菜单。扩展程序提供英文、繁体中文（台湾、香港与澳门）与简体中文。

登录时启动复制锚点链接

先把可执行文件移到你打算长期使用的路径，再运行：

omw service install

在 macOS 上，这个命令会写入 ~/Library/LaunchAgents/app.oh-my-webbridge.plist，并以 launchctl 加载。在 Linux 上，它会写入 ~/.config/systemd/user/oh-my-webbridge.service，并以 systemctl --user 激活该 unit。这个 unit 会以安装命令所用的配置目录运行 omw serve。安装服务之前，请先停止由 omw start 启动的 daemon，因为服务会自行启动另一个 daemon。请通过服务管理员停止服务：

launchctl bootout gui/$(id -u)/app.oh-my-webbridge

systemctl --user disable --now oh-my-webbridge.service

omw stop 会要求运行中的 daemon 结束，并保留已打开的标签页。已安装服务时，请使用服务管理员，以免 daemon 再次启动。

安装 Agent 技能复制锚点链接

omw install-skill DIR 会写入 DIR/oh-my-webbridge/SKILL.md，并复制内置于可执行文件的指南。它拒绝覆写既有文件，所以重新安装前请先删除旧文件。omw skill 会输出同一份指南。这份指南告诉 Agent 要运行哪些命令、会话与标签页拥有权如何运行，以及可能遇到哪些错误。

第一批命令复制锚点链接

omw call research navigate '{"url":"https://example.com","group_title":"Research"}'
omw call research snapshot
omw call research evaluate '{"code":"document.title"}'
omw call research close_session

omw call 后的第一个参数是会话名称；每项任务使用一个名称。每个命令都会在 stdout 输出 JSON。

• navigate 会在标题为 Research 的新分组中打开背景标签页，并返回标签页 id。同一个会话之后的导航会重用该标签页；传入 newTab 则打开另一个标签页。
• snapshot 会返回无障碍树，其中的 @e 引用可供 click 与 fill 使用。
• evaluate 会返回表达式的值。
• close_session 会关闭该会话拥有的标签页，并释放任何借用的标签页。

第三个参数是 JSON 对象。传入 - 可从 stdin 读取，避免 shell 引号问题：

omw call research evaluate - < request.json

两个浏览器都已连接时，请在 omw call 后立即指定其中一个：

omw call --browser firefox research snapshot

检查连接复制锚点链接

omw doctor 会在 stderr 输出配置文件路径，在 stdout 输出状态 JSON，然后在 stderr 为每个浏览器输出一行：

chrome: connected (VERSION)
firefox: not connected

omw status 会输出相同的状态 JSON 与浏览器行，但不印配置文件路径。daemon 没有响应时，两者都以非零状态码结束。