Linear 채널 연동 추가
NanoClaw 에이전트를 Linear 이슈 댓글 스레드에 연결해 모든 댓글에 자동 응답하도록 설정하는 스킬입니다.
자동화·워크플로고급★ 30,471⑂ 12,865AI 점수 7/10마지막 업데이트: 2026. 8. 9.
무엇을 해주나
NanoClaw 프로젝트에 Linear 채널 어댑터를 붙여 넣고, Chat SDK 브리지를 통해 Linear 이슈의 댓글 스레드를 에이전트 대화로 만들어 줍니다.
channels브랜치에서src/channels/linear.ts와 등록 테스트를 복사- 채널 배럴(
src/channels/index.ts)에 자기등록 import 한 줄 추가 @chat-adapter/linear@4.29.0정확한 버전 고정 설치- 빌드 + 등록 테스트로 검증
- OAuth 앱/개인 API 키, 웹훅 시그닝 시크릿, 팀 키를
.env에 기록 ncl messaging-groups·ncl wirings명령으로 팀↔에이전트 배선
모든 단계는 nc: 지시문 펜스로 표기돼 있어 멱등(idempotent)하며, 재실행해도 안전합니다. Linear OAuth 앱은 @멘션이 불가하므로 engage 모드는 pattern .(모든 댓글 응답), 세션 모드는 per-thread(이슈별 독립 대화)로 설정됩니다.
이런 분께 추천
- NanoClaw 셀프호스팅 에이전트를 운영하며 Linear를 이슈 트래커로 쓰는 팀
- 이슈 댓글에서 바로 AI 응답을 받고 싶은 개발/PM 조직
- 채널 어댑터 추가 절차를 문서 기반으로 자동화하려는 플랫폼 엔지니어
활용 예시
- 버그 이슈 트리아지: ENG 팀 이슈에 재현 로그를 댓글로 남기면 에이전트가 원인 추정과 관련 코드 위치를 같은 스레드에 답변.
- 스펙 논의: 기획 이슈 댓글 스레드마다 독립 세션이 만들어져, 다른 이슈의 문맥이 섞이지 않은 상태로 문서 초안 작성 요청.
- 공개 워크스페이스 보호:
strict발신자 정책을 선택해 등록된 멤버의 댓글만 에이전트가 처리하도록 제한.
· · · 설치 가이드 · · ·
Claude 앱에 설치 (터미널 필요 없음)
- 아래 버튼으로 ZIP 파일을 받으세요.
- Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
- Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
Claude Code에 설치
Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요
클로드스킬마트에서 찾은 스킬을 설치해줘. GitHub 저장소 nanocoai/nanoclaw 의 .claude/skills/add-linear 폴더를 내 ~/.claude/skills/add-linear/ 에 그대로 복사해줘. 설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.
직접 명령으로 설치하기
git clone https://github.com/nanocoai/nanoclaw.git && cp -r nanoclaw/.claude/skills/add-linear ~/.claude/skills/⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.
- 터미널에서 NanoClaw 프로젝트가 있는 위치로 이동합니다.
- 스킬을 내려받습니다:
git clone https://github.com/nanocoai/nanoclaw.git - 스킬 폴더를 Claude Code가 읽는 위치로 복사합니다:
cp -r nanoclaw/.claude/skills/add-linear ~/.claude/skills/ - Linear에서 Settings > API > OAuth Applications로 가서 앱을 만들고, 생성 후 Client credentials 권한을 켜고 Client ID/Secret을 복사합니다. (간단히 하려면 Personal API Key 사용)
- Settings > API > Webhooks에서 URL
https://도메인/webhook/linear, 팀 선택, Comment 이벤트 체크로 웹훅을 만들고 시그닝 시크릿을 복사합니다. - NanoClaw 프로젝트 루트에서 Claude Code를 실행하고 "Linear 채널을 추가해줘"라고 요청하면 스킬이 Apply 단계를 순서대로 진행합니다.
- 프롬프트에 Client ID/Secret, 웹훅 시크릿, 팀 키(예:
ENG), 봇 표시 이름을 입력합니다. pnpm run build와pnpm exec vitest run src/channels/linear-registration.test.ts가 모두 통과하는지 확인합니다.- 마지막으로 안내된
launchctl(macOS) 또는systemctl --user restart(Linux) 명령으로 서비스를 재시작합니다. 새 웹훅은 1~5분 지연될 수 있습니다.
GitHub에서 원본 보기 ↗라이선스: MIT