OpenClaw는 셀프 호스팅 방식의 AI 에이전트 게이트웨이다. 로컬 머신이나 서버에 설치해서, WhatsApp/Telegram/Discord/Slack/iMessage 등 다양한 메신저를 AI 모델과 연결해주는 브릿지 역할을 한다. MIT 라이선스 오픈소스 프로젝트로, 데이터를 외부 서비스에 넘기지 않고 직접 통제할 수 있다는 게 핵심이다.
공식 문서: https://docs.openclaw.ai
기본 구조
OpenClaw의 핵심은 Gateway 프로세스다. 이 프로세스 하나가 여러 채널(메신저)과 AI 모델 사이의 라우팅, 세션 관리, 도구 실행을 모두 처리한다. 사용자가 텔레그램에서 메시지를 보내면, Gateway가 받아서 AI 모델에 전달하고, 응답을 다시 텔레그램으로 보내주는 구조다.
설정 파일은 ~/.openclaw/openclaw.json에 위치하며, 채널별 접근 제어, 모델 선택, 도구 권한 등을 JSON 형식으로 관리한다.
지원 채널
현재 공식 문서에 명시된 채널 목록:
- WhatsApp -- Baileys 라이브러리 기반, QR 코드 페어링 필요
- Telegram -- grammY 기반 Bot API, 그룹 지원
- Discord -- Discord Bot API + Gateway
- Slack -- Bolt SDK 기반
- iMessage -- BlueBubbles macOS 서버 연동 (권장) 또는 레거시 imsg CLI
- IRC -- 채널 + DM
- Signal -- signal-cli 기반
- LINE, Matrix, Nostr, Twitch, Google Chat, Microsoft Teams, Mattermost, Feishu 등은 플러그인으로 지원
여러 채널을 동시에 운영할 수 있고, OpenClaw가 채팅별로 자동 라우팅한다.
지원 모델
Anthropic Claude 시리즈가 권장 모델이다. Claude Opus 4.6, Sonnet, Haiku 등을 사용할 수 있으며, OpenAI GPT 시리즈, MiniMax 등 다른 프로바이더도 설정 가능하다. 모델은 에이전트별, 서브에이전트별로 다르게 지정할 수 있다.
주요 기능
도구 (Tools)
에이전트가 사용할 수 있는 내장 도구가 다양하다:
- exec: 셸 명령어 실행
- read/write/edit: 파일 읽기, 쓰기, 편집
- web_search, web_fetch: 웹 검색 및 페이지 내용 추출
- browser: 브라우저 자동화 (스크린샷, 클릭, 입력 등)
- image: 이미지 분석
크론 작업 (Cron Jobs)
Gateway에 내장된 스케줄러로, 반복 작업을 설정할 수 있다. at (일회성), every (간격 반복), cron (크론 표현식) 세 가지 스케줄 방식을 지원한다. 작업은 ~/.openclaw/cron/jobs.json에 영구 저장되어 재시작해도 유지된다.
서브에이전트 (Sub-Agents)
메인 에이전트가 sessions_spawn 도구로 백그라운드 작업을 병렬 실행할 수 있다. 서브에이전트는 독립 세션에서 작동하고, 완료 후 결과를 메인 채팅에 리포트한다. 최대 동시 실행 수는 기본 8개.
메모리
에이전트가 대화 맥락을 기억하고 파일 기반으로 메모리를 관리할 수 있다.
멀티에이전트
여러 에이전트를 설정해서 역할별로 분리 운영이 가능하다. 예를 들어 researcher와 coder 에이전트를 따로 두고, 오케스트레이터가 작업을 분배하는 구조를 만들 수 있다.
설치 방법
요구사항: Node.js 22 이상, API 키 (Anthropic 권장)
# 1. 설치
npm install -g openclaw
# 2. 초기 설정 (API 키 입력 등)
openclaw setup
# 3. 게이트웨이 시작
openclaw gateway start
# 4. 브라우저에서 제어 UI 접속
# 기본: http://127.0.0.1:18789/
설치 후 제어 UI에서 채널 연결, 모델 설정 등을 할 수 있다. 원격 접속이 필요하면 Tailscale 연동도 지원한다.
설정 예시
{
"channels": {
"telegram": {
"enabled": true,
"botToken": "YOUR_BOT_TOKEN",
"dmPolicy": "pairing",
"allowFrom": ["123456789"]
}
}
}
정리
OpenClaw는 "개인용 AI 에이전트 인프라"라고 보면 된다. 메신저를 통해 AI와 대화하면서, 파일 편집, 웹 검색, 브라우저 자동화, 스케줄링까지 하나의 시스템에서 처리할 수 있다. 셀프 호스팅이라 데이터 통제가 가능하고, 오픈소스라 커스터마이징도 자유롭다.
다만 설치와 설정에 어느 정도 기술적 이해가 필요하고, Node.js 환경과 API 키 비용은 사용자가 직접 관리해야 한다.