Skip to main content

​
소개

OpenClaw Manager는 OpenClaw AI 봇 게이트웨이를 빠르게 배포하고 관리할 수 있는 크로스 플랫폼 시각화 관리 도구입니다.
  • 제로 설정 배포 — 단일 실행 파일, 모든 의존성 자동 설치
  • 웹 관리 인터페이스 — 브라우저에서 인스턴스 생성·시작/중지·삭제, 모델 전환
  • 멀티 채널 지원 — Telegram / Feishu / Discord
  • 멀티 모델 지원 — GPT-5 시리즈, Claude 4.6/4.6 시리즈, Gemini 시리즈, 자동 장애 조치 지원
  • 백그라운드 실행 — --daemon 모드 지원, SSH 연결 해제 영향 없음
  • 다국어 UI — 중국어 / English / 일본어

​
사전 준비

시작하기 전에 다음을 확인하세요:
  1. ElkAPI API Key 획득 ElkAPI 콘솔에 로그인하여 API 키(sk-로 시작)를 획득
  2. 메시지 플랫폼 Bot 생성 사용할 플랫폼에 따라 Bot 인증 정보를 사전에 준비(아래 채널 설정 섹션 참조)
팁: ElkAPI 계정이 없다면 먼저 ElkAPI에서 등록하고 API 키를 획득하세요.

​
1단계: 다운로드

GitHub Releases에서 플랫폼에 맞는 실행 파일을 다운로드:

​
2단계: 실행

​
Windows 배포

​
전제 조건

  • Windows 10/11 (64비트)
  • 관리자 권한 (Gateway 관리용 Windows 작업 스케줄러 등록에 필요)

​
시작 방법

첫 실행 시 다음이 자동으로 수행됩니다:
  • Node.js v22 확인 및 설치 (미설치 시 MSI 자동 다운로드 후 자동 설치)
  • OpenClaw CLI 설치 (npm install -g openclaw)
  • 브라우저 자동 열기로 관리 인터페이스 접속
관리자 권한으로 실행해야 합니다. 그렇지 않으면 Gateway 프로세스 관리를 위한 Windows 작업 스케줄러를 생성할 수 없습니다.

​
3단계: 관리 인터페이스 접속

프로그램 시작 후 웹 관리 인터페이스에 접속:
Linux 원격 접속: 127.0.0.1을 서버 IP로 대체하세요 (예: http://your-server-ip:51942)

​
4단계: 인스턴스 생성

웹 관리 인터페이스에서 + 새 인스턴스를 클릭하여 생성 시작:

​
4.1 인스턴스 이름 설정

인스턴스 이름을 입력 (영문자, 숫자, 밑줄, 하이픈만 가능, 1~64자).

​
4.2 AI 모델 선택

사용할 AI 모델을 선택하고 ElkAPI API Key (sk-로 시작)를 입력. 지원 모델:
모델 선택 추천:
  • 💰 가성비: claude-sonnet-4-6, gemini-3.1-flash-lite-preview
  • 🚀 고성능: gpt-5.5, claude-opus-4-6-20260320, gemini-3-pro-preview
  • ⚡ 빠른 응답: gemini-3.1-flash-lite-preview, claude-sonnet-4-6
장애 조치 모드를 선택하여 여러 백업 모델을 추가할 수도 있습니다. 기본 모델을 사용할 수 없는 경우 시스템이 자동으로 백업 모델로 전환합니다.

​
4.3 메시지 채널 설정

사용할 메시지 플랫폼을 선택하고 해당 튜토리얼을 따라 설정:

Telegram

BotFather로 Telegram 봇 생성

Feishu（飞书）

Feishu 기업 맞춤 앱 봇 생성

​
5단계: 페어링 코드 연결

인스턴스 생성·시작 후 페어링 코드로 사용자 연결을 완료:
  1. 사용자가 메시지 플랫폼에서 봇에게 아무 메시지 전송
  2. 봇이 8자리 페어링 코드 (예: DFE62DTD)로 응답
  3. 관리자가 웹 관리 인터페이스에서 해당 인스턴스의 “페어링 코드” 버튼 클릭
  4. 페어링 코드를 입력하고 “승인” 클릭
  5. 사용자가 봇을 정상적으로 사용 가능
팁: 페어링 코드는 Gateway 메모리에 저장되며 재시작 후 무효화됩니다. 코드가 만료되면 사용자에게 새 메시지를 보내도록 안내하면 새 코드를 받을 수 있습니다.

​
인스턴스 관리

관리 인터페이스에서 다음 작업을 수행할 수 있습니다:

​
포트 및 데이터

​
포트

​
데이터 디렉토리

​
자주 묻는 질문

​
Q1: Manager가 시작되지 않나요?

해결 방법:

​
Q2: openclaw 명령어를 찾을 수 없나요?

해결 방법:
  • 프로그램 시작 시 openclaw CLI를 자동 감지·설치합니다
  • 버전이 오래된 경우 (< 0.1.0) 자동 업데이트됩니다
  • 수동 설치: npm install -g openclaw@latest

​
Q3: 인스턴스 시작 후 “중지됨”으로 표시되나요?

해결 방법:
  • Gateway의 포트 바인딩에 몇 초가 소요되어 상태가 일시적으로 불일치할 수 있습니다
  • 페이지를 새로고침하여 최신 상태를 확인하세요
  • Gateway 로그 확인: ~/.openclaw-<인스턴스명>/logs/gateway.log

​
Q4: Feishu 봇이 응답하지 않나요?

해결 방법:
  1. 이벤트 구독에 im.message.receive_v1이 추가되어 있는지 확인
  2. 구독 방식이 “롱 커넥션”인지 확인
  3. 새 버전을 생성하고 게시했는지 확인 (권한/이벤트 변경 후 매번 재게시 필요)

​
Q5: 페어링 코드 승인에 실패했나요?

해결 방법:
  • Gateway가 실행 중인지 확인
  • 페어링 코드는 Gateway 메모리에 저장되며 재시작 후 무효화됩니다
  • 사용자에게 새 메시지를 보내도록 안내하여 새 페어링 코드를 획득하세요

​
Q6: API 사용량과 비용을 확인하려면?

ElkAPI 콘솔에 로그인하여 확인:
  • 📊 API 호출 통계
  • 💰 비용 상세
  • 📈 사용 추이 차트

​
지원 및 도움말

문제가 발생하면:

ElkAPI 시작하기

지금 ElkAPI에 등록하고 API 키를 획득하여 AI 봇을 배포하세요!