AlphaClaw

AlphaClaw란?

AlphaClaw는 OpenClaw 에이전트를 플릿으로 배포·실행·모니터링하는 오픈소스 “OpenClaw 하네스 및 플릿 매니저”입니다. 핵심 목적은 중앙 집중식 오케스트레이션과 운영 제어를 제공하여 한 번 배포한 후 자동 복구와 지속적 헬스 모니터링으로 에이전트를 계속 실행할 수 있게 하는 것입니다.

OpenClaw CLI를 래핑하며 셀프 힐링 워치독 아래 게이트웨이 라이프사이클을 관리합니다. 프로젝트는 브라우저 기반 도구(대시보드, 터미널, 파일 브라우징)와 버전 관리, 프롬프트 강화, 채널 오케스트레이션을 위한 워크플로우 헬퍼를 제공합니다.

주요 기능

• 셀프 힐링 워치독 (크래시 감지 및 복구): 크래시 감지 및 크래시 루프 복구, openclaw doctor --fix를 사용한 자동 수리, Telegram·Discord·Slack 알림 지원.
• 시간별 자동 Git 백업 (커밋): 각 에이전트 워크스페이스를 GitHub에 시간별 자동 커밋하여 에이전트 작업과 변경 사항을 버전 관리 및 감사 가능하게 함.
• 설치 UI (브라우저 대시보드): 프로바이더와 채널 온보딩 및 설정을 위한 웹 인터페이스 제공, 수동 설정 파일 의존도 최소화.
• 멀티 에이전트 관리: 에이전트 생성·이름 변경·삭제; 에이전트별 개요 카드 보기; 에이전트별 채널 바인딩; 격리된 워크스페이스 사용.
• Drift Doctor 프롬프트 강화: 메시지에 안티 드리프트 프롬프트 강화를 주입하여 안전한 관행과 커밋 규율을 강제.
• 웹 터미널 및 파일 탐색기: 브라우저에서 게이트웨이 출력 모니터링 및 명령 실행을 위한 실시간 인터랙티브 터미널, diff 뷰와 동기화 지원 Git 인식 파일 탐색기.
• 웹훅 (변환 모듈 및 로깅): 이름 지정 엔드포인트, 요청 로깅, 페이로드 검사, OAuth 콜백 처리 지원.
• Cron 가시성: 인터랙티브 실행 이력 캘린더, 실행 상세 분석, 트렌드 분석, 실행별 사용량 분석 제공.

AlphaClaw 사용 방법

1. AlphaClaw 배포: 사이트에 설명된 지원 옵션 중 하나 사용: macOS 다운로드, 원클릭 템플릿 (Railway), Render 배포, Docker 또는 CLI 자가 호스팅, 로컬 설정.
2. 로컬 하네스 시작 (예시처럼) 제공 명령어 (예: npx alphaclaw start)로 Setup UI 실행 및 OpenClaw 게이트웨이 시작.
3. Setup UI 사용: 프로바이더/채널 온보딩 및 설정 후 필요에 따라 에이전트 생성 및 채널 바인딩.
4. 대시보드를 통해 운영: SSH 없이 모니터링 및 빠른 조정을 위한 웹 터미널과 파일 탐색기 사용.
5. 에이전트 지속 실행: AlphaClaw 워치독이 헬스 모니터링 및 크래시 루프 복구/자동 수리 수행. Git 백업과 드리프트 강화로 작업 버전 관리 및 메시지 일관성 유지.

사용 사례

• 수동 개입 없이 장기 실행 에이전트 운영: 워치독이 헬스 모니터링, 크래시 감지, 복구/자동 수리를 수행하며 여러 OpenClaw 에이전트 지속 실행.
• 감사 가능한 변경이 필요한 팀 워크플로우: 에이전트 워크스페이스를 GitHub에 시간별 자동 Git 커밋하여 변경 및 작업 버전 관리.
• 채널 기반 에이전트 배포 (Telegram/Discord/Slack): 에이전트에 특정 채널 바인딩 후 오케스트레이션 위저드(멀티스레드 Telegram 토픽 포함)로 요청 적절한 에이전트 라우팅.
• 브라우저 기반 디버깅 및 모니터링: 웹 터미널로 게이트웨이 출력 관찰 및 명령 실행, 파일 탐색기/diff 뷰로 SSH 없이 업데이트 생성 및 검토.
• 웹훅 엔드포인트 API 통합: 변환 모듈이 있는 이름 지정 웹훅 엔드포인트 정의, 요청 로깅으로 페이로드 검사, 호환 통합을 위한 OAuth 콜백 플로우 지원.

자주 묻는 질문

• AlphaClaw는 오픈소스인가요? 네. 사이트에서 “Open source”라고 명시하며 AlphaClaw를 오픈소스로 설명합니다.

• AlphaClaw로 에이전트 관리에 SSH 액세스가 필요한가요? 기능 세트가 “SSH 불필요, 설정 파일 불필요”를 강조하며 브라우저 기반 터미널/파일 도구로 모니터링 및 작업 제공.

• AlphaClaw는 실패 후 에이전트를 어떻게 유지하나요? 크래시 감지 및 크래시 루프 복구를 위한 셀프 힐링 워치독 사용, openclaw doctor --fix를 통한 자동 수리 포함.

• 에이전트 워크스페이스 변경은 어떻게 추적되나요? AlphaClaw가 워크스페이스를 GitHub에 시간별 자동 커밋하여 작업 및 변경을 버전 관리 및 감사 가능하게 함.

• AlphaClaw의 drift hardening이란? Drift Doctor 기능이 메시지에 안티 드리프트 프롬프트 강화를 주입하고 안전한 관행 및 커밋 규율을 강제.

대안

• 플릿 매니저 없는 자체 호스팅 OpenClaw CLI: OpenClaw를 직접 실행할 수 있지만, 자체 오케스트레이션, 모니터링, 브라우저 기반 운영을 구축해야 하며(여기 설명된 셀프 힐링 하네스와 대시보드 기능은 사용할 수 없음).
• 일반 프로세스 매니저 (예: 컨테이너 오케스트레이션 + 헬스 체크): 컨테이너/프로세스 도구는 서비스 재시작과 헬스 모니터링을 할 수 있지만, 일반적으로 Drift Doctor, Git 인식 워크스페이스 브라우징/디핑, 또는 제공자/채널 설정 UI 같은 OpenClaw 전용 기능은 제공하지 않습니다.
• 커스텀 웹훅/오케스트레이션 + Git 기반 로깅: 웹훅을 구현하고 Git으로 버전 관리를 할 수 있지만, 플릿 수준 에이전트 관리, 크래시 복구 자동화, 통합 대시보드 경험을 재구현해야 합니다.
• 기타 에이전트 관리 대시보드 (카테고리: agent ops/모니터링 플랫폼): 중앙화된 뷰와 운영 제어를 원한다면, 모니터링과 라우팅을 제공하는 agent ops 도구를 선택하세요; 셀프 힐링 복구, 워크스페이스 버전 관리, OpenClaw 전용 워크플로 지원 여부를 비교하세요.