오픈클로(OpenClaw)란? 설치·채널 연결·모델·보안까지 보는 AI 에이전트 가이드

오픈클로(OpenClaw)는 채팅창에서 답변만 받는 앱이라기보다, 사용자가 관리하는 컴퓨터나 서버에 AI 에이전트를 두고 메시징 채널·모델·파일·도구를 연결하는 셀프 호스팅 Gateway에 가깝습니다.[1] 따라서 설치 명령보다 먼저 ‘어떤 채널에서 누구의 메시지를 받고, 어떤 도구 권한을 줄 것인가’를 정해야 합니다. 아래 내용은 기존 글에 기록된 2026년 9월 6일 공식 문서·저장소 확인 범위를 기준으로 하며, 실제 성능이나 안정성을 시험했다는 뜻은 아닙니다.

오픈클로의 구조를 간단히 이해하기

구조는 다음처럼 생각하면 됩니다.

1. Telegram·Discord·WhatsApp·Slack 같은 채널에서 메시지가 들어옵니다.[1][2]
2. Gateway가 세션과 라우팅을 관리해 어느 에이전트에 보낼지 정합니다.
3. 선택한 모델이 답변을 만들고 필요하면 브라우저·파일·셸 같은 도구를 호출합니다.
4. 결과가 원래 채널로 돌아갑니다.

공식 저장소는 OpenClaw를 사용자의 장치에서 실행하며 모델, 도구, 메시징 채널, 보조 앱을 하나의 Gateway로 연결하는 AI 비서로 설명합니다.[2] 장점은 특정 모델 하나보다 연결성과 실행 권한을 한곳에서 다룬다는 데 있습니다. 다만 셀프 호스팅이라고 모든 정보가 외부로 나가지 않는다는 뜻은 아닙니다. 호스팅 API를 쓰면 대화나 도구 실행에 필요한 정보가 해당 제공자에게 전달될 수 있고, 로컬 모델을 연결하면 직접 운영 부담이 생깁니다.[1][3]

Gateway·채널·에이전트

Gateway는 세션·라우팅·이벤트·채널 연결을 담당하는 로컬 제어 평면입니다. Control UI·CLI·TUI와 채널 플러그인이 Gateway에 연결됩니다.[1][2] 기본 Control UI 주소로 http://127.0.0.1:18789/가 안내되는데, 이는 같은 컴퓨터에서 관리 화면을 여는 기본값이지 인터넷 공개 주소가 아닙니다.[1]

공식 채널 문서에는 Discord, Feishu, iMessage, Matrix, Microsoft Teams, Signal, Slack, Telegram, WhatsApp, Zalo 등이 나옵니다.[4] Telegram은 봇 토큰 방식이고 WhatsApp은 QR 페어링과 로컬 상태 저장이 필요하므로 채널마다 설정과 보안 검토가 다릅니다. 여러 채널을 한꺼번에 연결하기보다 하나를 먼저 붙여 흐름을 확인하세요.

다중 에이전트와 세션 격리는 개인 업무·팀 업무·프로젝트별 파일과 모델을 나누는 데 유용할 수 있습니다.[1] 하지만 팀원을 초대하는 순간 같은 Gateway와 도구 권한을 공유해도 되는지 판단해야 합니다. 기능이 있다는 사실만으로 안전한 멀티테넌트 환경이 보장되지는 않습니다.

모델 선택 기준

오픈클로는 특정 모델 하나에 고정되지 않고 OpenAI·Anthropic 같은 호스팅 제공자와 OpenAI 호환 로컬 서버를 연결하는 방식을 다룹니다.[3] 로컬 경로로 LM Studio, vLLM, LiteLLM, llama.cpp 계열 서버를 등록할 수 있지만, 오픈클로가 모델을 대신 실행하는 것은 아닙니다.[3]

로컬 모델을 연결했다고 도구 사용 품질이나 ChatGPT급 결과가 자동으로 보장되지는 않습니다. 함수 호출, 긴 문맥, 출력 형식, 도구 선택, 서버의 API 호환성을 작업별로 확인해야 합니다.[3]

설치 흐름과 시작 전 준비

공식 설치 문서는 macOS·Linux·Windows를 지원하고 Node.js 런타임과 설치 경로를 안내합니다.[2][5] 기존 글에서 기록한 2026년 9월 6일 기준 저장소 최신 릴리스는 2026.9.2입니다.[6] 릴리스와 Node.js 요구사항은 바뀔 수 있으므로 설치 직전에 공식 문서를 다시 열어 보세요.

# macOS / Linux / WSL2
curl -fsSL https://openclaw.ai/install.sh | bash

# Windows PowerShell
iwr -useb https://openclaw.ai/install.ps1 | iex

공식 문서와 저장소는 Node.js 버전 및 npm lifecycle script 허용 조건도 설명합니다.[2][5] 설치 후에는 온보딩으로 모델·워크스페이스·Gateway를 설정하고 다음과 같은 상태 확인 흐름을 사용합니다.

openclaw onboard --install-daemon
openclaw gateway status
openclaw dashboard

설치 직후 외부 채널부터 연결하지 마세요. 먼저 Control UI에서 짧은 메시지에 모델이 응답하는지 확인하고, Gateway를 로컬에 둔 채 채널 하나와 pairing을 설정하는 순서가 안전합니다.[5]

보안 설정은 설치와 동시에

OpenClaw는 메시지에 답하는 것을 넘어 호스트 도구를 호출할 수 있으므로 외부 메시지를 신뢰하지 않는 입력으로 취급해야 합니다.[7][8]

DM 접근 제한

알 수 없는 발신자가 DM을 보낼 수 있는 채널은 pairing과 허용 목록으로 접근 대상을 좁히세요. 그룹 대화는 멘션이 있을 때만 응답하도록 하는 식으로 범위를 줄일 수 있습니다.[7]

