moazbuilds/claudeclaw
요약
ClaudeClaw는 Claude Code를 백그라운드 데몬 형태로 실행하여 24시간 작동하는 개인 비서로 변환해주는 오픈 소스 도구입니다. Telegram, Discord, Slack과 같은 메신저와 통합되어 스케줄링된 작업 수행, 메시지 응답, 음성 명령 전사 등의 기능을 제공합니다.
핵심 포인트
- Claude Code를 백그라운드 데몬으로 실행하여 정해진 일정에 따라 작업을 수행하는 크론 잡(Cron Jobs) 기능 지원
- Telegram, Discord, Slack과의 통합을 통해 텍스트, 이미지, 음성 메시지 대응 가능
- Discord 스레드별 독립적인 세션 관리 및 병렬 처리 기능 제공
- 사용자 설정 마법사를 통한 모델, 하트비트, 보안 및 메신저 연동 설정 지원
Claude Code에 내장된 가볍고 오픈 소스인 OpenClaw 버전입니다.
ClaudeClaw는 여러분의 Claude Code를 잠들지 않는 개인 비서로 바꿔줍니다. 이 도구는 백그라운드 데몬 (daemon)으로 실행되어, 정해진 일정에 따라 작업을 수행하고, Telegram, Discord, Slack의 메시지에 응답하며, 음성 명령을 전사(transcribing)하고, 필요한 모든 서비스와 통합됩니다.
참고: 은행 시스템 해킹이나 기타 불법적인 활동에 ClaudeClaw를 사용하지 마십시오. 감사합니다.
| 카테고리 | ClaudeClaw | OpenClaw |
|---|---|---|
| Anthropic이 당신을 추적할 것인가 | 아니오 | 예 |
| ... | 악몽 |
claude plugin marketplace add moazbuilds/claudeclaw
claude plugin install claudeclaw
그 다음 Claude Code 세션을 열고 다음을 실행하십시오:
/claudeclaw:start
설정 마법사(setup wizard)가 모델 (model), 하트비트 (heartbeat), Telegram, Discord, Slack, 그리고 보안 설정을 안내하며, 완료되면 웹 대시보드와 함께 데몬이 활성화됩니다.
만약 src/, commands/, prompts/, 또는 .claude-plugin/ 아래의 배포된 플러그인 파일들을 변경한다면, Claude Code와 마켓플레이스 사용자들이 업데이트를 올바르게 감지할 수 있도록 플러그인 메타데이터 버전 (plugin metadata version)을 올려야 할 수도 있습니다.
도우미 명령어:
bun run bump:plugin-version
bun run bump:marketplace-version
문서 전용 변경 사항이나 기타 배포되지 않는 변경 사항은 이러한 버전 업그레이드가 필요하지 않습니다.
메가 포스트 (Mega Post): 다음 ClaudeClaw 기능을 만드는 데 참여하세요. 이 포스트에서 투표하고, 아이디어를 제안하며, 우선순위를 논의하십시오.
하트비트 (Heartbeat): 구성 가능한 간격, 방해 금지 시간(quiet hours), 편집 가능한 프롬프트 (prompts)를 갖춘 주기적인 체크인.
크론 잡 (Cron Jobs): 신뢰할 수 있는 실행을 보장하며, 반복 작업 또는 일회성 작업을 위한 시간대(timezone) 인식 스케줄.
Telegram: 텍스트, 이미지 및 음성 지원.
Discord: DM (Direct Messages), 서버 멘션/답장, 슬래시 명령어 (slash commands), 음성 메시지 및 이미지 첨부.
Slack: 소켓 모드 (Socket Mode) 봇 — DM, 채널 멘션, 스레드 (threads), 음성 메시지 및 파일 첨부. 환경 변수 또는 settings.json에서 SLACK_BOT_TOKEN과 SLACK_APP_TOKEN을 설정하십시오.
시간 인식 (Time Awareness): 메시지 시간 접두사 (prefixes)를 통해 에이전트가 지연 시간과 일일 패턴을 이해할 수 있도록 돕습니다.
독립적인 스레드 세션 (Independent Thread Sessions): 각 Discord 스레드는 메인 채널로부터 완전히 격리된 고유의 Claude CLI 세션을 가집니다.
병렬 처리 (Parallel Processing): 스레드 대화는 동시에 실행됩니다. 서로 다른 스레드의 메시지는 서로를 차단하지 않습니다.
자동 생성 (Auto-Create): 새 스레드의 첫 번째 메시지는 자동으로 새로운 세션을 부트스트랩 (bootstrap) 합니다. 별도의 설정이 필요하지 않습니다.
세션 정리 (Session Cleanup): 스레드가 삭제되거나 보관 처리될 때 스레드 세션은 자동으로 정리됩니다.
하위 호환성 (Backward Compatible): DM(Direct Message) 및 메인 채널 메시지는 계속해서 글로벌 세션을 사용합니다.
기술적인 세부 사항은 docs/MULTI_SESSION.md를 참조하세요.
GLM 폴백 (GLM Fallback): 기본 제한(limit)에 도달하면 자동으로 GLM 모델로 계속 진행합니다.
웹 대시보드 (Web Dashboard): 작업(job)을 관리하고, 실행을 모니터링하며, 로그를 실시간으로 검사할 수 있습니다.
보안 수준 (Security Levels): 읽기 전용부터 전체 시스템 액세스까지 네 가지 액세스 수준을 제공합니다.
모델 선택 (Model Selection): 작업 부하(workload)에 따라 모델을 전환할 수 있습니다.
ClaudeClaw가 <무언가>를 할 수 있나요?
Claude Code가 할 수 있는 것이라면, ClaudeClaw도 할 수 있습니다. ClaudeClaw는 그 위에 크론 잡 (cron jobs), 하트비트 (heartbeats), 그리고 Telegram/Discord/Slack 브릿지 (bridges) 기능을 추가합니다. 또한 ClaudeClaw에 새로운 기술을 부여하거나 커스텀 워크플로 (custom workflows)를 가르칠 수도 있습니다.
이 프로젝트가 Anthropic의 이용 약관 (ToS)을 위반하나요?
아니요. ClaudeClaw는 Claude Code 생태계 내부에서의 로컬 사용입니다. Claude Code를 직접 래핑 (wrap) 하며, 해당 흐름 외부의 제3자 OAuth를 요구하지 않습니다. 동일한 작업을 수행하기 위해 직접 스크립트를 작성하더라도 결과는 같습니다.
Anthropic이 ClaudeClaw를 만든 것에 대해 소송을 제기할까요?
그러지 않기를 바랍니다.
이 프로젝트의 이름을 변경할 준비가 되셨나요?
만약 Anthropic이 불편해한다면, 이름을 OpenClawd로 변경할 수도 있습니다. 아직 확실하지는 않습니다.
ClaudeClaw를 더 좋게 만드는 데 도움을 주셔서 감사합니다.
AI 자동 생성 콘텐츠
본 콘텐츠는 GitHub AI Coding Assistants의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기