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

Matrix 채널 연동 (add-matrix)

NanoClaw 프로젝트에 Matrix 채널 어댑터를 복사·등록·설정해 봇을 Matrix 룸에 연결해 주는 스킬.

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

무엇을 해주나

NanoClaw(에이전트 런타임) 저장소에 Matrix 메신저 채널을 붙여 줍니다. 트렁크에는 채널 코드가 포함되어 있지 않기 때문에, 이 스킬이 channels 브랜치에서 Matrix 어댑터(src/channels/matrix.ts)를 가져와 다음 작업을 순서대로 수행합니다.

  • 어댑터 파일 복사 및 채널 배럴(src/channels/index.ts)에 자기등록 import 한 줄 추가
  • @beeper/chat-adapter-matrix 정확 버전 고정 설치(범위 지정·latest 금지 정책 준수)
  • Node 22 strict ESM에서 실패하는 matrix-js-sdk/lib/... import에 .js 확장자를 붙이는 멱등 패치
  • pnpm run build + 등록 테스트(matrix-registration.test.ts)로 연동 검증
  • 봇 계정 생성 안내와 MATRIX_* 환경변수 저장(비밀번호 방식 / 액세스 토큰 방식 선택)

모든 단계가 nc: 지시문으로 표기되어 있어 에이전트가 읽어도, 파서가 자동 적용해도 동일하게 동작하며 재실행해도 안전합니다.

이런 분께 추천

  • NanoClaw 기반 에이전트를 운영하며 Slack/Discord 대신 Matrix로 대화하고 싶은 분
  • 자체 홈서버(Synapse 등)나 matrix.org에 봇 계정을 두고 에이전트를 붙이려는 분
  • 설치 절차를 문서 하나로 재현 가능하게 관리하고 싶은 개발자

참고: 이 스킬은 NanoClaw 저장소 구조를 전제로 하므로 다른 프로젝트에는 그대로 쓰기 어렵습니다.

활용 예시

  1. 처음 붙이기 — "add-matrix 스킬로 Matrix 채널을 설정해줘"라고 말하면 어댑터 복사부터 빌드·테스트까지 진행하고, 홈서버 URL·봇 user ID·표시 이름을 물어본 뒤 .env에 기록합니다.
  2. pnpm install 후 빌드 깨짐 복구 — ERR_MODULE_NOT_FOUND: matrix-js-sdk/lib/... 오류가 났을 때 4단계 ESM 패치만 다시 실행해 복구합니다.
  3. 로그인 실패 진단 — M_FORBIDDEN이 뜰 때 MATRIX_USERNAME(로컬파트)과 MATRIX_USER_ID(전체 ID)가 뒤바뀌지 않았는지, 액세스 토큰이 만료되지 않았는지 트러블슈팅 항목으로 점검합니다.

· · · 설치 가이드 · · ·

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

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

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

직접 명령으로 설치하기

git clone https://github.com/nanocoai/nanoclaw.git && mkdir -p ~/.claude/skills && cp -r nanoclaw/.claude/skills/add-matrix ~/.claude/skills/

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

  1. 터미널을 열고 NanoClaw 저장소를 클론합니다: git clone https://github.com/nanocoai/nanoclaw.git
  2. 스킬 폴더를 만듭니다: mkdir -p ~/.claude/skills
  3. 스킬을 복사합니다: cp -r nanoclaw/.claude/skills/add-matrix ~/.claude/skills/
  4. 작업 디렉터리를 NanoClaw 프로젝트로 이동합니다: cd nanoclaw (이 스킬은 해당 저장소 안에서만 동작합니다).
  5. Element(app.element.io)에서 봇 전용 Matrix 계정을 새로 만들고 user ID(예: @andybot:matrix.org)를 메모합니다. 본인 계정과 반드시 분리해야 합니다.
  6. Claude Code를 실행하고 "add-matrix 스킬로 Matrix 채널을 추가해줘"라고 요청합니다.
  7. 물어보는 값(홈서버 URL, 봇 user ID, 표시 이름, 비밀번호 또는 액세스 토큰)을 입력하면 .env에 저장됩니다.
  8. 마지막으로 pnpm run build와 pnpm exec vitest run src/channels/matrix-registration.test.ts가 통과하는지 확인하고, /manage-channels로 에이전트 그룹에 연결합니다.
GitHub에서 원본 보기 ↗라이선스: MIT