Gateway를 바로 공개하지 않기

127.0.0.1에 묶인 Gateway와 인터넷에 노출된 Gateway의 위험은 다릅니다. 외부 접속이 필요하다면 토큰 인증, 네트워크 접근 제어, 암호화된 VPN·Tailnet·SSH 같은 경로를 함께 설계하세요. 포트 하나를 그대로 공개하는 방식은 피해야 합니다.[1][7]

도구 권한 최소화

모델 능력이 높다고 셸·파일 삭제·브라우저 권한까지 줘도 안전하다는 뜻은 아닙니다. 처음에는 파일 쓰기·셸·브라우저를 끄거나 읽기 전용 작업 디렉터리만 사용하고, 삭제·전송·구매·계정 변경은 사람 승인을 거치도록 하세요.[2][7]

샌드박스의 실제 설정 확인

샌드박스 문서는 컨테이너 네트워크, 마운트 경로, 환경 변수와 비밀값에 별도 주의가 필요하다고 설명합니다.[8] 샌드박스를 켰다는 표시만으로 호스트 파일·네트워크·토큰 접근이 모두 차단됐다고 가정하지 말고, 이미지·네트워크 정책·마운트·로그에 비밀값이 남는지 확인하세요.

권장 시작 순서

1. 별도 사용자 계정이나 전용 컴퓨터에 설치합니다.
2. 호스팅 모델 하나로 Control UI 응답만 확인합니다.
3. loopback·토큰 인증·DM pairing·허용 목록을 설정합니다.
4. Telegram 등 채널 하나만 연결합니다.
5. 일정 요약·파일 목록·문서 검색처럼 되돌릴 필요가 적은 읽기 작업부터 시킵니다.
6. 세션과 도구 호출 로그를 확인합니다.
7. 필요할 때만 쓰기·셸·브라우저 권한을 단계적으로 추가합니다.
8. 로컬 모델을 연결한다면 같은 작업의 속도·오류·도구 호출을 별도로 비교합니다.

이 순서는 공식 성능 보장 절차가 아니라 권한을 한 번에 넓히지 않기 위한 운영 권장안입니다. 장비·모델·채널·네트워크·작업에 따라 결과가 달라집니다.

어떤 사용자에게 맞을까요?

집이나 사무실의 장비를 계속 켜 둘 수 있고, API 비용과 데이터 흐름, 파일·셸 권한을 직접 관리할 사람에게 적합합니다. 반대로 설치 후 별도 설정 없이 모든 일을 안전하게 맡기고 싶다면 관리 부담이 맞지 않을 수 있습니다. 오픈클로의 핵심은 모델 이름보다 운영 구조와 권한 경계입니다.

시작 전 체크리스트

• Gateway를 실행할 장비와 백업 위치를 정했나요?
• 모델 제공자와 외부 전송 범위를 확인했나요?
• 채널 계정과 DM pairing·허용 목록을 설정했나요?
• Gateway를 인터넷에 직접 공개하지 않았나요?
• 파일·셸·브라우저에 최소 권한만 주었나요?
• 샌드박스의 네트워크·마운트·환경 변수를 확인했나요?
• 되돌릴 수 없는 작업에 사람 승인 절차를 두었나요?

자주 묻는 질문

오픈클로는 ChatGPT 같은 챗봇인가요?

전용 대화 앱 하나라기보다 Gateway를 중심으로 채널·모델·도구를 연결하는 셀프 호스팅 AI 자동화 구조에 가깝습니다.[1][2]

로컬 모델이면 데이터가 절대 외부로 나가지 않나요?

로컬 서버 경로는 외부 모델 API 전송을 줄일 수 있지만, 채널·도구·로그·네트워크 설정을 따로 확인해야 합니다. 자동으로 완전한 비공개가 되는 것은 아닙니다.[3]

설치 후 모든 채널을 연결해도 되나요?

채널마다 토큰·QR 페어링·발신자 정책이 다릅니다. Control UI와 채널 하나를 먼저 확인한 뒤 범위를 넓히세요.[5][4]

샌드박스만 켜면 안전한가요?

아닙니다. 네트워크·마운트·환경 변수·브라우저 프로필과 도구 권한을 실제 설정으로 점검해야 합니다.[8]

운영 전에 정할 정책

개인용으로 시작해도 메시지 보관 기간, 로그에 남겨도 되는 정보, API 키 저장 위치, 작업 실패 시 알림 대상을 정해 두세요. 가족이나 팀원이 같은 채널을 쓰면 발신자별 세션과 파일 범위를 분리하고, 누가 어떤 도구를 호출했는지 확인할 로그를 남겨야 합니다. 운영자가 자리를 비운 동안 자동 실행되는 작업은 예약 주기와 중지 방법을 문서로 적어 두는 편이 좋습니다.

채널 연결이 끊기거나 모델 제공자가 응답하지 않을 때도 파일 삭제나 외부 전송이 계속되지 않도록 시간 제한과 실패 시 중지 정책을 마련하세요. 이런 운영 규칙은 OpenClaw가 자동으로 정해 주는 기능이 아니라 설치자가 구성해야 할 경계입니다.

관련 글: AI 에이전트 도구 호출을 안전하게 설계하는 법, 멱등성·재시도·병렬화 기준

Sources

• [1] OpenClaw 공식 문서 개요
• [2] OpenClaw 공식 GitHub 저장소
• [3] OpenClaw 모델 제공자 문서
• [4] OpenClaw 채널 문서
• [5] OpenClaw 설치 문서
• [6] OpenClaw 최신 릴리스
• [7] OpenClaw 보안 문서
• [8] OpenClaw 샌드박싱 문서