내 컴퓨터를 ClawPod 노드로: 능력 설치부터 첫 작업까지

문서 기반 절차이며 전체 설치 시험을 통과한 튜토리얼은 아닙니다. 공개 Node Host 0.2.1 흐름을 설명합니다. 문서의 마지막 연결 검증 명령은 이 글에서 확인한 Linux Agent에서 실행되지 않았으며, 구현의 관찰 경로는 실제 원격 연결을 입증하는 대신 시험용 데이터를 사용합니다. 따라서 설치 완료만으로 연결 성공을 판단하면 안 됩니다. Agent가 사용 가능한 실행 환경의 상태 도구로 실제 증거를 확인하거나, 검증이 막혔다고 보고해야 합니다. 이것이 고객 온보딩 자체가 불가능하다는 뜻은 아닙니다.

1. 먼저 Node Host 능력을 설치해 주세요

내 Mac이나 Windows 11 PC에서 ClawPod Agent에게 간단한 작업을 맡기고 싶다면, 먼저 Agent에 Node Host 능력을 준비해 주세요. 여기서 노드는 Agent가 작업을 요청할 수 있도록 연결한 컴퓨터입니다. 능력을 Agent에 설치하는 것과 내 컴퓨터를 실제로 연결하는 것은 서로 다른 단계입니다.

Room에서 다음처럼 요청해 보세요. 아래 문장은 정해진 명령어가 아니라 공식 설치 절차를 바탕으로 만든 요청 예시입니다.

https://github.com/Wondermove-Inc/clawpod-capabilities 에서 clawpod-node-host 능력을 찾아 제 Agent에 설치하고 검증해 주세요. 연결된 Skill과 CLI Harness를 함께 준비하고, 이미 설치되어 있다면 버전과 준비 상태부터 확인해 주세요. 아직 제 컴퓨터 연결은 시작하지 마세요.

Agent는 공식 Registry에서 패키지와 호환성을 확인하고 설치 결과를 검증합니다. Registry 관리 능력이 없다면 먼저 공식 저장소의 초기 설치 절차가 필요합니다. 경로나 설치 파일을 직접 고를 필요 없이 Agent가 준비 상태를 설명하도록 요청하세요. 기존 설치와 충돌하거나 현재 실행 환경이 지원하지 않으면 그 문제부터 해결해야 합니다.

확인할 답은 “파일을 받았습니다”가 아니라 “Node Host Skill과 실행 도구가 함께 준비되었고 검증되었습니다”입니다. 이 글은 Node Host 0.2.1의 사용자 직접 실행 경로를 설명합니다. 설치된 버전이 다르면 이 흐름을 그대로 가정하지 말고 차이를 먼저 확인해 주세요. 이 Registry 경로를 ClawPod Cloud의 특정 설치 버튼이나 Marketplace 등록 여부와 혼동하지 마세요.

2. 연결할 컴퓨터를 알려 주세요

능력이 준비되면 같은 Room에서 이어서 말해 주세요.

제 Mac을 ClawPod 노드로 연결하고 싶어요. 제가 실행할 수 있는 설치 스크립트를 준비해 주세요.

Windows라면 “제 Windows 11 PC를 연결하고 싶어요”라고 바꾸면 됩니다. Agent는 운영체제를 확인하고 해당 컴퓨터에서 실행할 스크립트를 준비합니다. 연결 주소를 찾아 복사하거나 스크립트의 빈칸을 채우는 방식이 아닙니다.

컴퓨터는 켜져 있고 인터넷에 연결되어 있어야 합니다. 직접 Terminal 또는 PowerShell을 열 수 있어야 하며, 회사에서 관리하는 컴퓨터라면 프로그램 설치와 장치 연결이 허용되는지 먼저 확인해 주세요. 필요한 설치 권한이나 운영체제 확인 창이 나타나면 사용자가 처리합니다.

3. 받은 스크립트를 내 컴퓨터에서 실행하세요

아직 연결되지 않은 컴퓨터를 Agent가 대화만으로 자동 조작할 수 있는 것은 아닙니다. 이 경로에서는 사용자가 처음 한 번 연결 준비를 시작합니다.

Mac: Terminal에서 Agent가 준 스크립트를 실행합니다.
Windows 11: PowerShell에서 Agent가 준 스크립트를 실행합니다.

스크립트는 노드 실행에 필요한 구성 요소를 준비하며, Tailscale이나 Node.js가 없으면 설치 단계가 포함될 수 있습니다. Tailscale은 Agent와 컴퓨터가 연결되는 데 사용하는 네트워크 도구입니다. 실행하기 전에 무엇을 설치하고 연결하는지 Agent의 설명을 확인하세요. 이 글에는 여러 사람에게 재사용할 고정 스크립트를 싣지 않습니다. 자신의 Agent가 해당 연결을 위해 만든 스크립트를 사용해 주세요.

