CLI

omw 是 Go daemon，也是它的命令行客户端。它监听 127.0.0.1:17373，没有选项可以绑定其他地址或网络界面。serve 与 start 运行 daemon。stop、status、doctor、pair 与 call 需要已在运行中的 daemon。connection、skill、install-skill、service install、version 与 help 不需要 daemon。

每个命令成功时以状态码 0 结束。失败时，命令把 omw: 与错误消息印到 stderr，然后以状态码 1 结束。

serve复制锚点链接

omw serve [--cdp ws://127.0.0.1:9222/devtools/browser/...]

在前景运行 daemon，直到收到 SIGINT 或 SIGTERM。监听地址固定为 127.0.0.1:17373。如果 config.json 指定了其他地址，daemon 会拒绝启动。

--cdp 让 daemon 指向一个已激活远程调试的 Chrome 浏览器端点。URL 必须以 ws:// 或 wss:// 开头，并带有主机。使用这个旗标时，/devtools/browser 会代理该端点；请见 CDP。

端点不会写入 config.json。该文件中已有的 cdp 字段会在启动时读取，旗标会在该进程中取代它。

start复制锚点链接

omw start

在新的会话中启动 omw serve，与终端分离，并把 OMW_HOME 设为配置目录。输出写入该目录中的 daemon.log。每次启动都会清空该文件。命令会等待约两秒，让 daemon 响应 /status。

成功时输出 started；daemon 已在连接端口上响应时，输出 already running。当其他进程占用连接端口，或 token 不符时，命令回报连接端口或凭证不符，并以状态码 1 结束。新的 daemon 在这段时间内没有响应时，命令会输出 daemon.log 的内容。

stop复制锚点链接

omw stop

发送 POST /shutdown，并输出回复 {"stopping":true}。会话打开的标签页会保持打开。bindings.json 中的绑定会保留。

status 与 doctor复制锚点链接

omw status
omw doctor

两者都把 daemon 的 /status JSON 印到 stdout，并把每个浏览器一行的状态印到 stderr：

chrome: connected (156.0.8078.80)
firefox: not connected

doctor 会在这些行之前，先把 config.json 的路径印到 stderr。

status 是需要验证的请求。没有运行中的 daemon 时，它以状态码 1 结束，并输出连接错误。

pair复制锚点链接

omw pair

向 daemon 要求配对码，并以两组各三位数的格式输出：

Enter this code in the oh-my-webbridge extension:

    482 913

It works once and expires in 5 minutes.

配对码的有效期为 5 分钟，可尝试 5 次。命令每 500 ms 轮询一次 daemon，在扩展程序兑换配对码时，输出 Paired with Chrome. 或 Paired with Firefox.。配对码过期时，命令以状态码 1 结束。没有运行中的 daemon 时，它会输出提示，要求运行 omw start。

connection复制锚点链接

omw connection

输出一个 JSON 对象：

{
  "endpoint": "ws://127.0.0.1:17373/extension",
  "token": "64 hex characters",
  "protocol": 1
}

token 是以十六进制表示的 32 个随机字节，与 config.json 保存的值相同。它授权除了 GET /ping 与 POST /pair 之外的每个请求，包括 WebSocket 升级与 CDP 连接。请把它当作机密：不要贴到 issue、日志或网页中。

call复制锚点链接

omw call [--browser chrome|firefox] [--timeout-ms N] SESSION ACTION [JSON|-]

对 daemon 发送一个动作，并输出它的 JSON 回复。会话名称由 1 到 96 个字符组成，可用字母（包括 CJK）、数字、_、. 或 -。ACTION 是动作参考中的其中一个动作。

选用的第三个参数是含有动作参数的 JSON 对象。使用 - 时，命令从 stdin 读取该对象，上限 2 MiB。省略时，daemon 收到 {}。

omw call research navigate '{"url":"https://example.com/"}'
echo '{"selector":"#submit"}' | omw call --browser firefox form click -

--browser 把动作送往指定的浏览器。省略时，daemon 依序依据会话绑定、唯一已连接的浏览器、Chrome 来路由。

--timeout-ms 设置命令的期限，范围 1 到 120000 毫秒，与请求本文中的 timeoutMs 相同。省略时期限为 30 秒。

omw call --timeout-ms 5000 research wait '{"selector":"#done"}'

旗标放在会话名称之前。会话名称以 - 开头时，在它前面加上 --。

客户端最多等待 125 秒。回复照 daemon 发送的内容输出。HTTP 状态码为 400 或以上时，命令在输出回复后以状态码 1 结束。

service install复制锚点链接

omw service install

安装用户服务，在登录时运行 omw serve，并把 OMW_HOME 设为命令所用的配置目录。

服务让 daemon 持续运行：macOS 使用 KeepAlive，Linux 使用 Restart=on-failure，延迟 3 秒。macOS 会舍弃输出；systemd 单元保留默认的 journal。

install-skill 与 skill复制锚点链接

omw install-skill DIRECTORY
omw skill

install-skill 把内附的 Agent 指南以 0600 权限写入 DIRECTORY/oh-my-webbridge/SKILL.md，并以 0700 权限创建目录。它拒绝覆写既有文件。

skill 把同一份指南印到 stdout。

omw install-skill ~/.agents/skills

version 与 help复制锚点链接

omw version
omw --version
omw help

version 输出 daemon 版本。help、--help 与单独的 omw 输出命令清单。

未知的命令会输出 omw: unknown command "NAME"; run omw help，并以状态码 1 结束。

配置目录复制锚点链接

目录依下列顺序决定：

1. OMW_HOME（有设置时）。
2. macOS：~/Library/Application Support/oh-my-webbridge。
3. Linux：$XDG_CONFIG_HOME/oh-my-webbridge；XDG_CONFIG_HOME 未设置时为 ~/.config/oh-my-webbridge。

CLI、daemon、用户服务与 SDK 都读取同一个目录。每个读取配置的命令，在目录不存在时都会以 0700 权限创建它。

config.json 中的 token 是唯一的凭证。任何人读到这个文件，就能操控已配对的浏览器，因此请让这个目录保持私有，也不要在机器之间复制 config.json。