메인 콘텐츠로 건너뛰기

​
OpenClaw 🦞

OpenClaw

“EXFOLIATE! EXFOLIATE!” — 어느 우주 바닷가재의 말, 아마도

WhatsApp, Telegram, Discord, iMessage 등을 통해 AI 에이전트에 접근할 수 있는 모든 OS용 게이트웨이.
메시지를 보내고, 주머니 속에서 바로 에이전트의 응답을 확인하세요. 플러그인을 통해 Mattermost 등을 추가할 수 있습니다.

시작하기

OpenClaw를 설치하고 몇 분 안에 게이트웨이를 실행하세요.

마법사 실행

openclaw onboard 및 페어링 플로우를 통한 단계별 설정 가이드.

제어 UI 열기

채팅, 설정 및 세션 관리를 위한 브라우저 대시보드를 실행하세요.

​
OpenClaw는 무엇인가요?

OpenClaw는 WhatsApp, Telegram, Discord, iMessage 등 평소 즐겨 사용하는 채팅 앱을 Pi와 같은 AI 코딩 에이전트에 연결해 주는 자체 호스팅 게이트웨이입니다. 자신의 컴퓨터(또는 서버)에서 단일 게이트웨이 프로세스를 실행하면, 메시징 앱과 언제나 사용 가능한 AI 어시스턴트를 이어주는 브리지가 됩니다. 누구를 위한 것인가요? 자신의 데이터를 직접 제어하면서 호스팅 서비스에 의존하지 않고 어디서나 메시지로 소통할 수 있는 개인용 AI 어시스턴트를 원하는 개발자와 파워 유저를 위해 만들어졌습니다. 무엇이 다른가요?
  • 자체 호스팅: 사용자의 하드웨어에서 사용자의 규칙에 따라 실행됩니다.
  • 멀티 채널: 하나의 게이트웨이로 WhatsApp, Telegram, Discord 등을 동시에 지원합니다.
  • 에이전트 네이티브: 도구 사용(Tool use), 세션, 메모리 및 멀티 에이전트 라우팅을 갖춘 코딩 에이전트 최적화 설계.
  • 오픈 소스: MIT 라이선스 기반의 커뮤니티 주도 프로젝트입니다.
무엇이 필요한가요? Node 22 이상, 선택한 제공업체의 API 키, 그리고 단 5분의 시간만 있으면 됩니다. 최상의 품질과 보안을 위해 사용 가능한 최신 세대의 가장 강력한 모델을 사용하는 것이 좋습니다.

​
작동 방식

게이트웨이는 세션, 라우팅 및 채널 연결을 관리하는 단일 진실 공급원(Single Source of Truth) 역할을 합니다.

​
주요 기능

멀티 채널 게이트웨이

단일 게이트웨이 프로세스로 WhatsApp, Telegram, Discord 및 iMessage를 지원합니다.

플러그인 채널

확장 패키지를 통해 Mattermost 등 더 많은 채널을 추가하세요.

멀티 에이전트 라우팅

에이전트, 워크스페이스 또는 발신자별로 격리된 세션을 제공합니다.

미디어 지원

이미지, 오디오 및 문서를 주고받을 수 있습니다.

웹 제어 UI

채팅, 설정, 세션 및 노드 관리를 위한 브라우저 대시보드.

모바일 노드

Canvas, 카메라 및 음성 지원 워크플로우를 위해 iOS 및 Android 노드를 페어링하세요.

​
빠른 시작

1

OpenClaw 설치

npm install -g openclaw@latest
2

온보딩 및 서비스 설치

openclaw onboard --install-daemon
3

WhatsApp 페어링 및 게이트웨이 시작

openclaw channels login
openclaw gateway --port 18789
전체 설치 및 개발 설정이 필요하신가요? 빠른 시작을 확인하세요.

​
대시보드

게이트웨이가 시작된 후 브라우저에서 제어 UI를 여세요.

OpenClaw

​
구성 (선택 사항)

설정 파일은 ~/.openclaw/openclaw.json에 위치합니다.
  • 별도의 설정을 하지 않으면 OpenClaw는 발신자별 세션이 있는 RPC 모드에서 내장된 Pi 바이너리를 사용합니다.
  • 보안을 강화하려면 channels.whatsapp.allowFrom 및 그룹 채팅을 위한 멘션 규칙 설정을 권장합니다.
예시: 
{
  channels: {
    whatsapp: {
      allowFrom: ["+15555550123"],
      groups: { "*": { requireMention: true } },
    },
  },
  messages: { groupChat: { mentionPatterns: ["@openclaw"] } },
}

​
여기서 시작하세요

문서 허브

사용 사례별로 정리된 모든 문서와 가이드를 확인하세요.

구성

핵심 게이트웨이 설정, 토큰 및 제공업체 구성 방법.

원격 액세스

SSH 및 Tailscale 액세스 패턴 가이드.

채널

WhatsApp, Telegram, Discord 등을 위한 채널별 상세 설정.

노드

페어링, Canvas, 카메라 및 장치 제어 기능이 있는 iOS 및 Android 노드.

도움말

일반적인 문제 해결 및 진입점 안내.

​
더 알아보기

전체 기능 목록

채널 지원, 라우팅 및 미디어 기능의 전체 목록.

멀티 에이전트 라우팅

워크스페이스 격리 및 에이전트별 개별 세션 관리.

보안

토큰, 허용 목록(Allowlist) 및 안전 제어 옵션.

문제 해결

게이트웨이 자가 진단 및 일반적인 오류 해결 방법.

정보 및 크레딧

프로젝트의 기원, 기여자 및 라이선스 정보.