独自の Agent Harness で ego (lite) を使う方法

独自の Agent Harness を ego (lite) に接続します。コマンドがどこで実行されるかを確認し、必要な場合のみホスト実行を許可し、ego-browser を読み込んでブラウザタスクを完了します。

素材について： このガイドでは OpenClaw の録画を使用して、1 つの Agent Harness 接続フローを紹介します。お使いの Harness ではメニュー、コマンド、権限名が異なる場合があります。

独自の Agent Harness は、ego (lite) がインストールされたコンピュータ上で ego-browser を実行できる限り、ego (lite) を操作できます。まずデスクトップ画面か TUI かを確認して、設定をどこで探すかを把握します。次に、Harness がどこでコマンドを実行するかを確認します。この 2 つ目の問いが、ホスト実行アクセスが必要かどうかを決定します。

動画は 1 つの可能なデスクトップワークフローとして扱ってください。普遍的な Harness 画面ではありません。

始める前に

ego (lite) をインストールし、初期設定を完了し、Harness がシェルコマンドを実行できることを確認してください。

DMG ファイルをダウンロードして開きます
画面の指示に従い、ego (lite) のアイコンをダブルクリックしてインストールします
ego (lite) を開いて初期設定を完了します
1. Harness をデスクトップ画面または TUI で開きます
1. Harness が ego (lite) のインストールされたコンピュータ上でコマンドを実行できることを確認します

ego (lite) は共有の ego-browser Skill を ~/.agents/skills/ にインストールします。Harness が Agent Skills をサポートしている場合は、そのディレクトリをスキャンするように設定するか、Harness が文書化した方法で Skill をインポートします。

ego (lite) をインストールしたら、続ける前に Agent アプリを完全に終了して再起動してください。こうすることでアプリが新しくインストールされた ego-browser Skill を再読み込みし、Skill スラッシュコマンドをサポートするアプリでは対応するコマンドを表示できます。現在のセッションやウィンドウを閉じるだけでは Skill が再読み込みされない場合があります。

デスクトップと TUI が設定の場所を決める

デスクトップアプリは、あなたのコンピュータ上で直接コマンドを実行することも、サンドボックス内で実行することもできます。TUI もどちらかになり得ます。画面の種類を使って関連する設定を見つけ、コマンドの実行環境を確認します。Bypass permissions が必要かどうかは、エージェントが ego (lite) のインストールされたコンピュータ上でコマンドを実行できるかどうかに依存します。

デスクトップ画面では、セッション、ワークスペース、Agent、Tool、またはセキュリティ設定で権限を探します。
TUIでは、起動フラグ、設定ファイル、環境変数、またはセッションのステータス行を確認します。

次のステップで、どの権限経路が Harness に当てはまるかが決まります。

ステップ 1：Harness がどこでコマンドを実行するか確認する

まず、ブラウザタスクを実行するのと同じセッションから、このコマンドをエージェントに実行させます:

command -v ego-browser

このコマンドは現在のセッションが ego-browser を見つけられるかどうかを確認するだけです。コマンドがホストコンピュータ上で実行されることを証明するものではありません。Harness のセッション情報または公式ドキュメントを使用して実行環境を特定し、ステップ 4 の実際の接続テストで確認します。

実行環境に応じて次のステップを選択します:

コマンドがサンドボックスなしでこのコンピュータ上で直接実行される: ego-browser はローカルにインストールされた ego (lite) を起動できます。Bypass permissions 設定がない場合があり、作成する必要もありません。ステップ 3 に進みます。
エージェントがローカルのサンドボックス内で実行される: Harness は、エージェントが ego-browser をこのコンピュータに渡せるようにする公式のホスト実行、非サンドボックス、またはホストブリッジ機能を提供する必要があります。ステップ 2 に進みます。
エージェントがコンテナ、仮想マシン、リモートサーバー、またはクラウド環境で実行される: Harness には、このコンピュータ上で ego-browser を実行できるホストブリッジが必要です。そのブリッジがなければ、リモート環境内で Skill をインストールまたは読み込むだけでは、ローカルの ego (lite) アプリを制御できません。

command -v ego-browser がパスを返さない場合は、まず ego (lite) の初期設定が完了していることを確認します。その後、Harness が通常のターミナルとは異なる PATH または実行環境を使用しているかどうかを確認します。

ステップ 2：エージェントがサンドボックスの外で実行できることを確認する

続ける前に、エージェントがサンドボックスの外で実行し、ego (lite) のインストールされたコンピュータ上で ego-browser を実行できることを確認します。エージェントがすでにサンドボックスなしでこのコンピュータ上で直接実行されている場合は、追加の権限は不要です。

Harness が各コマンドの前に確認を求める場合は、コマンドを手動で承認するか、信頼するセッションで承認なしモードを有効にできます。承認なしモードは確認プロンプトを減らすだけで、ego (lite) に接続するために必須ではありません。

デスクトップの例：承認ポリシー

この録画は OpenClaw の Exec Approvals 設定を示しています。デスクトップ Harness がコマンド承認をどのように管理できるかを示すだけです。承認プロンプトをオフにしても、エージェントがホスト実行アクセスを持っていることは証明されません。Harness がサンドボックスを使用している場合は、まず公式ドキュメントに従ってホスト実行またはホストブリッジを有効にし、必要に応じて承認ポリシーを調整します。

