나만의 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가 셸 명령을 실행할 수 있는지 확인하세요.

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 피드에 표시되는 첫 다섯 개의 게시물을 수집하세요.

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을 불러오는 것은 에이전트에게 지시를 주는 것이지, 샌드박스나 원격 머신에서 컴퓨터로 명령 실행을 옮기는 것이 아닙니다.