Agent 화면을 공유하기 전에 정할 접근 규칙

Agent의 화면을 회의에 공유하려는 운영 담당자를 위한 글입니다. 화면을 열기 전에 열람 대상, 비밀번호 담당자, 공유 범위를 정하는 기준을 설명합니다. 대상 Agent와 조직의 접근 정책을 확인할 수 있어야 합니다. 버튼 위치를 따라 하는 튜토리얼이 아니라, 화면 접근을 허용할지 판단하는 운영 안내입니다.

화면을 보는 권한부터 정하세요

Agent Desktop은 Agent가 실행되는 환경의 그래픽 작업 화면입니다. 파일, 브라우저와 로그인된 화면이 보일 수 있으므로, 아무 작업도 지시하지 않는 열람에서도 정보가 노출될 수 있습니다. 공식 Guide도 업무상 필요한 대상에만 접근하고 화면 공유·녹화에 민감한 정보를 포함하지 말라고 안내합니다.

먼저 세 가지를 정하세요. 누가 어떤 업무 목적으로 화면을 열 수 있는지, 누가 비밀번호를 관리하는지, 무엇을 공유하거나 녹화하지 않을지입니다. 문서에 이름을 적는 일과 실제 접근 권한을 부여하거나 회수하는 일은 다릅니다. 담당자는 조직에서 승인된 관리 절차로 권한을 확인해야 합니다.

이 글의 범위는 ClawPod Cloud Portal에서 보는 Agent 실행 환경입니다. 내 노트북이나 별도로 연결한 컴퓨터의 화면을 뜻하지 않습니다. 외부 컴퓨터 연결과 운영체제 권한 설정은 별도 작업이며, Portal의 Desktop 안내를 그대로 적용하지 마세요. 또한 Portal의 접근 정책과 Agent Control UI 내부의 설정을 같은 것으로 취급하지 않습니다.

Desktop, Dashboard, 대화 기록을 구분하세요

공식 Guide는 Agent 상세에서 Desktop, Dashboard, Conversations가 표시될 수 있다고 설명합니다. 세 화면은 확인하려는 대상이 다릅니다. Room은 사용자와 Agent가 대화하는 협업 공간입니다.

확인하려는 것	사용할 화면	혼동하지 말아야 할 것
Agent 실행 환경의 그래픽 화면	Desktop	별도로 연결한 개인 컴퓨터의 화면이 아닙니다
Agent의 제어 화면	Dashboard	Desktop의 파일·프로그램 화면과 다릅니다
Agent가 참여한 Room의 최근 대화	Conversations	작업 지시를 보내는 Chat이 아닙니다

Dashboard는 Agent의 제어 화면을 가리킵니다. Guide는 실행 중인 상태(running)의 Agent에서 사용하고, Portal 안에서 보거나 새 탭으로 분리해 열 수 있다고 설명합니다. 새 탭이나 전체 화면을 공유할 때도 같은 정보 보호 규칙을 적용하세요. 이 글은 현재 Portal의 버튼 배치나 Agent Control UI의 세부 기능을 설명하지 않습니다.

Desktop에는 실행 중인 Agent와 데스크톱을 지원하는 full 실행 환경이 필요합니다. Guide가 설명하는 full 이미지는 브라우저와 그래픽 데스크톱을 포함한 실행 환경이고, lite 이미지는 경량 실행 환경입니다. lite에는 Chromium, 그래픽 데스크톱과 VNC/noVNC 구성 요소가 없습니다. VNC/noVNC는 원격 데스크톱을 표시하는 데 쓰이는 구성 요소입니다.

브라우저 작업은 full 이미지, 명령줄 작업은 full 또는 lite 이미지에서 사용한다고 Guide는 설명합니다. 일반 사용자가 생성 화면에서 full/lite를 직접 고르는 절차는 제공하지 않습니다. 이미지 선택은 플랫폼 최고 관리자가 제어하며, 일반 사용자는 사용 가능한 full 이미지가 기본 선택됩니다. 데스크톱이 필요한데 준비되지 않았다면 대상 Agent와 필요한 작업을 관리자에게 알려 주세요.

비밀번호 변경은 연결에 영향을 줍니다

Portal은 Agent별 VNC 비밀번호를 관리하며, 조회 화면에는 값 대신 설정 여부를 표시한다고 Guide는 설명합니다. 비밀번호 값은 Chat이나 SOUL.md, AGENTS.md 같은 지침 파일에 적지 마세요. 운영 기록에는 설정 여부, 변경 담당자, 변경 날짜를 남기고 값 자체는 조직의 승인된 비밀정보 보관 절차로 관리합니다.

설정과 변경은 비밀번호 관리 권한과 승인 범위가 확인된 담당자가 진행해야 합니다. Guide에 따르면 비밀번호 변경 뒤 Agent 재시작이 시작되고, 뷰어는 약 8초 뒤 새 연결을 불러옵니다. 이 시간은 문서에 적힌 재연결 동작이지, 현재 환경에서 측정한 복구 시간이나 연결 성공 보장이 아닙니다. 진행 중인 업무에 미칠 영향을 확인하고 변경 시간을 알리세요.

Guide는 기존 비밀번호의 제거가 확인되지 않았으므로 제거 동작을 비밀번호 없는 VNC로 돌아가는 방법으로 사용하지 말라고 경고합니다. 연결 문제를 해결하려고 비밀번호를 무작정 제거하거나 바꾸지 마세요.

