클로드스킬마트스킬 둘러보기스킬이 뭐예요?
 
← 목록으로

NanoClaw 첫 에이전트 초기화

NanoClaw에서 DM 채널용 첫 번째 에이전트를 만들고 환영 메시지로 전달 경로까지 검증해 주는 안내형 스킬입니다.

자동화·워크플로고급★ 30,471⑂ 12,865AI 점수 6/10마지막 업데이트: 2026. 8. 9.

무엇을 해주나

NanoClaw(멀티 채널 메신저 에이전트 런타임)에서 첫 번째 에이전트를 세우는 전 과정을 Claude가 대화형으로 진행합니다.

  • 활성화된 채널 목록(src/channels/index.ts)과 .env 자격증명을 읽어 어떤 채널에 에이전트를 붙일지 선택
  • 운영자의 채널 사용자 ID·표시 이름·에이전트 페르소나 이름 수집
  • 콜드 DM 지원 여부에 따라 DM 플랫폼 ID를 해석 (텔레그램·왓츠앱 등은 바로 사용, 디스코드·슬랙 등은 사용자가 봇에 DM 1회 발송 후 messaging_groups 테이블에서 조회)
  • scripts/init-first-agent.ts 실행으로 users / agent_groups / messaging_groups / messaging_group_agents 레코드 생성 및 그룹 파일시스템 초기화
  • CLI 소켓을 통해 환영 DM을 실제 전달 경로로 발송하여 엔드투엔드 검증
  • 도착하지 않을 경우 outbound.db 상태 조회, 로그 grep 등 구체적인 진단 절차 제공

모든 단계는 멱등(idempotent)해서 다시 실행해도 안전합니다.

이런 분께 추천

  • NanoClaw를 처음 설치하고 첫 에이전트를 붙여보려는 운영자
  • 디스코드/슬랙/텔레그램 봇을 에이전트와 연결하는 초기 배선이 헷갈리는 분
  • 환영 DM이 오지 않을 때 어디를 봐야 하는지 체계적인 체크리스트가 필요한 분

주의: NanoClaw 저장소 안에서, 서비스가 이미 실행 중이고 채널 자격증명이 설정된 상태에서만 의미가 있습니다.

활용 예시

  1. 디스코드 첫 에이전트: /add-discord로 봇 토큰을 넣은 뒤 이 스킬 실행 → 봇에게 DM 한 번 보내고, 조회된 platform_id를 확인하면 몇 분 안에 환영 DM 도착.
  2. 텔레그램 페어 코드 경로: 봇에 먼저 DM하기 싫을 때 --step pair-telegram으로 발급된 코드를 채팅에 입력해 사용자 ID와 플랫폼 ID를 자동 연결.
  3. 전달 실패 디버깅: 환영 DM이 2분 내 도착하지 않으면 outbound.db의 pending 행과 로그의 Unauthorized channel destination 라인을 확인해 ACL/컨테이너 문제를 특정.

· · · 설치 가이드 · · ·

Claude 앱에 설치 (터미널 필요 없음)
  1. 아래 버튼으로 ZIP 파일을 받으세요.
  2. Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
  3. Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
↓ ZIP 내려받기
Claude Code에 설치

Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요

클로드스킬마트에서 찾은 스킬을 설치해줘.
GitHub 저장소 nanocoai/nanoclaw 의 .claude/skills/init-first-agent 폴더를 내 ~/.claude/skills/init-first-agent/ 에 그대로 복사해줘.
설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.

직접 명령으로 설치하기

git clone https://github.com/nanocoai/nanoclaw.git && mkdir -p ~/.claude/skills && cp -r nanoclaw/.claude/skills/init-first-agent ~/.claude/skills/

⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.

  1. 터미널을 열고 NanoClaw 저장소를 클론합니다: git clone https://github.com/nanocoai/nanoclaw.git
  2. 스킬 폴더가 없다면 만듭니다: mkdir -p ~/.claude/skills
  3. 스킬을 복사합니다: cp -r nanoclaw/.claude/skills/init-first-agent ~/.claude/skills/
    • (NanoClaw 저장소 자체에서 작업한다면 이미 .claude/skills/에 포함되어 있으니 복사할 필요가 없습니다.)
  4. NanoClaw를 먼저 세팅합니다: /setup 실행 → 서비스가 launchd(macOS) 또는 systemd(Linux)에서 돌아가는지 확인.
  5. 사용할 채널 스킬(/add-discord, /add-telegram 등)을 실행해 .env에 자격증명을 넣고 src/channels/index.ts에서 어댑터 주석을 해제합니다.
  6. NanoClaw 저장소 디렉터리에서 Claude Code를 실행한 뒤 "첫 에이전트를 만들어줘" 또는 init-first-agent라고 요청하면 스킬이 단계별로 안내합니다.
  7. 마지막에 환영 DM이 도착하는지 확인하고, 오지 않으면 스킬이 제시하는 진단 명령을 따라갑니다.
GitHub에서 원본 보기 ↗라이선스: MIT