가상 비서 OpenClaw (구 Clawdbot/MoltBot) 실행하기

OpenClaw는 능동적인 AI 비서를 구축할 수 있게 해주는 오픈 소스 프레임워크입니다. 이 비서는 단순히 채팅만 하는 것이 아니라, 실제로 작업을 수행할 수 있습니다. 명령을 실행하고, 파일을 편집하고, API를 호출하며, Telegram, WhatsApp, Slack과 같은 메시징 앱을 통해 스스로 작동할 수 있습니다.

이 프로젝트는 Clawdbot 및 MoltBot으로도 알려져 있었습니다. 시간이 지나면서 이름이 바뀌었지만, 핵심 기술은 동일합니다. 현재 활발히 유지보수되고 있는 이름은 OpenClaw입니다.

이 가이드는 설정 과정을 단계별로 안내합니다. 설정에는 시간이 다소 걸리지만, 마치 작업 흐름의 실제 일부처럼 느껴지는 비서를 얻게 될 것입니다.

💡

맞춤형 API(예: 날씨, 캘린더 또는 자체 서비스)로 OpenClaw를 확장할 때, Apidog를 사용하여 API를 한 곳에서 설계, 목업, 테스트, 디버깅 및 문서화하세요. 백엔드 및 풀스택 개발자는 도구를 전환할 필요 없이 사양에서 작동하는 클라이언트 코드로 이동할 수 있습니다. Apidog를 무료로 사용해보고 API 워크플로우를 단일 플랫폼에서 유지해 보세요.

버튼

OpenClaw/Clawdbot/MoltBot이란 무엇인가요?

OpenClaw는 주요 오픈 소스 프로젝트입니다. Clawdbot은 최초의 인기 릴리스였으며, MoltBot은 리브랜딩 기간 동안 잠시 사용되었던 이름입니다. 오늘날, 'OpenClaw', 'Clawdbot', 'MoltBot' 중 어느 것을 보더라도 이들은 모두 여러분의 기기에서 실행하는 동일한 종류의 가상 비서를 의미합니다.

기능: 이는 여러분(메시징 앱을 통해)과 대규모 언어 모델(일반적으로 Claude) 사이에 위치합니다. 여러분이 메시지를 보내면, 에이전트가 이를 해석하고, 단계를 계획하며, 브라우저 열기, 파일 편집, 이메일 전송, 스크립트 실행 등 다양한 작업을 수행합니다.

사람들이 사용하는 이유:

로컬에서 실행 — 데이터가 사용자 기기에 유지되어 제어권과 프라이버시를 보장합니다.
맥락 기억 — 세션 간에 대화 기록을 유지합니다.
능동적인 기능 — 스케줄 또는 트리거에 따라 작동하도록 스크립트를 작성할 수 있습니다.
채팅 우선 — Telegram, WhatsApp, Slack 등을 통해 상호 작용하므로 새로운 UI를 배울 필요가 없습니다.

중요: 에이전트가 명령을 실행하고 시스템에 접근할 수 있으므로 보안이 중요합니다. 가능하면 컨테이너 또는 VM에서 실행하고, 주 컴퓨터에 전체 접근 권한을 부여하지 마세요.

가상 비서로 OpenClaw를 실행하기 위한 전제 조건

설치 전에 환경을 준비하세요. 가상 비서로서의 Clawdbot 또는 가상 비서로서의 MoltBot은 동일한 요구 사항을 따릅니다.

하드웨어: 항상 켜져 있는 전용 기기(PC, Mac, Raspberry Pi 또는 VPS). 진정한 능동성을 위해 24/7 실행되는 기기를 사용하세요. 최소 사양에는 8GB RAM, 멀티코어 CPU, 안정적인 인터넷이 포함됩니다.
운영 체제: macOS, Linux (Ubuntu/Debian 권장) 또는 Windows (최상의 결과를 위해 WSL 사용).
의존성: Node.js (v18+), npm/yarn, Git, Docker (선택 사항이지만 격리를 위해 권장).
API 키: Anthropic API 키(Claude 모델용) 또는 OpenAI/Groq 등에서 제공하는 동등한 키. 에이전트 작업은 토큰을 빠르게 소모하므로 사용량 예산을 고려하세요.
메시징 앱: WhatsApp Business API, Telegram 봇 토큰, Slack 앱, Discord 봇 등.
보안 의식: 컨테이너 또는 VM에서 실행하세요. 기본 워크스테이션에서 무제한 접근 권한을 부여하지 마세요.

Node.js와 Git이 없다면 먼저 설치하세요.

OpenClaw 실행 방법

1단계: OpenClaw 설치

공식 저장소를 클론합니다 (또는 최신 포크는 openclaw.ai에서 확인하세요):

git clone https://github.com/moltbot/moltbot.git

cd moltbot

그 다음 의존성을 설치합니다 (일반적으로):

npm install

OpenClaw, Clawdbot, MoltBot 중 어떤 이름으로 생각하든 동일한 코드베이스를 얻게 됩니다.

2단계: OpenClaw 환경 변수 설정

프로젝트 루트에 .env 파일을 생성하고 키를 추가합니다. 예를 들어:

ANTHROPIC_API_KEY=your_anthropic_key_here

TELEGRAM_BOT_TOKEN=your_telegram_bot_token_here

# Add other keys as required by the project (WhatsApp, Slack, etc.)