이미 이 컴퓨터에서 ClawPod를 사용하나요? 스크립트 실행 전에 기존 실행 프로그램이나 노드 설치와 충돌하는지 Agent에게 확인해 달라고 하세요. 전역 실행 패키지를 설치하므로 같은 위치의 기존 설치가 바뀔 수 있습니다.

로그인이 필요하면 Agent가 링크를 안내하거나 스크립트가 다음 행동을 표시합니다. ClawPod에 사용하는 것과 같은 Tailscale 계정으로 브라우저에서 직접 로그인해 주세요. 어떤 계정인지 모르면 임의로 새 계정을 만들기보다 Agent 또는 조직 관리자에게 확인하세요. Agent 쪽 연결이 아직 준비되지 않았다면 그쪽 로그인 링크를 먼저 받을 수도 있습니다. 로그인과 인증 확인은 사용자가 직접 합니다.

스크립트가 ACTION: 안내를 표시하고 멈췄다면 반드시 설치 실패라는 뜻은 아닙니다. 표시된 설치나 로그인 행동을 마친 뒤 같은 스크립트를 다시 실행하는 흐름입니다. 어떤 행동을 해야 할지 모르겠다면 이렇게 요청하세요.

설치 중 ACTION 안내가 나왔어요. 비밀번호나 토큰 없이 안내 문구만 전달할 테니, 지금 필요한 한 단계만 알려 주세요.

스크립트에는 한국어 안내가 포함될 수 있습니다. 필요한 경우 민감정보를 지운 ACTION: 한 줄만 공유하고 원하는 언어로 설명해 달라고 하세요. 전체 스크립트·토큰·원본 로그를 공유하지 마세요.

4. “연결됨”을 확인한 뒤 첫 작업을 맡기세요

스크립트가 끝나면 Agent에게 완료 사실을 알리고 이 컴퓨터의 연결을 확인해 달라고 하세요. Terminal이나 PowerShell의 완료 문구만으로 Agent가 접근할 수 있다고 판단하면 안 됩니다. 문서의 기본 흐름은 Agent가 일치하는 연결 요청을 기다리고 페어링을 처리하는 것입니다. 실제 연결 검증은 그 단계가 보장하는 결과가 아니라 별도로 통과해야 할 확인입니다. 페어링은 이 컴퓨터를 해당 Agent의 노드로 연결하는 과정입니다. 0.2.1의 기본 경로는 일치하는 요청을 Agent가 처리하도록 정의되어 있으므로, 사용자가 별도 관리 화면에서 요청 번호를 찾아야 한다고 가정할 필요는 없습니다. 실행 환경의 정책에 따라 추가 확인이 나타날 수 있습니다.

다음 세 가지가 구분된 답을 받으면 좋습니다.

어느 컴퓨터가 연결되었는지
실제 연결 확인이 끝났는지
지금 요청할 작업이 가능한지

Agent가 사용 가능한 실제 노드 상태 도구로 대상 컴퓨터의 식별 정보와 현재 연결 상태를 확인하도록 요청하세요. 도구나 증거가 없으면 **“연결 검증 불가”**라고 보고하고 첫 작업 전에 멈춰야 합니다. 생성된 식별자나 시험용 데이터의 성공 결과는 실제 연결 증거가 아닙니다. 이는 통과해야 할 확인 기준이지, 0.2.1 Harness에서 검증된 기능이라는 뜻이 아닙니다.

연결되었다고 해서 모든 파일·브라우저·화면 조작 권한이 생기는 것은 아닙니다. 첫 작업은 변경이 없는 작은 확인으로 시작하세요.

방금 연결한 컴퓨터에서 기본 명령 실행이 가능한지만 확인해 주세요. 파일을 읽거나 바꾸거나 프로그램을 설치하지 말고, 실행한 확인과 결과만 알려 주세요.

작업 승인이 필요한 경우에는 대상과 내용을 확인하고 진행하면 됩니다. 화면 제어나 브라우저 작업이 목적이라면 기본 연결 확인 뒤에 그 기능의 준비 상태를 따로 확인하세요.

5. 내 컴퓨터에서 해 볼 만한 실용 작업 세 가지

실제 연결과 명령 실행이 확인되었다면 아래에서 하나를 골라 보세요. 이 글에서 실행한 결과가 아니라, 요청 예시와 기대 결과입니다. Node Host는 연결을 준비하고, 실제 작업은 별도로 사용 가능한 노드 실행 도구가 담당합니다. Agent는 Cloud 작업 공간이 아니라 지정한 컴퓨터에서 실행해야 합니다. Guide의 /workspace 파일 접근이 내 컴퓨터의 파일 접근까지 보장하지는 않습니다.

