OpenClaw로 나만의 AI 에이전트 게이트웨이 구축하기

평소에 사용하는 메신저에서 바로 AI 에이전트와 대화하고 싶을 때가 있죠. 하지만 매번 새로운 앱을 설치하거나 특정 웹사이트에 접속하는 것은 번거로운 일이에요. 특히 이동 중이거나 익숙한 채팅창을 떠나고 싶지 않을 때, 내가 가진 데이터를 직접 제어하면서 AI를 도구처럼 사용하기란 쉽지 않습니다.

이런 고민을 해결하기 위해 내 장비에서 직접 실행하고 제어할 수 있는 AI 게이트웨이가 필요합니다.

필요한 것

시작하기 전에 다음 항목들이 준비되었는지 확인해 주세요.

• Node 22 이상
• API key (Anthropic 권장)

What is OpenClaw?

OpenClaw는 WhatsApp, Telegram, Discord, iMessage 같은 채팅 앱을 Pi와 같은 AI 코딩 에이전트에 연결해 주는 Self-hosted gateway예요. 본인의 컴퓨터나 서버에서 Gateway 프로세스를 하나만 실행하면, 메시징 앱과 AI 어시스턴트를 이어주는 다리 역할을 합니다.

OpenClaw의 특징은 다음과 같아요.

• Self-hosted: 본인의 하드웨어에서 본인의 규칙대로 실행해요.
• Multi-channel: 하나의 Gateway가 WhatsApp, Telegram, Discord 등을 동시에 지원해요.
• Agent-native: 도구 사용, 세션, 메모리, 멀티 에이전트 라우팅을 지원하는 코딩 에이전트용으로 설계되었어요.
• Open source: MIT 라이선스를 따르는 커뮤니티 주도 프로젝트예요.

How it works

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는 세션, 라우팅, 채널 연결을 관리하는 단일 소스 역할을 합니다.

빠른 시작

5분 안에 Gateway를 설정하고 실행하는 방법이에요.

1. OpenClaw 설치

   npm install -g openclaw@latest

2. 온보딩 및 서비스 설치

   openclaw onboard --install-daemon

3. WhatsApp 페어링 및 Gateway 시작

   openclaw channels login
   openclaw gateway --port 18789

Gateway가 시작되면 브라우저에서 Control UI(http://127.0.0.1:18789/)를 열어 채팅과 세션을 관리할 수 있어요.

Configuration (선택 사항)

설정 파일은 ~/.openclaw/openclaw.json에 저장됩니다. 기본적으로 OpenClaw는 번들로 제공되는 Pi 바이너리를 RPC 모드로 사용해요. 특정 사용자만 접근하게 하거나 그룹 채팅 규칙을 정하고 싶다면 다음과 같이 설정할 수 있습니다.

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

문제 해결

설치나 실행 중에 문제가 생기면 다음 내용을 확인해 보세요.

• Gateway 진단: Gateway 실행 후 발생하는 일반적인 오류나 진단 정보는 Help 섹션에서 확인할 수 있어요.
• 연결 문제: 채널 로그인이 제대로 되지 않는다면 openclaw channels login 과정을 다시 확인해 주세요.

더 자세한 해결 방법이 필요하다면 프로젝트의 Help 페이지를 참고하시기 바랍니다.

---

궁금한 점이 있거나 설정에 도움이 필요하다면 AI Setup Assistant에게 물어보세요.

다음 단계

• Configuration: 핵심 Gateway 설정 및 provider 구성
• Remote access: SSH 및 tailnet 접속 패턴
• Channels: 채널별 상세 설정 (WhatsApp, Telegram 등)
• Nodes: iOS 및 Android 노드 페어링