TUI の例：承認なしモード

この録画は、OpenClaw が TUI を開く前に独自の承認なしプリセットを適用する様子を示しています。これは OpenClaw の承認ポリシーを変更するものであり、他の Harness がサンドボックスを抜けられるようになることを意味するものではありません。そのドキュメントがサポートしていない限り、OpenClaw のコマンドを他の Harness にコピーしないでください。お使いの Harness が提供する公式のホスト実行方法と承認設定を別々に探してください。

ホスト実行は、エージェントがコンピュータ上でアクセスできる範囲を広げます。承認なしモードは各コマンドの前の確認ステップをなくします。これらの制御は異なるリスクを伴います。信頼する Harness、ワークスペース、タスクでのみ有効にしてください。Harness がホストコマンドの許可リストまたはより狭いポリシーをサポートしている場合は、このワークフローに必要なコマンドのみにアクセスを許可することを優先してください。

ステップ 3：ego-browser Skill を読み込む

デスクトップの例

録画では OpenClaw の Skill ピッカーを使用して ego-browser を読み込んでいます。独自のデスクトップ Harness では、シェル対応のローカルエージェントセッションを開き、Skill または Tool 画面から ego-browser を読み込みます。OpenClaw に表示される正確なコマンドは製品固有です。

TUI の例

TUI が Skill スラッシュコマンドをサポートしている場合は、/ego-browser と入力し、スペースを追加して、同じメッセージ内でタスクを続けます。スラッシュコマンドを提供しない場合は、開始前にエージェントに 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：エージェントにブラウザタスクを実行させる

接続テストが機能したら、Harness に実際のブラウザタスクを渡します。録画では OpenClaw を例のコントローラーとして使用していますが、可視の ego (lite) ワークフローは同じです。エージェントは Skill を読み込み、Agent Space を開き、対象ページを訪れ、要求された情報を収集します。

これらのガイド全体で使用されているのと同じタスクを試してください:

ego-browser Skill を使用して、Anthropic の公式 X プロフィールを開き、Posts フィードに表示される最初の 5 件の投稿を収集してください。

Harness が Skill スラッシュコマンドをサポートしていない場合でも、エージェントが Skill を見つけてホストコンピュータ上で ego-browser を実行できる限り、この自然言語の指示で十分です。

ステップ 6：完了した結果を確認する

タスクが終わったら、Harness が要求された情報を返し、ソースページが ego (lite) に開いたままであることを確認します。録画は OpenClaw での結果を示しています。独自の Harness では回答の表示が異なる場合があります。

ウェブサイトがログイン、CAPTCHA、またはアカウント確認を求める場合は、ego (lite) の Agent Space で引き継いで自分で完了してください。パスワードや確認コードを Agent プロンプトに入れないでください。

トラブルシューティング

Harness に Bypass permissions がない

それは正常な場合があります。コマンドがすでにサンドボックスなしでこのコンピュータ上で直接実行されている場合、バイパスすべきサンドボックス権限はありません。エージェントセッションから command -v ego-browser がパスを返すことを確認し、ステップ 4 で接続を検証します。Harness がコマンドごとの承認のみを求める場合は、Bypass permissions 設定を探す代わりに、各コマンドを手動で承認できます。

`/ego-browser` が表示されない

スラッシュコマンドは Harness の画面機能であり、ego (lite) の要件ではありません。エージェントに ~/.agents/skills/ego-browser/SKILL.md を読むよう依頼するか、Harness がサポートする Skill インポート方法を使用して ~/.agents/skills/ をスキャンするよう設定します。

`ego-browser` が見つからない

ego (lite) の初期設定を完了し、Harness を再起動し、同じエージェントセッションから再度 command -v ego-browser を実行します。通常のターミナルではコマンドが機能するのに Harness では機能しない場合は、それらの PATH と実行環境を比較してください。

エージェントが承認を求め続ける

これは Harness がまだ承認ポリシーを適用していることを意味するだけで、エージェントがサンドボックスに閉じ込められていることを証明するものではありません。手動承認後に ego (lite) が開く場合は、コマンドの承認を続けるか、信頼するセッションで製品が文書化した承認なし設定を使用してください。承認後もコマンドがホストに到達しない場合は、ホスト実行権限またはブリッジを確認してください。他の製品のコマンドやフラグをコピーしないでください。

Harness が Docker、SSH、またはクラウドで実行される

Harness がホスト実行ブリッジを提供しない限り、リモート実行環境はローカルの ego (lite) インストールを制御できません。Harness をローカルで実行するか、サポートされているブリッジを設定するか、エージェント実行環境と同じマシンに互換性のあるブラウザ環境をインストールして実行してください。

Skill は読み込まれたが ego (lite) が開かない

エージェントが ego (lite) のインストールされたコンピュータ上で ego-browser を実行していることを確認します。Skill を読み込むことはエージェントに指示を与えることであり、サンドボックスやリモートマシンからあなたのコンピュータへコマンド実行を移動させるものではありません。