본문으로 건너뛰기
실습하기

오픈소스 AI 에이전트 프레임워크, OpenClaw

오픈클로 로고

최근 AI 개발자 커뮤니티에서 가장 큰 주목을 받은 프로젝트는 오픈클로(OpenClaw)입니다. 여러 기술 매체에서 오픈클로가 깃허브(GitHub, 오픈소스 프로젝트 플랫폼)에서 가장 빠르게 좋아요 수가 증가한 AI 에이전트 프로젝트라고 소개하며 프로젝트의 빠른 성장세를 보도했습니다.

오픈클로는 오픈소스로 공개된 AI 에이전트 프레임워크(Framework, 소프트웨어 개발 환경)입니다. 단순히 대화만 하는 챗봇이 아니라, 외부 도구와 연결되고 여러 작업을 순차적으로 실행합니다. 예를 들어, 슬랙에서 고객 문의를 감지해 AI가 우선순위를 판단하고, 노션에서 관련 문서를 검색해 요약한 후, 다시 슬랙에 답변을 보내는 AI 에이전트를 OpenClaw로 구축할 수 있습니다.

최근 AI 트렌드가 "답변 생성"에서 "실행"으로 이동하면서 이러한 AI 에이전트 프레임워크의 중요성이 커지고 있습니다.

OpenClaw는 어떤 문제를 해결하나요?​

AI 에이전트를 직접 구현하는 것은 생각보다 복잡합니다. 모델 선택, 프롬프트 설계, 도구 연결, OAuth 인증, 권한 제어, 채널별 API 차이까지 모두 고려해야 합니다. 데모는 빠르게 만들 수 있지만, 운영 단계로 가면 구조적 한계가 드러납니다.

OpenClaw는 AI 에이전트를 간편하게 설계하고 텔레그램, 슬랙, 노션과 같은 외부 서비스에 연동될 수 있게 함으로써 AI 에이전트 구축의 진입 장벽을 낮춥니다. 또한 채널 단위로 권한과 기능을 분리할 수 있는 구조를 제공해, 운영 단계에서 발생하는 보안 이슈와 관리 문제를 해결합니다.

OpenClaw의 특징​

오픈클로 대시보드

오픈클로 대시보드

1) 채널 중심 설계​

OpenClaw에서 말하는 '채널'은 사용자가 에이전트와 상호작용하는 접점입니다. AI 에이전트와 사용자가 메시지를 주고받는 공간이라고 이해하면 됩니다.

OpenClaw는 별도의 AI 전용 앱을 만드는 대신, 이미 사용 중인 채널 안에서 에이전트가 동작하도록 설계되어 있습니다. 따라서 사용자는 새로운 UI에 적응할 필요 없이, 익숙한 슬랙, 텔레그램, 노션 등에서 AI 에이전트와 상호작용할 수 있습니다.

연결 가능한 채널 예시는 다음과 같습니다.

  • 메신저: Slack, Telegram, Discord, Microsoft Teams
  • 협업 도구: Notion 댓글, Jira 이슈, GitHub PR 리뷰
  • 웹 인터페이스: SaaS 대시보드, 고객 포털, 사내 인트라넷
  • 시스템 이벤트: CRM 이벤트, 주문 알림, 서버 모니터링 Webhook

오픈클로 텔레그램 채널 연동

오픈클로 텔레그램 채널 연동


또한 채널 단위로 권한과 기능을 분리할 수 있습니다. 예를 들어 내부 Slack 채널에서는 사내 문서 검색을 허용하고, 외부 고객 채널에서는 읽기 전용 응답만 허용하도록 설정할 수 있습니다. 이와 같이 채널이 곧 AI 에이전트가 실행하는 경계가 됩니다.

2) 실행 환경 분리​

