OpenClaw 🦞

OpenClaw

“EXFOLIATE! EXFOLIATE!” — 어딘가의 우주 바닷가재

WhatsApp, Telegram, Discord, iMessage 등을 연결하는 AI 에이전트용 범용 OS 게이트웨이.
메시지를 보내면 주머니 속 에이전트가 응답합니다. 플러그인으로 Mattermost 등을 추가할 수 있습니다.

  • 시작하기 — OpenClaw를 설치하고 몇 분 안에 Gateway를 실행합니다.
  • 마법사 실행 — openclaw onboard와 페어링 플로우로 가이드 설정을 진행합니다.
  • Control UI 열기 — 채팅, 설정, 세션을 위한 브라우저 대시보드를 실행합니다.

OpenClaw란?

OpenClaw는 WhatsApp, Telegram, Discord, iMessage 등 여러 채팅 앱을 Pi 같은 AI 코딩 에이전트에 연결하는 셀프 호스팅 게이트웨이입니다. 내 컴퓨터(또는 서버)에서 하나의 Gateway 프로세스를 실행하면, 메시징 앱과 언제나 사용 가능한 AI 어시스턴트를 잇는 다리가 됩니다.

누구를 위한 것인가요? 데이터 통제권을 포기하거나 호스팅 서비스에 의존하지 않으면서, 어디서든 메시지를 보낼 수 있는 개인 AI 어시스턴트를 원하는 개발자와 파워 유저를 위한 도구입니다.

무엇이 다른가요?

  • 셀프 호스팅: 내 하드웨어에서 실행하고, 내 규칙대로 운영
  • 멀티채널: 하나의 Gateway로 WhatsApp, Telegram, Discord 등을 동시에 서비스
  • 에이전트 네이티브: 도구 사용, 세션, 메모리, 멀티 에이전트 라우팅을 기본 지원
  • 오픈소스: MIT 라이선스, 커뮤니티 주도

무엇이 필요한가요? Node 24(권장) 또는 Node 22 LTS(22.16+, 호환용), 선택한 공급자의 API 키, 그리고 5분이면 됩니다. 최상의 품질과 보안을 위해 가장 강력한 최신 세대 모델을 사용하세요.

동작 원리

flowchart LR
  A["Chat apps + plugins"] --> B["Gateway"]
  B --> C["Pi agent"]
  B --> D["CLI"]
  B --> E["Web Control UI"]
  B --> F["macOS app"]
  B --> G["iOS and Android nodes"]

Gateway는 세션, 라우팅, 채널 연결의 단일 진실 공급원입니다.

주요 기능

  • 멀티채널 게이트웨이 — 하나의 Gateway 프로세스로 WhatsApp, Telegram, Discord, iMessage를 연결합니다.
  • 플러그인 채널 — 확장 패키지로 Mattermost 등을 추가합니다.
  • 멀티 에이전트 라우팅 — 에이전트, 워크스페이스, 발신자별로 격리된 세션을 제공합니다.
  • 미디어 지원 — 이미지, 오디오, 문서를 주고받을 수 있습니다.
  • Web Control UI — 채팅, 설정, 세션, 노드를 관리하는 브라우저 대시보드입니다.
  • 모바일 노드 — iOS/Android 노드를 페어링하여 Canvas, 카메라, 음성 워크플로우를 사용합니다.

빠른 시작

1단계: OpenClaw 설치

```bash
npm install -g openclaw@latest
```

2단계: 온보딩 및 서비스 설치

```bash
openclaw onboard --install-daemon
```

3단계: WhatsApp 페어링 및 Gateway 시작

```bash
openclaw channels login
openclaw gateway --port 18789
```

전체 설치 및 개발 환경 설정은 빠른 시작을 참고하세요.

대시보드

Gateway 시작 후 브라우저에서 Control UI를 엽니다.

OpenClaw

설정 (선택)

설정 파일은 ~/.openclaw/openclaw.json에 있습니다.

  • 아무것도 하지 않으면 OpenClaw는 RPC 모드의 내장 Pi 바이너리를 발신자별 세션으로 사용합니다.
  • 접근을 제한하려면 channels.whatsapp.allowFrom과 (그룹의 경우) 멘션 규칙으로 시작하세요.

예시:

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

여기서 시작하세요

  • 문서 허브 — 활용 사례별로 정리된 모든 문서와 가이드.
  • 설정 — 핵심 Gateway 설정, 토큰, 공급자 구성.
  • 원격 접속 — SSH 및 tailnet 접속 패턴.
  • 채널 — WhatsApp, Telegram, Discord 등 채널별 설정.
  • 노드 — 페어링, Canvas, 카메라, 기기 동작을 지원하는 iOS/Android 노드.
  • 도움말 — 일반적인 해결법과 문제 해결 안내.

더 알아보기

다음
Showcase
arrow_forward