세 예시는 모두 읽기 전용이며, 필요한 명령이 허용된 Mac 또는 Windows 11에서 적용할 수 있습니다. Agent가 확인한 운영체제에 맞는 명령과 기존 도구를 사용하며, 추가 프로그램이 설치되어 있다고 가정하지 않습니다. 파일 작업에는 정확한 경로 하나를 알려 주고 민감하지 않은 샘플부터 사용하세요. 파일명과 요약이 Room에 표시될 수 있습니다. 지정한 컴퓨터와 경로 안에서만 작업하며 파일 변경·프로그램 설치·권한 변경·다른 서비스로의 업로드는 하지 않습니다. 접근이나 적합한 도구가 없으면 범위를 넓히는 대신 막힌 이유를 보고해야 합니다.

A. 큰 파일을 받기 전에 여유 공간 확인하기

10 GB 압축 파일을 내려받을 예정인가요? 다운로드할 저장 공간을 읽기 전용으로 확인하는 것부터 시작하세요.

방금 연결한 컴퓨터에서 다운로드 폴더가 있는 볼륨의 여유 공간을 확인해 주세요. 어느 컴퓨터와 볼륨을 확인했는지, 남은 공간과 10 GB를 넘는지 알려 주세요. 위치가 불분명하면 어떤 폴더인지 물어봐 주세요.

기대 결과: 다운로드 실행이 아니라 용량 보고입니다. 10 GB보다 많이 남았다는 것은 공간 비교일 뿐이며, 압축 해제와 임시 파일에는 추가 공간이 필요할 수 있습니다.

아래는 설명을 위해 만든 가상 응답이며 이 글에서 측정한 값이 아닙니다.

컴퓨터 / 볼륨: 내 노트북 / 다운로드 폴더가 있는 볼륨
여유 공간: 보고한 확인 시각 기준 42 GB
비교: 10 GB 초과, 압축 해제 공간은 미평가
변경 사항: 없음

성공 확인: 컴퓨터와 볼륨이 맞고, 단위·확인 시각·비교 설명이 있는지 보세요. 의외의 결과라면 운영체제의 저장 공간 정보와 비교합니다.

실패하면: “연결이 안 된 건가요, 용량 조회가 거부된 건가요, 다운로드 위치가 불분명한 건가요? 마지막으로 성공한 확인과 다음에 필요한 정보 하나를 알려 주세요.”

B. 폴더를 정리하기 전에 파일 목록 만들기

프로젝트 인수인계 폴더를 정리하기 전에 파일명과 정보만으로 현황을 파악해 보세요. 정확한 폴더 경로를 알려 주면 되며 파일 내용은 열 필요가 없습니다.

제가 알려 주는 정확한 경로의 프로젝트 인수인계 폴더에서 바로 아래 파일의 이름·확장자·크기·최종 수정 시각을 정리해 주세요. 확장자별 개수와 가장 큰 파일 다섯 개도 요약해 주세요. 파일 내용은 열지 말고 하위 폴더나 다른 위치로 연결된 링크는 따라가지 마세요.

기대 결과: 정리가 끝난 폴더가 아니라 정리 계획에 쓸 목록입니다. 이름이 비슷하다고 내용까지 중복된 파일은 아닙니다.

성공 확인: 대상 경로가 맞는지, 전체 개수와 확장자별 개수의 합이 일치하는지 확인하고 몇 항목을 컴퓨터에서 직접 대조하세요. 읽지 못한 항목은 조용히 빼지 말고 건너뛴 항목으로 보고해야 합니다.

실패하면: “폴더가 없나요, 읽을 수 없나요, 한 번에 목록을 만들기에는 너무 큰가요? 올바른 경로를 물어보거나 이 폴더 안에서 더 작은 범위를 제안해 주세요.”

C. 보고서에 쓰기 전에 작은 CSV 확인하기

민감하지 않은 작은 CSV 내보내기 파일로 누락된 값을 찾아보세요. 이 작업은 지정한 파일의 내용을 읽으며, 컴퓨터에 적합한 CSV 읽기 도구가 이미 있어야 합니다. Python이나 Excel이 설치되어 있다고 가정하지 않습니다.

제가 알려 주는 정확한 경로의 샘플 CSV 하나만 기존 CSV 읽기 도구로 확인해 주세요. 쉼표로 단순 분리하지 말고 열 이름·헤더를 제외한 데이터 행 수·열별 누락값 수를 알려 주되, 비어 있거나 공백만 있는 값은 누락으로 세어 주세요. 개별 레코드는 답에 넣지 말고 인코딩·구분자·헤더가 불분명하면 물어봐 주세요.

