快速開始

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 沒有回應時，兩者都以非零狀態碼結束。