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。