채널, 사용자 그룹, 세션에 따라 실행 환경을 분리할 수 있습니다. 내부 직원과 외부 사용자를 구분하거나, 테스트 환경과 운영 환경을 나누는 것이 가능합니다. 특정 채널에는 고성능 모델을 연결하고, 다른 채널에는 비용 효율 모델을 연결하는 방식도 지원합니다.

핵심은 에이전트의 접근 범위를 구조적으로 통제할 수 있다는 점입니다.

3) 다양한 AI 모델과의 호환성​

OpenClaw는 특정 모델에 종속되지 않습니다. OpenAI의 GPT, Anthropic의 Claude 등 다양한 AI 모델과 연결될 수 있습니다. 오픈클로 프레임워크는 에이전트 설계와 제어를 담당하고, AI 모델은 판단과 응답 생성을 담당합니다.

빠른 시작 가이드​

OpenClaw는 오픈소스이므로 누구나 설치해서 사용할 수 있습니다. 컴퓨터의 터미널(Terminal)에서 다음 명령어를 실행하면 설치가 가능합니다.

오픈클로 설치 및 실행
curl -fsSL https://openclaw.ai/install.sh | bash

Windows의 PowerShell, CMD에서는 설치 스크립트가 정상적으로 작동하지 않을 수 있습니다. Windows 사용자는 WSL(Windows Subsystem for Linux)을 설치한 후, WSL 터미널에서 위 명령어를 실행하는 것을 권장드립니다.

설치가 완료되면 로컬 또는 서버 환경에서 오픈클로 인스턴스를 실행할 수 있습니다. 이후 기본 대시보드에 접속해 다음 단계를 진행합니다.

  1. 사용할 AI 모델 API 키 등록
  2. 첫 번째 채널 생성 (예: Slack 또는 Telegram)
  3. 간단한 테스트 프롬프트 실행
  4. 실행 로그 확인

설치 직후 바로 할 수 있는 일은 다음과 같습니다.

  • Slack에 연결해 "사내 문서 요약 봇" 만들기
  • Telegram에 연결해 주기적으로 날씨 정보를 알려주는 봇 만들기
  • Webhook을 연결해 주문 이벤트 발생 시 자동 요약 생성
  • 특정 채널에만 접근 가능한 내부 에이전트 구성

설치 및 초기 설정에 대한 자세한 내용은 오픈클로 공식 문서를 참고하세요.

보안과 운영 리스크​

에이전트 구조를 운영 단계로 확장하면 반드시 고려해야 할 보안 이슈가 있습니다.

  • API 키 관리 : 모델 API 키와 외부 서비스 OAuth 토큰은 서버 환경에 안전하게 보관해야 하며, 외부 저장소에 노출되어서는 안 됩니다.

  • 권한 범위 제한 : 에이전트가 접근할 수 있는 데이터 범위를 최소화해야 합니다. 특히 고객 데이터나 내부 기밀 문서에 접근하는 채널은 별도로 격리하는 것이 좋습니다.

  • 프롬프트 인젝션 공격 : 외부 채널과 연결될 경우, 악의적인 사용자가 의도적으로 시스템 지시문을 변경하려는 입력을 보낼 수 있습니다. 이를 방지하기 위해 시스템 프롬프트 보호 구조와 실행 단계 검증 로직이 필요합니다.

  • 로그와 감사 추적 : 누가 어떤 명령을 실행했고, 어떤 데이터에 접근했는지 추적 가능해야 합니다. 이는 사고 발생 시 원인 분석에 필수적입니다.

오픈소스 프로젝트를 사용할 경우 보안 설정은 전적으로 운영자의 책임이 됩니다. 내부 서버에서 자체적으로 운영하는 셀프호스팅(Self-Hosting) 환경에서는 네트워크 접근 통제, 서버 방화벽 설정 등 기본적인 보안 구성을 반드시 갖추어야 합니다.

다음 내용이 궁금하다면?

코드프렌즈 PLUS 멤버십 가입 or 강의를 등록해 주세요!