AlphaClaw: OpenClaw를 위한 올인원 배포 및 관리 하네스

OpenClaw는 강력한 AI 에이전트 프레임워크다. 하지만 처음 설정할 때 복잡할 수 있다. 게이트웨이 설정, 채널 페어링, 환경 변수, 충돌 시 복구. SSH로 접속해서 로그를 확인하고, 수동으로 재시작하고, 설정 파일을 편집해야 한다면?

AlphaClaw가 이 문제를 해결한다. OpenClaw를 감싸는 “하네스(harness)“로, 설정 마법사, 셀프 힐링 워치독, Git 기반 롤백, 그리고 모든 것을 관리하는 브라우저 UI를 제공한다.

왜 AlphaClaw인가

기존 OpenClaw 배포의 어려움

• 수동 설정 - CLI로 게이트웨이 시작, 채널 페어링, 환경 변수 설정
• 충돌 복구 - SSH로 접속해서 로그 확인, 수동 재시작
• 관리 복잡도 - 설정 파일 직접 편집, 버전 관리 수동
• 관찰 가능성 부족 - 터미널 로그만으로 상태 파악

AlphaClaw의 접근

• 5분 내 첫 메시지 - 원클릭 배포, 설정 마법사
• 셀프 힐링 - 워치독이 충돌 감지, 자동 복구
• 브라우저 관리 - SSH 없이 모든 것을 UI로
• Git 기반 롤백 - 모든 변경사항 버전 관리

핵심 기능

Setup UI

비밀번호로 보호된 웹 대시보드:

• 온보딩 마법사 - 단계별 설정: 모델 선택, 제공자 자격증명, GitHub 저장소, 채널 페어링
• 게이트웨이 관리자 - OpenClaw 게이트웨이를 자식 프로세스로 스폰, 모니터링, 재시작, 프록시
• 채널 오케스트레이션 - Telegram, Discord 봇 페어링, 자격증명 동기화

Watchdog (셀프 힐링)

게이트웨이 상태를 모니터링하고 자동으로 복구:

Prompt Hardening

에이전트가 “흐트러지지 않도록(drift)” 방지하는 부트스트랩 프롬프트:

• AGENTS.md, TOOLS.md를 시스템 프롬프트에 주입
• 안전한 관행, 커밋 규율, 변경 요약 강제
• 기본적으로 에이전트 행동 규율 유지

Git Sync

OpenClaw 워크스페이스를 GitHub에 자동 커밋:

• 구성 가능한 cron 일정 (기본: 매시간)
• 프롬프트 하드닝과 결합하여 모든 에이전트 행동이 버전 관리되고 감사 가능

Google Workspace 통합

OAuth 통합으로 Gmail, Calendar, Drive, Docs, Sheets, Tasks, Contacts, Meet 관리:

• Gmail watch 설정 가이드
• Google Pub/Sub 토픽, 구독, 푸시 엔드포인트 처리

웹훅

명명된 웹훅 엔드포인트:

• 훅별 변환 모듈
• 요청 로깅
• 페이로드 검사
• Gmail watch 전달 플로우 포함

파일 탐색기

브라우저 기반 워크스페이스 탐색기:

• 파일 가시성
• 인라인 편집
• diff 보기
• Git 인식 동기화

SSH 없이 빠른 수정 가능.

UI 탭 구성

아키텍처

┌─────────────────────────────────────────┐
│ AlphaClaw                                │
│   ┌────────────────────────────────────┐ │
│   │ Setup UI (Preact + htm + Wouter)   │ │
│   │ Watchdog (Crash recovery)          │ │
│   │ Webhooks (Transforms, Logging)     │ │
│   └──────────────┬─────────────────────┘ │
│                  │                        │
│   ┌──────────────▼─────────────────────┐ │
│   │ Express Server                      │ │
│   │ (JSON APIs, Auth, Proxy)            │ │
│   └──────────────┬─────────────────────┘ │
└─────────────────┼───────────────────────┘
                  │ proxy
                  ▼
┌─────────────────────────────────────────┐
│ OpenClaw Gateway                         │
│ (Child process, 127.0.0.1:18789)        │
└──────────────┬──────────────────────────┘
               │
               ▼
┌─────────────────────────────────────────┐
│ ALPHACLAW_ROOT_DIR                       │
│ (.openclaw/, .env, logs, SQLite)        │
└─────────────────────────────────────────┘

AlphaClaw는 OpenClaw를 래핑만 한다. 의존성이 아니다. AlphaClaw를 제거해도 에이전트는 계속 실행된다. 독점적인 것도, 마이그레이션할 것도 없다.

배포

Railway

One-Click Deploy로 즉시 배포

Render

Render Template 사용

npm

npm install @chrysb/alphaclaw
npx alphaclaw start

Docker

FROM node:22-slim

RUN apt-get update && apt-get install -y git curl procps cron && rm -rf /var/lib/apt/lists/*

WORKDIR /app

COPY package.json ./
RUN npm install --omit=dev

ENV PATH="/app/node_modules/.bin:$PATH"
ENV ALPHACLAW_ROOT_DIR=/data

EXPOSE 3000

CMD ["alphaclaw", "start"]

환경 변수

CLI 명령어

보안 트레이드오프

AlphaClaw는 편의성을 위해 OpenClaw의 일부 기본 보안 강화를 완화한다:

OpenClaw의 완전한 보안 태세(수동 페어링 코드, 쿼리스트링 토큰 없음, 자동 승인 없음)가 필요하면 AlphaClaw 없이 OpenClaw를 직접 사용해야 한다.

마치며: “SSH 구조 임무 제로”

AlphaClaw의 태그라인이 마음에 든다:

“Zero SSH rescue missions.”

개발자가 SSH로 접속해서 로그를 확인하고, 수동으로 재시작하고, 설정 파일을 편집해야 하는 상황은 생산적이지 않다. AlphaClaw는 이 모든 것을 브라우저 UI로 해결한다.

특히 워치독이 인상적이다. 충돌을 감지하고, 자동으로 복구하고, 알림을 보낸다. 개발자가 개입할 필요 없이 시스템이 스스로 치유한다.

OpenClaw를 프로덕션에서 운영하려는 개발자라면, AlphaClaw를 고려해볼 만하다. 5분 만에 배포하고, 몇 달간 안정적으로 운영할 수 있다.

🔗 관련 정보

• GitHub: https://github.com/chrysb/alphaclaw
• npm: https://www.npmjs.com/package/@chrysb/alphaclaw
• Railway 배포: https://railway.com/deploy/openclaw-fast-start
• Render 배포: https://render.com/deploy?repo=https://github.com/chrysb/openclaw-render-template
• OpenClaw: https://github.com/openclaw/openclaw