OpenClaw란? 카톡·텔레그램으로 AI 에이전트를 부리는 셀프호스팅 게이트웨이

이 글부터 OpenClaw 공식 문서(docs.openclaw.ai)를 한 챕터씩 제 방식대로 풀어 설명하는 연재를 시작합니다. 문서를 그대로 번역해서 옮기는 게 아니라, 공식 문서 내용을 참고해서 한국 독자가 이해하기 쉽게 재구성하는 글입니다. 원문 출처는 글 맨 아래에 표기합니다.

OpenClaw는 한마디로 무엇인가

OpenClaw는 디스코드, 왓츠앱·텔레그램 같은 메신저, 시그널, 슬랙, 아이메시지 같은 채팅 앱을 하나의 ‘게이트웨이’ 프로세스로 연결해서, 그 채널로 AI 에이전트에게 메시지를 보내고 답을 받을 수 있게 해주는 셀프호스팅 소프트웨어입니다. 즉 채팅창에 메시지를 치면 그게 곧 AI 비서에게 보내는 업무 지시가 되는 구조입니다.

공식 소개 문구를 빌리면 “휴대폰에서 메시지 하나 보내면 에이전트 응답이 돌아온다”가 핵심 그림입니다. 서버나 노트북에 게이트웨이 프로세스 하나를 띄워두면, 그게 여러 채팅 채널·웹 채팅·모바일 노드를 동시에 받아주는 다리 역할을 합니다.

왜 그냥 챗봇 앱을 쓰면 안 되고 이런 게 필요한가

일반 AI 챗봇 앱과 다른 점은 크게 세 가지로 정리됩니다.

• 셀프호스팅 — 내 하드웨어에서 돌아가고 데이터도 내 손을 벗어나지 않습니다. 특정 회사의 호스팅 서비스에 대화 기록을 맡기고 싶지 않은 사람에게 맞는 구조입니다.
• 멀티채널 — 게이트웨이 하나가 여러 채팅 채널 플러그인을 동시에 서비스합니다. 텔레그램으로 물어봐도, 슬랙으로 물어봐도 같은 에이전트가 답합니다.
• 에이전트 네이티브 — 단순 대화만 하는 게 아니라 도구 사용(tool use), 세션 유지, 메모리, 여러 에이전트로 나눠 라우팅하는 기능까지 코딩 에이전트를 염두에 두고 설계돼 있습니다.

오픈소스(MIT 라이선스)로 공개돼 있어서, 개인이 노트북 한 대에서 개인 비서로 쓰는 것부터 팀 단위로 공유 배포하는 것까지 설정값만 다르게 하면 같은 게이트웨이로 커버됩니다.

구조를 그림으로 보면

공식 문서의 흐름도를 말로 풀면 이렇습니다.

• 채팅 앱과 채널 플러그인들이 게이트웨이로 메시지를 보내고
• 게이트웨이는 이 메시지를 OpenClaw 에이전트, CLI, 웹 Control UI, macOS 앱, iOS·안드로이드 노드 중 필요한 쪽으로 전달합니다

즉 게이트웨이가 세션 관리, 메시지 라우팅, 채널 연결 상태를 모두 쥐고 있는 단일 진실 공급원(single source of truth) 역할을 합니다. 어느 채널로 말을 걸어도 같은 세션 맥락을 유지할 수 있는 이유가 여기에 있습니다.

실제로 뭘 할 수 있나 (핵심 기능 요약)

• 멀티채널 게이트웨이: 디스코드, 아이메시지, 시그널, 슬랙, 텔레그램, 왓츠앱, 웹챗 등을 게이트웨이 하나로 동시에 운영
• 플러그인 채널: 매트릭스, 노스트, 트위치, 잘로 등은 플러그인 형태로 필요할 때 추가 설치
• 멀티 에이전트 라우팅: 에이전트·워크스페이스·발신자별로 세션을 분리
• 미디어 지원: 이미지, 오디오, 문서 파일 송수신
• 웹 Control UI: 브라우저에서 채팅·설정·세션·노드를 관리하는 대시보드
• 모바일 노드: iOS·안드로이드 기기를 페어링해서 카메라, 화면, 음성 기반 작업까지 연동

설치는 어느 정도 난이도인가

공식 문서 기준 최소 요구 사항은 Node.js 22.22.3 이상(권장은 최신 LTS 계열)과 사용하려는 AI 모델 제공사의 API 키, 그리고 5분 정도의 시간입니다. 설치 자체는 아래처럼 npm 명령 두 줄로 안내되어 있습니다.

npm install -g openclaw@latest --allow-scripts=openclaw
openclaw onboard --install-daemon

온보딩 명령을 실행하면 서비스가 백그라운드 데몬으로 설치되고, 이후 브라우저로 Control UI를 열거나(openclaw dashboard) 텔레그램 같은 채널을 바로 연결해서 휴대폰으로 대화를 시작할 수 있습니다. 기본 설정으로는 1:1 대화(DM)는 에이전트의 메인 세션을 같이 쓰고, 단체방은 방마다 별도 세션이 생깁니다.

설정을 더 손보고 싶다면

설정 파일은 ~/.openclaw/openclaw.json 하나에 모입니다. 아무것도 건드리지 않아도 기본 내장 에이전트로 바로 쓸 수 있고, 특정 번호만 받게 하거나 그룹방에서는 멘션이 있을 때만 반응하게 잠그고 싶다면 아래처럼 채널별 허용 목록과 멘션 규칙을 넣어주면 됩니다.

{
  channels: {
    whatsapp: {
      allowFrom: ["+15555550123"],
      groups: { "*": { requireMention: true } },
    },
  },
  messages: { groupChat: { mentionPatterns: ["@openclaw"] } },
}

이번 글 요약

• OpenClaw는 채팅 앱과 AI 에이전트 사이를 잇는 셀프호스팅 게이트웨이다
• 데이터를 내 서버·내 컴퓨터에 두면서 여러 채널을 동시에 하나의 에이전트로 운영할 수 있다는 게 핵심 차별점
• 설치는 npm 한 줄 + 온보딩 명령 한 줄 수준으로 안내되어 있다
• 다음 편에서는 설치 후 처음 마주치는 온보딩(openclaw onboard) 과정을 좀 더 자세히 다룰 예정

참고: 이 글은 OpenClaw 공식 문서(docs.openclaw.ai)의 소개 페이지 내용을 바탕으로 재구성한 설명 글입니다. 실제 설치·운용 화면은 버전에 따라 달라질 수 있으니, 최신 정보는 공식 문서를 함께 확인하세요.