如何使用自訂 Agent Harness 搭配 ego (lite)

透過自訂 Agent Harness 控制 ego (lite)：判斷命令執行環境，只在需要時開放本機執行權限，載入 ego-browser，並完成瀏覽器任務。

素材說明： 本指南使用 OpenClaw 的錄製素材，展示一種 Agent Harness 連接流程。不同 Harness 採用的選單、命令和權限名稱可能不同。

只要自訂 Agent Harness 能在安裝了 ego (lite) 的電腦上執行 ego-browser，就可以控制 ego (lite)。請先確認使用的是桌面版還是終端界面（TUI），以便找到對應的設定入口。然後確認 Harness 會在哪裡執行命令，這個判斷才決定是否需要開放本機執行權限。

上方影片僅展示一種桌面版工作流程，並不代表所有 Harness 都使用相同的界面。

開始前

請先安裝 ego (lite)、完成初始設定，並確認 Harness 能夠執行 Shell 命令。

下載並開啟 DMG 安裝檔
按照指示，按兩下 ego (lite) 的 icon 進行安裝
啟動 ego (lite)，完成初始設定
1. 透過桌面版或 TUI 開啟 Harness
1. 確認 Harness 能在安裝了 ego (lite) 的這台電腦上執行命令

ego (lite) 會將共用的 ego-browser Skill 安裝到 ~/.agents/skills/。如果 Harness 支援 Agent Skills，請將它設定為掃描該目錄，或依照 Harness 官方文件提供的方式匯入 Skill。

安裝 ego (lite) 後，請完全退出並重新啟動 Agent 應用程式，再繼續下面的操作。這樣應用程式才能重新載入新安裝的 ego-browser Skill，並在支援 Skill 斜線命令的應用程式中顯示對應命令。僅關閉目前工作階段或視窗可能無法重新載入 Skill。

桌面版和終端界面決定設定入口

桌面版可能直接在本機執行命令，也可能將命令限制在沙箱中；終端界面同樣可能採用其中任何一種方式。請先依據界面類型找到設定入口，再檢查命令執行環境。是否需要 Bypass permissions，取決於 Agent 能否在安裝了 ego (lite) 的電腦上直接執行命令。

使用 桌面版 時，可以在工作階段、工作區、Agent、Tool 或安全設定中尋找權限選項。
使用 TUI 時，可以檢查啟動參數、設定檔、環境變數或工作階段狀態列。

下一步將協助判斷 Harness 應該使用哪條權限路徑。

第 1 步：確認 Harness 在哪裡執行命令

先讓 Agent 在之後執行瀏覽器任務的同一個工作階段中執行：

command -v ego-browser

這條命令只能確認目前工作階段能否找到 ego-browser，不能單獨證明命令在本機執行。還需要結合 Harness 的工作階段資訊或官方文件判斷執行環境，並在第 4 步透過真實連接測試確認。

根據執行環境選擇下一步：

命令直接在本機執行，而且沒有沙箱： ego-browser 可以啟動本機安裝的 ego (lite)。這類 Harness 可能根本沒有 Bypass permissions，也不需要額外開啟，請直接進入第 3 步。
Agent 在本機沙箱中執行： Harness 必須提供官方的本機執行、非沙箱模式或主機橋接能力，讓 Agent 能將 ego-browser 交給這台電腦執行。請繼續完成第 2 步。
Agent 在容器、虛擬機器、遠端伺服器或雲端環境中執行： Harness 必須提供能夠在這台電腦上執行 ego-browser 的主機橋接能力。沒有這條橋接時，僅在遠端環境中安裝或載入 Skill，並不能控制本機的 ego (lite)。

如果 command -v ego-browser 沒有回傳路徑，請先確認 ego (lite) 已完成初始設定，再檢查 Harness 使用的 PATH 或命令執行環境是否與一般終端不同。

第 2 步：確保 Agent 已跳出沙箱

開始設定前，請確認 Agent 已獲得沙箱外的本機執行權限，能夠在安裝了 ego (lite) 的這台電腦上執行 ego-browser。如果 Agent 原本就在本機直接執行且沒有沙箱，則無需額外開啟這項權限。

如果 Harness 要求在每條命令執行前進行確認，可以手動批准，也可以在信任的工作階段中開啟免批准模式。免批准只會減少確認提示，並不是連接 ego (lite) 的必要條件。

桌面版範例：批准策略

這段素材展示的是 OpenClaw 的 Exec Approvals 設定，僅用於說明桌面版 Harness 如何管理命令批准。關閉批准提示並不能證明 Agent 已獲得本機執行能力。如果目前 Harness 使用沙箱，請先依照該產品的官方文件開啟本機執行或主機橋接，再依需求調整命令批准策略。

TUI 範例：免批准模式

這段素材展示的是 OpenClaw 在開啟 TUI 前套用免批准預設。它只改變 OpenClaw 的命令批准策略，並不代表其他 Harness 已獲得沙箱外的本機執行權限。除非目前 Harness 的官方文件明確支援這條 OpenClaw 命令，否則不要直接照搬。請分別查詢該 Harness 官方提供的本機執行方式和批准設定。

本機執行權限會擴大 Agent 對電腦系統的存取範圍，免批准模式則會移除每條命令執行前的確認步驟，兩者帶來的風險不同。請只在信任的 Harness、工作區和任務中開啟這些權限。如果 Harness 支援主機命令白名單或更小的權限範圍，應優先只允許目前流程所需的命令。

