GitHub 채널 연동 (NanoClaw)
NanoClaw 에이전트가 GitHub PR·이슈 코멘트 스레드에서 대화하도록 GitHub 채널 어댑터를 설치·설정해 주는 스킬입니다.
자동화·워크플로고급★ 30,573⑂ 12,843AI 점수 8/10마지막 업데이트: 2026. 8. 20.
무엇을 해주나
channels브랜치에서 GitHub 어댑터(src/channels/github.ts)를 가져와 프로젝트에 복사하고, 채널 배럴(src/channels/index.ts)에 자기등록 import 한 줄을 추가합니다.@chat-adapter/github를 정확한 버전으로 고정 설치하고, 빌드 + 등록 테스트(vitest)로 실제 연결 여부를 검증합니다.- 봇 전용 GitHub 계정의 파인그레인드 PAT, 웹훅 시크릿, 봇 사용자명을 프롬프트로 받아
.env에 안전하게 기록합니다(기존 값은 덮어쓰지 않음). - 저장소가 공개/비공개인지에 따라
unknown_sender_policy를 골라ncl로 메시징 그룹·와이어링·멤버를 만들고, 스레드별(per-thread) 세션 모드를 설정합니다. - 401/403 토큰 오류, 빨간 웹훅 전송, @멘션 무반응 등 자주 겪는 문제의 원인별 해결 절차를 제공합니다.
이런 분께 추천
- NanoClaw를 셀프호스팅하며 GitHub 리뷰·이슈 대응에 에이전트를 붙이려는 분
- PR/이슈 코멘트를 에이전트 대화 채널로 쓰고 싶은 개발 인프라·플랫폼 담당자
- 여러 저장소에 봇 계정을 배치해 스레드별 격리 세션을 운영해야 하는 팀
활용 예시
- "우리 백엔드 레포에 GitHub 채널 붙여줘" → 어댑터 복사, 의존성 설치, 빌드/테스트 실행까지 자동 수행.
- 공개 저장소에 연동할 때
strict정책을 적용하고,gh api users/<username> --jq .id로 신뢰 사용자 ID를 찾아 멤버로 등록. - 웹훅이 계속 401을 반환할 때, 시크릿과
GITHUB_WEBHOOK_SECRET불일치를 짚고 Redeliver로 재검증하는 절차 안내.
· · · 설치 가이드 · · ·
설치 없이 지금 한 번 써보기
아래를 Claude에 붙여넣으면 설치하지 않고도 이 스킬을 그대로 씁니다.
이 파일의 지시를 읽고 그대로 따라서 나를 도와줘: https://raw.githubusercontent.com/nanocoai/nanoclaw/HEAD/.claude/skills/add-github/SKILL.md 내가 원하는 것: (여기에 하고 싶은 일을 쓰세요)
Claude가 링크를 열지 못하면, 링크를 직접 열어 내용을 복사해 붙여넣으세요.
↓ 쓸 만하면 아래에서 ZIP을 받아 설치하세요. 그러면 매번 붙여넣지 않아도 알아서 작동합니다.
Claude 앱에 설치 (터미널 필요 없음)
- 아래 버튼으로 ZIP 파일을 받으세요.
- Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
- Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
Claude Code에 설치
Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요
클로드스킬마트에서 찾은 스킬을 설치해줘. GitHub 저장소 nanocoai/nanoclaw 의 .claude/skills/add-github 폴더를 내 ~/.claude/skills/add-github/ 에 그대로 복사해줘. 설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.
직접 명령으로 설치하기
git clone https://github.com/nanocoai/nanoclaw.git && mkdir -p ~/.claude/skills && cp -r nanoclaw/.claude/skills/add-github ~/.claude/skills/⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.
- 터미널을 열고 스킬이 담긴 저장소를 내려받습니다:
git clone https://github.com/nanocoai/nanoclaw.git - 스킬 폴더를 Claude 스킬 디렉터리로 복사합니다:
mkdir -p ~/.claude/skills && cp -r nanoclaw/.claude/skills/add-github ~/.claude/skills/ - 사전 준비: 개인 계정이 아닌 전용 GitHub 봇 계정을 만들고, 감시할 저장소에 쓰기 권한 협업자로 초대합니다.
- 봇 계정으로 로그인해 Settings → Developer Settings → Personal Access Tokens에서 Fine-grained 토큰(Pull requests·Issues = Read & Write)을 발급합니다.
- 각 저장소에 웹훅을 추가합니다: Payload URL
https://도메인/webhook/github, Content typeapplication/json, 시크릿은openssl rand -hex 20, 이벤트는 Issue comments + Pull request review comments. - NanoClaw 프로젝트 루트에서 Claude Code를 실행하고 "GitHub 채널을 추가해줘"라고 요청하면 스킬이 발동합니다. 프롬프트에 토큰·시크릿·봇 사용자명을 입력하세요.
pnpm run build와 등록 테스트가 통과했는지 확인하고,ncl로 메시징 그룹/와이어링을 만든 뒤 서비스를 재시작합니다(macOS:launchctl kickstart, Linux:systemctl --user restart).- 다른 계정으로 PR 코멘트에
@봇사용자명을 멘션해 응답이 오는지 확인합니다.
GitHub에서 원본 보기 ↗라이선스: MIT