Telegram: @BotFather에서 봇 토큰을 받으세요.
WhatsApp / Slack / Discord: 각 플랫폼의 개발자 문서를 따라 토큰 또는 웹훅을 설정하세요.

이 설정이 완료되면 에이전트가 메시지를 수신하여 LLM으로 보낼 수 있습니다.

3단계: 도구 활성화 및 보안 강화

OpenClaw는 브라우저 제어, 파일 접근, 셸 명령 등을 위한 도구를 지원합니다. 특정 기능을 활성화하려면 config/tools.ts 또는 유사한 파일을 편집하세요.

많은 사용자가 원활한 작동을 위해 "dangerously-skip-permissions"를 활성화하지만, 이는 에이전트가 확인 없이 명령을 실행하도록 허용합니다. 위험을 최소화하려면 Docker에서 설정을 격리하세요.

기본 Docker 설정 구축:

Docker에서 Clawdbot을 가상 비서로 실행하기:

FROM node:20
WORKDIR /app
COPY . .
RUN npm install
CMD ["npm", "start"]

그 다음 실행:

docker build -t openclaw-assitance .
docker run -d --env-file .env openclaw-assitance

이것은 MoltBot 또는 Clawdbot을 가상 비서로서 안전하게 컨테이너화합니다.

4단계: OpenClaw를 가상 비서로서 메시징 앱에 연결

가상 비서로서의 Clawdbot을 위한 Telegram 설정:

@BotFather를 통해 봇을 생성합니다.
토큰을 .env 파일에 추가합니다.
에이전트를 시작합니다:

npm start

4. 봇에게 메시지를 보냅니다: "내 받은 편지함 요약" 또는 "오후 3시 회의 일정 변경".

에이전트는 Claude를 통해 처리하고, 계획하며, 행동합니다. 먼저 간단한 쿼리를 테스트해 보세요.

WhatsApp 또는 Slack의 경우, 문서에 따라 웹훅 또는 폴링을 구성하세요.

5단계: 맞춤형 API로 OpenClaw를 가상 비서로서 확장

가상 비서를 위한 맞춤형 통합으로 OpenClaw를 강화하세요. 외부 API를 호출하는 새로운 도구를 코드에 정의합니다.

Apidog는 이 과정에서 매우 유용합니다. Apidog를 사용하여 OpenAPI 사양을 설계하고, 개발 중에 엔드포인트를 목업하며, 요청을 테스트하고, 클라이언트 코드를 생성하세요. Apidog를 무료로 다운로드하여 이 단계를 가속화하세요. 시각적 편집기와 AI 지원 기능은 설정 시간을 크게 단축시켜 줍니다.

버튼

예시: 날씨 API 또는 자체 서비스를 쿼리하는 도구를 만드세요. Apidog에서 테스트하고 문서화한 다음, OpenClaw로 가져옵니다.

6단계: OpenClaw를 가상 비서로서 실행 및 모니터링

에이전트 실행:

npm run dev

오류를 확인하려면 로그를 모니터링하세요. 선택한 앱을 통해 상호 작용합니다. 에이전트는 맥락을 기억하므로, 후속 메시지는 이전 메시지를 기반으로 합니다.

더 나은 성능을 위해 설정 파일에서 프롬프트를 조정하세요. 온도, 최대 토큰 수 등을 조절합니다.

OpenClaw 실행을 위한 보안 모범 사례

전체 시스템 접근은 위험을 초래합니다. 이를 완화하려면:

Docker 또는 VM에서 실행합니다.
별도의 사용자 계정을 사용합니다.
네트워크 트래픽을 모니터링합니다.
실행된 명령을 정기적으로 검토합니다.
프롬프트에 민감한 데이터를 사용하지 않습니다.

많은 사용자가 격리된 환경에서 원활하게 작동한다고 보고합니다.

OpenClaw의 일반적인 문제 해결

API 호출 제한: Anthropic 플랜을 업그레이드하거나 모델을 전환하세요.
연결 끊김: 기기가 온라인 상태를 유지하는지 확인하고, 지속성을 위해 pm2 또는 systemd를 사용하세요.
권한 거부: 'dangerously-skip-permissions' 플래그를 확인하세요.
높은 비용: 능동적인 작업을 제한하고 사용량을 모니터링하세요.

커뮤니티 포럼과 GitHub 이슈에서 해결책을 찾을 수 있습니다.

결론

이제 OpenClaw를 가상 비서로, Clawdbot을 가상 비서로, 또는 MoltBot을 가상 비서로 효과적으로 실행하는 지식을 갖게 되었습니다. 이 설정은 단순한 LLM을 익숙한 채팅 인터페이스를 통해 실제 작업을 처리하는 유능한 에이전트로 변화시킵니다.

초기 구성에는 기술적인 노력이 필요하지만, 그 보상으로 여러분이 제어하는 개인화된 상시 이용 가능한 비서를 얻을 수 있습니다.

반복적으로 실험해 보세요. 작게 시작하고, 도구를 점진적으로 추가하며, 보안을 최우선으로 생각하세요. API를 통합하는 경우, Apidog를 무료로 사용하여 설계 및 테스트를 효율적으로 처리하세요.

여러분의 능동적인 AI 동반자가 기다리고 있습니다. 오늘 바로 설정해 보세요.

버튼