第 3 步：載入 ego-browser Skill

桌面版範例

素材中使用的是 OpenClaw 的 Skill 選擇器。在桌面版 Harness 中，請進入能夠執行本機 Shell 命令的 Agent 工作階段，再從 Skill 或 Tool 界面載入 ego-browser。畫面中出現的具體命令只適用於 OpenClaw。

TUI 範例

如果 TUI 支援 Skill 的斜線命令，可以輸入 /ego-browser，在名稱後保留一個空格，再繼續輸入任務。如果 TUI 不支援斜線命令，請直接讓 Agent 在開始前查詢並讀取 ego-browser Skill。選單中沒有 /ego-browser，並不代表這個 Skill 無法使用。

第一次可以先送出下面這段相容性檢查指令：

先判斷目前命令執行環境是在這台電腦本機，還是在沙箱、容器或遠端環境中。如果使用沙箱，請確認是否具有讓命令在這台電腦本機執行的官方權限或橋接能力。不要把關閉批准提示當成本機執行能力。

然後查詢並閱讀 ego-browser Skill，首先檢查 ~/.agents/skills/ego-browser/SKILL.md。如果無法在這台電腦上執行 ego-browser，請停止任務，並說明缺少哪一種本機執行權限或橋接能力。

第 4 步：執行簡單的連接測試

正式造訪需要登入的網站之前，先用一個簡單的公開頁面測試連接：

使用 ego-browser Skill，在 ego (lite) 中開啟 https://example.com，回傳頁面標題，並保持頁面開啟。

如果 ego (lite) 開啟了 Agent Space、頁面正常載入，並且 Harness 回傳了頁面標題，就表示本機執行鏈路已連通。如果手動批准後頁面能夠開啟，說明剩下的只是命令批准策略。可以繼續逐條批准，也可以在信任的工作階段中使用該 Harness 官方提供的免批准設定。

如果命令始終沒有到達這台電腦，請返回第 1 步和第 2 步，檢查本機執行權限或橋接能力。

第 5 步：讓 Agent 執行瀏覽器任務

簡單測試通過後，就可以向 Harness 送出真實的瀏覽器任務。這裡使用 OpenClaw 作為控制端範例，但 ego (lite) 中的流程相同：Agent 載入 Skill、開啟 Agent Space、造訪目標頁面並收集所需資訊。

可以使用其他指南中的同一個範例任務：

使用 ego-browser Skill，開啟 Anthropic 的官方 X 個人檔案，並收集 Posts 資訊流中顯示的前五則貼文。

即使 Harness 不支援 Skill 斜線命令，只要 Agent 能找到 Skill，並能在本機執行 ego-browser，直接使用這段自然語言指令也可以開始任務。

第 6 步：檢查任務結果

任務結束後，請確認 Harness 已回傳所需資訊，並且原始頁面仍保留在 ego (lite) 中。素材展示的是 OpenClaw 中的結果，實際使用的 Harness 可能採用不同的結果界面。

如果網站要求登入、完成 CAPTCHA 或驗證帳號，請在 ego (lite) 的 Agent Space 中接管並手動處理。請勿將密碼或驗證碼放入 Agent 提示。

常見問題

我的 Harness 沒有 Bypass permissions

這可能是正常情況。如果命令原本就在本機執行，而且沒有沙箱，就不存在需要繞過的沙箱權限。先確認 Agent 工作階段中的 command -v ego-browser 能夠回傳路徑，再透過第 4 步的連接測試進行驗證。如果 Harness 只要求逐條批准，可以手動批准，不必為了使用 ego (lite) 強行尋找 Bypass permissions。

找不到 `/ego-browser`

斜線命令是 Harness 提供的界面功能，並不是使用 ego (lite) 的必要條件。可以讓 Agent 讀取 ~/.agents/skills/ego-browser/SKILL.md，或依照 Harness 支援的 Skill 匯入方式，將它設定為掃描 ~/.agents/skills/。

終端提示找不到 `ego-browser`

請先完成 ego (lite) 初始設定，重新啟動 Harness，再從同一個 Agent 工作階段執行 command -v ego-browser。如果一般終端可以找到命令，但 Harness 無法找到，請比較兩者的 PATH 和命令執行環境。

Agent 一直要求確認權限

這只說明 Harness 仍在使用目前批准策略，不等於 Agent 仍被困在沙箱中。如果手動批准後 ego (lite) 能夠開啟，可以繼續逐條批准，或在信任的工作階段中使用該產品官方提供的免批准設定。如果手動批准後命令仍無法到達本機，請檢查本機執行權限或主機橋接。不要直接照搬其他產品的命令或參數。

Harness 在 Docker、SSH 或雲端執行

除非 Harness 提供本機執行橋接，否則遠端執行環境無法控制本機安裝的 ego (lite)。可以改為在本機執行 Harness、設定官方支援的橋接能力，或在 Agent 實際執行的電腦上安裝並執行相容的瀏覽器環境。

Skill 已載入，但 ego (lite) 沒有啟動

請確認 Agent 是在安裝了 ego (lite) 的電腦上執行 ego-browser。載入 Skill 只是向 Agent 提供操作說明，並不會自動把命令從沙箱或遠端環境轉移到本機。

開始前