지난 2년 동안 AI 에이전트는 개인과 크리에이터에게 가장 중요한 디지털 비서로 단순한 챗봇을 서서히 대체해 왔습니다. 진정으로 가치 있는 AI는 서로 대화할 수 있을 뿐만 아니라 장기 기억력을 갖추고 워크플로우를 관리하며 도구를 통합하고 작업을 자동으로 수행할 수도 있습니다.
OpenClaw는 가장 성숙하고 완전히 자급자족 가능한 AI 에이전트 프레임워크 중 하나입니다. 클라우드 SaaS 플랫폼이 아니라 자체적으로 배포할 수 있는 시스템으로, 사용자가 모델, 메모리, 데이터 및 작동 방식을 완벽하게 제어할 수 있습니다.
이 문서에서는 자신만의 OpenClaw AI 에이전트를 처음부터 설정하는 과정을 안내합니다. 선택하실 수 있습니다:
옵션 A: 로컬 프록시 모드(클로드 맥스 구독이 더 적합하며 토큰 소각이 거의 없지만 사용자의 개별적인 필요에 따라 다르며, 맥북/윈도우 장기 사용자에게 적합)
옵션 B: VPS 클라우드 모드(24시간 상시 켜짐, 컴퓨터를 꺼도 사용 가능, 언제든지 휴대폰 채팅에 적합)
어떤 방법을 선택하든, 이 글에서는 가장 간단하고 안정적이며 검증된 단계를 제공하고 고급 명령어와 오류가 발생하기 쉬운 설정을 피하여 초보자도 원활하게 완료할 수 있습니다!
왜 OpenClaw인가?
2026 년 AI 에이전트 시장은 이미 매우 성숙하지만 대부분의 솔루션에는 시장 플랫폼 (예 : 일부 에이전트 서비스)이 언제든지 차단 될 수 있고 속도 제한 및 가격 상승, 순수 클라우드 솔루션은 개인 정보 보호에 대한 우려가 있으며 대화 기록이 모두 다른 사람의 손에 있으며 일부 로컬 대형 모델조차도 개인 정보 보호는 좋지만 느리고 메모리가 짧으며 실시간 검색이 불가능한 등 명백한 단점이 있습니다.
OpenClaw의 강점은 다음과 같습니다:
- 완전한 자체 지원모든 것은 여러분의 손에 달려 있습니다. 여러분은 절대 금지되지 않을 것입니다.
- 다중 에이전트 지원서로 다른 전문성(콘텐츠 제작, 워크플로우, 프로그램 개발, 연구 및 분석 등)을 가진 여러 에이전트를 동시에 실행할 수 있습니다.
- 텔레그램 네이티브 통합슈퍼그룹 + 토픽을 만들 수 있으며, 각 토픽마다 다른 상담원을 배치할 수 있습니다.
- 스킬 플러그인 시스템확장 가능한 기능(예: Gmail 읽기/쓰기, Google 캘린더 관리, 브라우저 자동화 등)
- 두 가지 주요 비용 절감 옵션：
- 로컬 프록시: 작업이 까다로운 경우, Opus 4.6을 무제한으로 사용할 수 있고 토큰 소각이 없는 클로드 맥스 구독을 고려해 보세요!
- VPS 클라우드: 월 사용료 약 $200-400, 항상 온라인 상태!
이미 Claude Max 구독(월 약 200달러)이 있는 경우 로컬 프록시 경로를 우선적으로 사용하거나, PC로부터 완전히 독립하고 싶다면 VPS로 바로 이동하는 것을 적극 권장합니다!
II. 준비(약 5~10분)
1. 하드웨어 및 계정 준비
로컬 프록시 경로(MacBook/Windows)
- 장시간 전원을 켜두거나 절전 모드에 있을 때 컴퓨터가 깨어나는 경우.
- 설치된 홈브루
- Node.js 22 이상 설치(설치 스크립트가 자동으로 처리됨)
VPS 클라우드 경로(초보자에게 권장)
다음 세 가지 옵션 중 하나를 선택하세요(2026년 가격 대비 성능이 가장 좋은 옵션):
- 무료 경로(최상위 권장 시작 지점) - 오라클 클라우드 항상 무료
- 저렴한 비용 결제(월 $2부터) - IONOS VPS XS
- 매우 사용하기 쉬운 대안 (월 $6.49부터 프로모션) - Hostinger VPS
다음으로, 텔레그램에서 인공지능과 상호작용을 하고자 하는 경우, @봇파더로 이동하여 새 봇을 설정하고 Te레그램 봇 토큰을 사용하면 다음 단계가 유용할 것입니다!
2. 경로 선택
컴퓨터가 장시간 켜져 있는 경우 → "로컬 프록시" 경로로 이동
컴퓨터를 끄고 싶고 약간의 월별 클라우드 요금을 지불할 의향이 있는 경우 "VPS 클라우드" 경로 선택
설치 시작 경로 1: 로컬 프록시 모드
1단계: 홈브루 설치
아직 Homebrew를 설치하지 않았다면 공식 지침을 참조하세요:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh")"처음 설치하는 동안 시스템이 자동으로 Xcode용 명령줄 도구 설치를 트리거할 수 있습니다. 이는 컴파일러 및 기타 필요한 시스템 라이브러리가 포함된 macOS에 내장된 기본 개발 도구 세트입니다. 많은 소프트웨어 패키지(예: Homebrew, Node.js 등)는 설치 및 작동 중에 올바르게 컴파일하고 실행하기 위해 이러한 도구에 의존합니다.
이 단계는 일반적으로 시간이 다소 걸리므로 인내심을 갖고 완료될 때까지 기다렸다가 계속 진행하세요.
완료되면 환경 변수를 로드합니다:
echo ‘eval “$(/opt/homebrew/bin/brew shellenv)”‘ >> ~/.zprofile eval “ $(/opt/homebrew/bin/brew shellenv)”
이 단계의 목적은 macOS 터미널이 brew 명령을 올바르게 인식하고 실행할 수 있도록 시스템의 PATH 환경 변수에 Homebrew 설치 디렉터리를 추가하는 것입니다. 이 설정이 없으면 홈브루가 성공적으로 설치되더라도 시스템에서 brew 명령을 직접 사용할 수 없습니다.
왜 홈브루로 시작해야 하나요?
Homebrew는 macOS에서 가장 안정적이고 널리 사용되는 패키지 관리 도구입니다. 이를 사용하여 Node.js를 설치하면 버전 일관성을 보장하고 종속성을 완벽하게 처리하며 일반적인 권한 문제나 잘못된 PATH 구성을 방지할 수 있습니다.
후속 배포의 경우 Homebrew는 전체 시스템의 인프라로 간주할 수 있습니다. 탄탄한 기반이 있어야 나중에 구축되는 에이전트와 모델도 장기적인 안정성을 유지할 수 있습니다.
2단계: Node.js 설치
OpenClaw는 Node.js를 기반으로 구축되었으므로 먼저 Node.js 환경을 구성해야 합니다. 버전 22 이상을 사용하는 것이 좋습니다.
설치 시에는 홈브루를 직접 사용하는 것이 좋습니다:
brew 설치 노드
최신 버전의 OpenClaw는 최신 Node.js API와 모듈 관리를 사용합니다. Node.js 버전이 너무 오래된 경우 모듈이 로드되지 않거나 서비스가 제대로 시작되지 않을 수 있습니다. 이 단계는 단순히 Node.js를 설치하는 것뿐만 아니라 전체 환경이 현재 공식 표준 및 호환성 요구 사항을 충족하는지 확인하는 단계입니다.
3단계: OpenClaw 설치
Node.js 환경이 준비되면 OpenClaw 자체 설치를 시작할 수 있습니다.
공식 CLI 설치 방법을 권장합니다:
curl -fsSL https://openclaw.ai/install.sh | bash
홈브루를 통해 설치하는 GUI 버전보다 CLI를 선호하는 이유는 무엇인가요?
CLI 버전은 OpenClaw의 핵심 구현으로, 동작이 간단하고 문제가 발생했을 때 가장 쉽게 진단하고 수정할 수 있습니다. 홈브루를 통해 설치된 일부 GUI 또는 패키지 버전은 백그라운드 서비스의 중복 실행을 유발하여 다음과 같은 상황을 초래할 수 있습니다:
- 게이트웨이 서비스는 여러 번 실행됩니다.
- 일관성 없는 프로필 경로
- 포트가 사용 중입니다.
시스템 아키텍처 관점에서 볼 때 CLI는 기본 코어이고 GUI는 상위 레벨 인터페이스일 뿐입니다. 핵심 CLI를 먼저 마스터하면 전체 시스템을 더 안정적이고 신뢰할 수 있게 만들 수 있습니다.
CLI를 설치하더라도 궁극적으로 브라우저를 통해 웹 채팅 인터페이스에 액세스하여 대화 및 관리할 수 있으므로 그래픽 조작의 편리함을 잃지 않습니다.
4단계: ChatGPT 구독에 연결하고 코덱스 모델 선택하기
설치가 완료되면 실제로 모델을 작동시키려면 OpenClaw를 ChatGPT 계정에 연결해야 합니다.
API 키를 수동으로 입력하는 대신 인증 인증을 사용하는 것이 좋습니다. 인증 인증은 현재 ChatGPT 계정의 구독 권한과 해당 구독에서 사용 가능한 다양한 모델을 직접 차용합니다.
OpenAI 또는 Google과 같은 서비스를 선택하면 터미널에서 API 키를 입력하라는 메시지가 표시됩니다. 키를 등록하려면 해당 플랫폼의 웹사이트로 이동해야 합니다. 이 단계는 모델에 따라 다르므로 API 키를 찾는 방법을 잘 모르는 경우 AI에 도움을 요청하세요.
아래 표시된 대화형 설정 프로세스에서 순서대로 선택합니다:
- AI 제공업체(예: OpenAI)
- 인증을 통한 인증
- 사용 가능한 코덱스 모델(예: openai-codex/gpt-5.3-codex)을 선택합니다.
- 대화할 플랫폼을 텔레그램 또는 다른 플랫폼 중에서 선택합니다.
ChatGPT 플러스 구독료는 월 약 20달러입니다. 인증 링크를 통해 OpenClaw는 구독 계정에서 코덱스 모델 제품군을 포함한 모델 권한을 직접 활용할 수 있습니다.
일상적인 프로그래밍, 명령 생성 및 자동화 작업의 경우, API 청구를 처리하거나 토큰 소비를 모니터링할 필요 없이 플러스 구독 할당량만으로도 일반적인 개인 용도로 충분할 때가 많습니다. 개인 개발자나 고급 사용자를 위한 간단하고 비용 효율적인 옵션입니다.
이 단계가 끝나면 OpenClaw는 공식적으로 ChatGPT 구독을 백엔드 모델 소스로 사용합니다. 모델 사용량과 남은 할당량을 확인하려면 다음 주소로 이동하세요. https://chatgpt.com/codex/settings/usage 현재 기록 및 통계를 확인합니다.
이때 텔레그램을 선택한 경우 텔레그램 봇 토큰을 입력하라는 메시지가 표시될 것입니다. "텔레그램" 필드에 텔레그램 봇 토큰을 입력하는 것을 잊지 마세요.준비"봇 토큰의 이 부분이 이미 준비되었나요? 복사하여 붙여넣기만 하면 됩니다!
다음 단계는 훅을 설정하는 것입니다. 훅은 명령과 이벤트에 대한 응답으로 자동화된 작업을 생성하는 시스템입니다.
- boot-md: OpenClaw가 시작될 때마다 특정 작업을 실행하는 데 사용됩니다.
- 부트스트랩-추가 파일: 추가 작업 공간을 삽입하기 위한 파일입니다. 부트스트랩 파일.
- command-logger: 디버깅에 적합한 모든 명령 이벤트의 기록을 유지하는 데 사용됩니다.
- 세션 메모리: 상담원이 컨텍스트를 유지하고 이전 대화를 '기억'할 수 있도록 합니다.
5단계: 게이트웨이 서비스 활성화 및 텔레그램 인터페이스 열기
텔레그램에서 봇과 대화를 시도해보세요, 봇이 정상적으로 응답한다면, 로컬 프록시 모드가 성공한 것입니다!
경로 2 설치를 시작합니다:VPS 클라우드 모드(24/7 상시 켜짐)
로컬 프록시 대신 다른 클라우드 VPS 솔루션을 사용하기로 했다면, 이 AI 프록시를 컴퓨터가 켜져 있을 때만 작동하는 도구가 아닌 '영구 온라인 시스템'으로 만들기로 했다는 뜻입니다.
클라우드 배포의 가장 큰 가치는 안정성과 연속성입니다. 사용자가 어디에 있든, 컴퓨터를 끄든 상관없이 에이전트가 24시간 실행되어 명령을 계속 수신하고 작업을 처리하며 메모리를 유지할 수 있습니다. 하지만 VPS 설정에는 시스템 환경, SSH 연결, 서비스 시작 및 백그라운드 보호 등의 단계가 포함되어 있어 텍스트로 자세히 설명하면 서버를 처음 사용하는 사용자가 이해하기에는 상대적으로 많은 비용이 듭니다.
아래 동영상을 참고하시면, 전체 과정을 확인하실 수 있습니다. 이 영상은 AWS에서 우분투 호스팅을 설정하고, 오픈클로를 설치하고, 텔레그램 봇을 설정하는 방법을 보여드립니다!
OpenClaw 설치 시 중요한 안전 수칙
1. 공개 인터넷에 노출시키지 마세요.
낯선 사람이 내 OpenClaw 제어판에 액세스할 수 있는 경우 해킹을 시도할 수 있습니다. "localhost"에 바인딩하고 SSH 터널링(즉, 암호화된 연결을 통해 트래픽을 전송하는 것)을 사용하는 것이 좋습니다.
2. 고강도 코드/셉터 사용
"abc" 또는 "123"과 같은 단순한 지팡이를 사용하지 마세요. OpenClaw는 현재 비밀번호 복잡도를 강제하지 않으므로 단일 문자(예: "a")를 유효한 보안 지팡이로 인정합니다. 무차별 암호 대입 공격을 방지할 수 있을 만큼 충분히 길고 안전한 보안 지팡이인지 수동으로 확인해야 합니다.
3. API 키 보호
OpenClaw를 AI 모델이나 암호화폐 도구에 연결하는 경우 이러한 키를 안전하게 보관해야 합니다. 임의의 스크립트나 신뢰할 수 없는 스킬에 키를 붙여넣지 마세요. OpenClaw는 API 키, OAuth 권한, 로봇 자격 증명을 텍스트 전용 프로필에 저장합니다. 정보 도용 멀웨어는 이러한 특정 파일을 능동적으로 잠그고 수집하도록 업데이트되었습니다.
4. 타사 기술의 신중한 사용
스킬은 소프트웨어 다운로드로 취급하며, 일부는 보안 위험이 있을 수 있습니다. 코드를 검토하거나 신뢰할 수 있는 출처를 이용하세요. ClawHub 스킬 마켓플레이스에는 멀웨어 및 자격 증명 도용자를 포함한 악성 페이로드가 포함되어 있을 수 있습니다. 검증되지 않은 스킬은 완전히 금지하고 Cisco의 오픈 소스 스킬 스캐너와 같은 도구를 사용하여 새로운 스킬을 설치하기 전에 검증하세요.
5. 가능한 한 독립형 머신 또는 샌드박스 사용
테스트가 필요한 경우 민감한 데이터가 포함되지 않은 가상 머신, Docker 컨테이너 또는 예비 컴퓨터에서 실행하는 것이 더 안전합니다.
6. 중대한 취약점의 즉각적인 해결
사용 중인 OpenClaw 버전이 2026.1.29 이후 버전으로 업데이트되었는지 확인하세요. 이전 버전에는 공격자가 AI를 속여 악성 웹 페이지를 방문하도록 유도하는 것만으로 몇 밀리초 만에 컴퓨터를 완전히 원격 제어할 수 있는 심각한 취약점(CVE-2026-25253)이 있습니다.
7. 경고 주입
OpenClaw가 숨겨진 악성 명령이 포함된 이메일, Google 문서, Slack 메시지 또는 웹 페이지를 읽으면 이러한 명령이 에이전트의 동작을 가로채 데이터를 유출하거나 사용자 모르게 임의의 명령을 실행할 수 있습니다. 상담원이 신뢰할 수 없는 콘텐츠를 처리하도록 허용하지 마세요.
8. 정기적인 보안 감사 수행
OpenClaw에는 보안 도구가 내장되어 있습니다. 터미널에서 "openclaw 보안 감사" 명령을 주기적으로 실행하여 게이트웨이 노출 및 권한 문제를 확인하세요. "-fix" 플래그를 사용하여 식별된 잘못된 구성을 자동으로 수정할 수도 있습니다.
설치 시 가장 일반적인 문제에는 어떤 것이 있나요?
OpenClaw를 설정하는 과정에서 초보자가 겪는 가장 일반적인 문제는 실제로 비슷하며, 대부분 시스템 환경, 설정 순서 또는 소프트웨어 호환성으로 인해 발생합니다. 아래는 가장 일반적인 5가지 문제와 그 느낌 및 해결 방법을 나열한 목록으로, "우리 모두 이런 문제가 발생하겠구나"라고 생각하실 수 있을 것입니다.
문제 1: 터미널에 갑자기 "openclaw: 명령을 찾을 수 없습니다"라는 메시지가 표시됩니다.
첫 번째 설치 후 많은 사람들이 전화로 오픈클로 -버전 테스트할 때 시스템에서 "명령을 찾을 수 없습니다"라는 메시지가 표시되고 그 순간 정말 "방금 설치하지 않았나?"라는 생각이 들었습니다. 어떻게 이런 일이 일어날 수 있지?
이는 실제로 npm 전역 설치 지시어의 경로가 PATH에 자동으로 추가되지 않기 때문입니다. 이는 특히 macOS 또는 Ubuntu에서 nvm 또는 Homebrew를 사용하여 Node.js를 설치한 후 발생하는 경우가 많습니다.
솔루션:
경로에 npm 글로벌 bin 디렉터리를 추가하기만 하면 됩니다. 실제로는 "그냥 나쁜 경로"라는 느낌이 들 것입니다. 터미널에 다음 두 줄을 입력합니다(Mac의 경우 zsh, Ubuntu의 경우 bash):
export PATH=”$HOME/.npm-global/bin:$PATH”
echo ‘export PATH=”$HOME/.npm-global/bin:$PATH”‘ >> ~/.bashrc # 우분투
입력한 다음 다시 입력합니다. 오픈클로 -버전 버전 번호가 보일 것입니다. 많은 사람이 이 단계에서 10분 동안 멈춰 있지만, PATH 문제라는 것을 깨닫고 나면 바로 해결됩니다!
문제 2: 게이트웨이를 시작하지 못하여 "서비스가 로드되지 않음" 또는 "찾을 수 없음"이 표시됩니다.
이것은 Mac과 Linux의 가장 일반적인 문제입니다. 설치 후 "openclaw 게이트웨이 재시작"을 입력하면 "게이트웨이 서비스가 로드되지 않음" 또는 "장치를 찾을 수 없음"이라는 메시지가 표시되어 전체 서비스가 설치되었지만 아직 설치되지 않은 것처럼 느껴질 수 있습니다.
그 이유는 일반적으로 LaunchAgent(Mac) 또는 systemd(Linux)가 제대로 등록되지 않았거나 이전 설치가 중단되어 파일이 남아있기 때문입니다.
해결 방법: 먼저 이전 서비스를 강제 정리한 다음 다시 설치하세요.
MacOS를 예로 들어 보겠습니다:
오픈클로 게이트웨이 스톱
오픈클로 게이트웨이 설치
오픈클로 게이트웨이 -데몬
상태 실행 후 "상태"라는 단어가 표시되면활성: 활성(실행 중)"서비스가 제대로 작동하지 않는다면, 백그라운드에서 서비스가 제대로 작동하고 있다는 뜻입니다. 텔레그램으로 돌아가서 다시 테스트하면, 보통 정상으로 돌아옵니다.
문제 3: 휴대폰에서 입력할 때 봇이 전혀 응답하지 않지만 컴퓨터에서는 정상적으로 작동합니다.
많은 사람들이 VPS로 이전한 후 가장 큰 충격을 받은 순간은 Mac에서는 여전히 답장을 보낼 수 있지만 휴대폰으로 채팅할 때 AI 상담원의 답장을 받을 수 없다는 것이었습니다.
그 이유는 거의 항상 "동일한 텔레그램 봇 토큰을 동시에 두 개의 오픈클로가 가져가기 때문"입니다.
텔레그램의 getUpdates 메커니즘은 한 번에 하나의 연결만 허용하며, Mac에서 서비스를 완전히 종료하지 않으면 충돌이 발생할 수 있습니다!
해결 방법: Mac에서 모든 OpenClaw 프로세스를 완전히 비활성화하세요:
오픈클로 게이트웨이 설치
PKILL-F 오픈클로
AWS에서 다시 확인합니다:
openclaw-gateway.service 다시 시작
상태 openclaw-gateway.service
Mac의 터미널 창을 닫거나 전원을 끄고 휴대폰으로 다시 테스트하세요. 응답하면 클라우드가 완전히 인수한 것입니다!
결론
봇이 일관되게 응답하고 대화를 기억하며 모델 전환 및 스킬 확장을 지원할 수 있으면 시스템이 성공적으로 구축된 것입니다.
그 과정에서 여러 가지 난관이 있지만, 하나씩 해결해 나갈 때마다 전체 시스템에 대한 이해가 깊어질 것입니다!
앞으로 더 많은 스킬(예: Gmail, Google 캘린더, GitHub 작업)을 설치하고, 여러 수준의 에이전트 계층 구조(CEO 에이전트 → 관리자 에이전트 → 작업자 에이전트)를 설정하고, SKILL.md를 사용자 지정하여 자신만의 독점 기능을 작성하는 등 계속 확장해 나갈 수 있습니다.
기억하세요: OpenClaw는 완성된 제품이 아니라 무한히 성장할 수 있는 프레임워크입니다. 입문 과정의 가장 어려운 부분을 이미 통과하셨으니 이제 남은 것은 계속 최적화하고 사용하는 것입니다!
우리의 텔레그램 커뮤니티 매일 회원을 모집합니다.실제 경험, 일반적인 피트 솔루션, 최신 최적화 팁을 공유하여 랍스터를 최상의 상태로 빠르게 조정할 수 있도록 도와드립니다. 지금 무료로 가입하시면 AI 에이전트 게임을 더 깊고 강력하게 만들 수 있도록 도와드리겠습니다!
웹사이트 면책 조항
이 글의 내용은 참고용일 뿐이며, 투자자는 독립적인 판단을 통해 신중하게 투자해야 하며, 자신의 책임하에 투자해야 하며, 이 글은 거래 또는 투자 근거를 제공하거나 설득하지 않으며, 콘텐츠는 공유 목적으로만 사용되며 투자 조언으로 간주되어서는 안 됩니다.몬스터블록크의 견해와 입장을 대변하지 않습니다.모든 정보와 의견은 특정 날짜를 기준으로 한 판단에 대해서는 시한이 정해져 있습니다. 또한, 판단이 내려지는 경우이 웹사이트에서홍콩에서 가상자산 거래 플랫폼 운영 라이선스를 아직 취득하지 않은 가상자산 거래 플랫폼과 관련된 모든 콘텐츠(텍스트 소개, 사진, 오퍼, 이벤트 등)는 홍콩 특별행정구 외부의 사용자만 이용할 수 있습니다.
홍콩의 자금 세탁 및 테러 자금 조달 방지(개정) 조례 2022에 따르면 2023년 6월 1일 이후 홍콩에서 운영되거나 홍콩 투자자에게 서비스를 적극적으로 홍보하는 모든 중앙집중식 가상자산 거래 플랫폼은 SFC의 허가를 받고 규제를 받게 되며, 관련 무허가 활동은 형사 범죄에 해당됩니다. 법률에 대한 자세한 정보와 세부 사항은 SFC 웹사이트를 참조하시기 바랍니다.