기대 결과: 수정된 스프레드시트가 아니라 간결한 데이터 품질 요약입니다. 적합한 도구가 없다면 부정확한 개수 대신 명확한 차단 사유를 알려야 합니다.

성공 확인: 파일·파서·인코딩·구분자·헤더 가정·누락값 기준이 보고에 있는지 보세요. 직접 셀 수 있는 작은 샘플과 개수를 대조합니다. 따옴표 안의 쉼표와 줄바꿈을 올바르게 해석하고, 형식이 잘못된 행을 조용히 건너뛰지 않아야 합니다.

실패하면: “파일 접근, CSV 읽기 도구 부재, 파일 형식 중 무엇이 막혔나요? 다음 확인에 필요한 최소한의 비민감 샘플이나 형식 정보를 알려 주세요.”

일상적인 읽기 전용 확인은 요청 범위와 실행 환경의 정책 안에서 진행합니다. 파일 이동·삭제, 프로그램 설치, 데이터 업로드, 계정 변경은 별도 범위와 확인이 필요한 작업입니다. 브라우저와 일반 앱 조작도 능력과 권한을 따로 확인해야 하며, 페어링만으로 사용할 수 있는 것은 아닙니다.

잘 안 될 때는 처음부터 다시 설치하지 마세요

“기다리는 중”은 사용자의 스크립트 실행이나 로그인이 아직 끝나지 않았다는 뜻일 수 있습니다. Agent에게 마지막으로 완료된 단계와 지금 필요한 행동 하나를 알려 달라고 요청하세요. 오류를 전달할 때는 비밀번호·토큰·개인 계정 정보가 포함되지 않도록 해 주세요.

연결이 아직 완료되지 않았어요. 마지막으로 성공한 단계부터 확인하고, 제가 지금 해야 할 행동 하나만 알려 주세요. 중복 설치는 먼저 하지 마세요.

설치는 끝났지만 연결이 되지 않는 문제는 연결 진단으로 이어질 수 있습니다. 모르는 장치가 나타나거나 연결 대상이 불분명하면 진행을 멈추고 대상을 확인합니다.

잠시 끊기와 제거는 다르게 요청하세요

잠깐 사용하지 않을 때는 이렇게 말해 주세요.

이 컴퓨터의 ClawPod 노드 연결을 잠시 중지하고 싶어요. 다시 연결할 수 있도록 남겨 둘 항목과 중지 결과를 알려 주세요.

더 이상 쓰지 않을 때는 제거 범위를 분명히 합니다.

이 컴퓨터에서 ClawPod 노드를 제거해 주세요. 제거되는 항목과 남는 항목을 먼저 설명하고, 완료 후 더 이상 연결되지 않는지 확인해 주세요. 다른 용도로 쓰는 네트워크 도구는 유지해 주세요.

기본 서비스 제거와 설치 스크립트의 되돌리기는 같은 작업이 아닙니다. 0.2.1 문서는 서비스 제거 시 일부 연결 설정이 남는다고 설명하고, 사용자 실행 스크립트에는 노드 서비스와 패키지를 제거하는 되돌리기 경로도 정의합니다. 필요한 방식은 Agent가 확인하도록 하세요. “제거 완료”만 듣기보다 실제로 연결이 중지되었는지, 무엇이 남았는지 확인하는 것이 중요합니다.

서비스 제거와 다른 작업도 사용하는 실행 패키지 제거는 다릅니다. 스크립트 되돌리기는 전역 패키지까지 제거할 수 있습니다. 공유 실행 패키지와 의존성은 기본적으로 보존하고, 더 넓은 제거는 별도로 확인하도록 요청하세요.

이 안내의 범위

이 글은 공개 Node Host 0.2.1 문서에 정의된 사용자 직접 실행 경로를 설명합니다. 이 글을 위해 실제 Mac·Windows 11 전체 설치 과정을 재현한 것은 아닙니다. 개별 ClawPod Cloud 환경의 정책·네트워크·설치 권한과 실제 실행 결과는 대상 Agent에서 확인해야 합니다. SSH를 통한 대리 설치나 조직 네트워크 관리는 다루지 않습니다.

시작은 한 문장이면 됩니다. “Node Host 능력을 설치하고 준비 상태를 확인해 주세요.” 그다음 컴퓨터 종류를 알려 주고, 생성된 스크립트와 필요한 로그인 단계를 따라가며 첫 번째 작은 작업으로 연결을 확인해 보세요.