화면 공유 전에 세 줄을 채우세요

다음은 조직이 정할 운영 규칙의 예입니다. 제품이 이 규칙을 자동으로 강제한다는 뜻은 아닙니다.

정할 항목	기록할 내용	확인할 때 볼 것
열람 대상	업무 목적, 담당자와 대리자, 접근 종료 시점	승인된 대상과 실제 접근 범위가 맞는지
비밀번호 관리	설정·변경 담당자와 변경 기록 위치	값 없이도 누가 언제 변경했는지 알 수 있는지
공유·녹화 범위	공유할 자료와 금지할 화면, 녹화 허용 여부	파일·로그인·개인정보가 노출되지 않는지

가상 판단 사례: 운영 담당자가 회의에서 Agent의 작업 결과를 보여주려 합니다. 처음에는 Desktop 전체를 공유하면 충분하다고 생각했습니다. 점검해 보니 브라우저에는 로그인된 업무 화면이 열려 있고, 참석자 중 일부는 그 자료의 열람 대상이 아닙니다. 화면 열람 담당자는 민지, 대리자는 준호로 정했고, 비밀번호 변경은 별도의 관리 담당자가 맡습니다. 이번 회의에서는 검토를 마친 비민감 결과 문서만 공유하고 Desktop 공유와 녹화는 하지 않기로 합니다.

성공 기준은 화면을 여는 데 성공했는지가 아닙니다. 공유할 자료와 참석자 범위가 맞고, 민감한 화면을 노출하지 않았는지입니다. 자료의 민감도나 참석자의 권한을 확인하지 못했다면 공유를 보류하고 자료 책임자에게 확인합니다. 이미 노출이 있었다면 조직의 사고 대응·기록 보존 절차를 따릅니다. 녹화를 나중에 지우면 해결된다고 가정하지 마세요.

업무별 조건이 별도 권한 체계를 증명하지는 않습니다

Guide의 기능 안내는 Agent 관리, 조직·사용자·정책 관리, 비용 정보 확인, 감사 기록 조회에 필요한 조건을 각각 적습니다. 이것은 담당 업무를 나눌 때 참고할 수 있지만, Desktop 열람자를 위한 특정 역할이나 화면별 독립 권한이 제공된다는 증거는 아닙니다.

마찬가지로 감사 기록 조회 기능이 있다는 사실만으로 누가 Desktop을 열었는지 모두 기록된다고 결론 내릴 수 없습니다. 필요한 열람 이력이 실제로 수집되는지, 누가 조회할 수 있는지, 얼마나 보존되는지는 관리 담당자에게 별도로 확인하세요. 이 글은 Desktop 열람 감사의 범위나 역할별 권한 설정 방법을 보장하지 않습니다.

연결 오류와 지시할 위치를 나누어 확인하세요

Dashboard 연결에 쓰이는 Gateway token은 Portal의 중계 기능이 서버에서 Agent로 전달하므로 사용자가 입력하지 않는다고 Guide는 설명합니다. awaiting_auth 상태라면 인증 안내를 먼저 완료합니다. 환경이 준비되지 않았다는 표시와 연결 오류는 구분해 관리자에게 전달하세요. Guide는 Gateway 연결 오류에서 Portal이 최대 두 번 다시 불러온 뒤 오류를 표시한다고 설명하지만, 이를 수동 재시도를 계속하라는 뜻으로 읽지 마세요.

Desktop 뷰어의 연결 오류는 noVNC/websockify 구성 요소가 실행되지 않았거나 실행 환경에 연결할 수 없을 때 나타날 수 있다고 Guide는 설명합니다. 오류만 보고 비밀번호 문제라고 단정할 수 없습니다. Agent 상태, 실패한 화면, 비민감 오류 요약을 전달하고, 비밀번호·쿠키·전체 로그는 공유하지 마세요. 준비되지 않은 환경에서 작업을 완료했다고 판단해서도 안 됩니다.

Conversations는 읽기 전용 대화 기록입니다. Guide 기준으로 Agent가 참여한 Room을 사용자 참여 Room과 Agent 전용 Room으로 나누고, 선택한 Room의 최근 100개 메시지를 10초 주기로 갱신합니다. 이는 문서상 설명이며 현재 화면의 지연을 측정한 값은 아닙니다. 여기서는 메시지를 보내거나 Room을 편집하지 않습니다. 업무 지시는 Chat에서 대상 Agent가 참여한 Room을 열어 보냅니다.

다음 화면 공유를 잡기 전에, 위 표의 열람 대상·비밀번호 담당·공유 범위를 해당 Agent 하나에 대해 채우세요. 확인되지 않은 항목이 있다면 화면 공유부터 시작하지 말고 담당자에게 먼저 확인하세요.

Sources

• ClawPod Guide — Agent Desktop과 대화 기록 보기: 실행 환경, 비밀번호 변경과 연결 오류, 읽기 전용 대화 기록, 공유 주의사항.
• ClawPod Guide — Agent에게 Browser와 CLI 작업 요청하기: 실행 이미지 조건, Chat 요청 창구와 민감정보 취급.
• ClawPod Guide — 기능 안내: 작업별 필요 조건. 세부 역할이나 Desktop 열람 감사의 완전성을 보장하지는 않습니다.