OpenClaw 설치 튜토리얼: 프로액티브 AI 에이전트 가이드

OpenClaw 설치 튜토리얼은 시스템 수준 명령을 실행하고 로컬에서 크로스 플랫폼 통신을 관리할 수 있는 연중무휴 사전 예방적 AI 에이전트를 배포하는 데 필수적인 로드맵입니다. 그러나 최신 2026 빌드는 다음에 대한 기본 지원을 제공합니다. GPT-5.4, 많은 사용자가 새로운 도구 검색 메커니즘으로 인해 발생하는 “토큰 번'으로 인해 어려움을 겪고 있으며, 정밀하게 구성하지 않으면 예상치 못한 지연 시간과 천문학적인 API 비용이 발생할 수 있습니다.

이러한 기술적, 재정적 장애물을 제거하는 가장 효과적인 방법은 세계 최고의 AI 모델에 무제한으로 액세스할 수 있는 통합 플랫폼인 GlobalGPT를 이용하는 것입니다. GlobalGPT를 사용하면 다음을 통해 OpenClaw 게이트웨이를 강화할 수 있습니다. ChatGPT 5.4, Claude 4.6 (비교 방법은 GPT-5.4 vs Claude 4.6 가이드), Gemini 3.1, 와 퍼플렉시티는 $5.8의 정액제 기본 요금으로 최고의 추론 성능을 유지하면서 공식 사용량 제한과 복잡한 결제 제한을 우회할 수 있습니다.

GlobalGPT는 에이전트 리서치부터 고급 콘텐츠 제작까지 원활하게 진행할 수 있도록 전체 주기 워크플로우를 지원하도록 설계되었습니다. 에이전트가 구성되면 다음과 같은 기능을 갖춘 비디오 AI 및 이미지 생성 제품군으로 프로젝트를 더욱 향상시킬 수 있습니다. 소라 2 플래시, Kling, 중간 여정, 및 나노 바나나 2. 터미널을 자동화하든 시네마틱 비주얼을 제작하든, GlobalGPT를 사용하면 단일 고성능 대시보드 내에서 전체 프로젝트를 완료할 수 있습니다.

글쓰기, 이미지 및 동영상 생성을 위한 올인원 AI 플랫폼(GPT-5, Nano Banana 등)

OpenClaw 설치 튜토리얼: 2026년에 최고의 AI 에이전트 프레임워크를 배포하는 방법은?

사전 예방적 AI 어시스턴트 설정은 다음과 같이 시작됩니다. OpenClaw 설치 튜토리얼을 참조하세요. 2026년 3월 현재, OpenClaw는 자율 에이전트를 위한 최고의 자체 호스팅 게이트웨이로서의 입지를 굳건히 하고 있습니다. 최신 2026.3.11 릴리스에서는 GPT-5.4에 대한 중요한 안정성 수정과 OpenRouter를 통한 1M 컨텍스트 모델에 대한 기본 지원이 도입되었습니다.

macOS 또는 Linux를 사용하는 대부분의 사용자는 공식 한 줄 설치 프로그램을 사용하는 것이 가장 빠른 방법입니다. 터미널을 열고 실행합니다:

“curl -fsSL https://openclaw.ai/install.sh | bash”

이 스크립트는 환경 검사, 종속성 설치 및 바이너리 연결을 자동화합니다. 로컬 “랍스터” 에이전트가 시스템 및 선호하는 메시징 채널과 즉시 상호 작용하는 데 필요한 훅을 갖출 수 있도록 합니다.

OpenClaw란 무엇이며 자체 호스팅 AI 어시스턴트가 필요한 이유는 무엇인가요?

OpenClaw(이전 명칭: Clawdbot, 자세히 알아보기 클로봇이란?)는 자체 호스팅되는 오픈 소스 에이전트 게이트웨이로, 프론티어 LLM(대규모 언어 모델)과 로컬 인프라 간의 격차를 해소하기 위해 설계되었습니다. 2026년 1월에 공식적으로 브랜드가 변경된 이 프로젝트는 원래의 “WhatsApp 릴레이'에서 벗어나 자율 생산성을 위한 종합 플랫폼으로 거듭났습니다. 하드웨어에 상주하는 안전한 ”두뇌“ 역할을 하며 WhatsApp, Telegram, Discord, Slack, iMessage 등 50개 이상의 통합 커뮤니케이션을 관리합니다.

OpenClaw의 가장 큰 특징은 능동적인 실행입니다. 표준 AI 챗봇(ChatGPT 또는 Claude 등)은 수동적이며 메시지가 표시될 때만 응답하는 반면, OpenClaw는 24시간 연중무휴 백그라운드 직원처럼 작동하며 완전히 통합된 사람처럼 작동합니다. ChatGPT 에이전트. 로컬 파일의 변경 사항을 모니터링하고, 예약된 Cron 작업을 실행하며, 받은 편지함을 지우거나 항공편 체크인과 같은 다단계 워크플로우를 완전히 자율적으로 수행할 수 있습니다. 공식적인 사용량 제한에 걸리지 않고 이러한 수준의 고빈도 추론을 유지하기 위해, 많은 파워 유저들은 GlobalGPT의 안정적인 API 엔드포인트를 통해 OpenClaw 요청을 라우팅합니다.

셀프 호스팅 게이트웨이를 선택하는 이유는 무엇인가요?

• 데이터 주권: 회사 서버에 프롬프트가 저장되는 SaaS 어시스턴트와 달리 OpenClaw는 사용자의 컨텍스트와 스킬이 사용자의 컴퓨터에 유지되도록 합니다.
• 전체 시스템 액세스: OpenClaw는 로컬 파일 읽기/쓰기 및 셸 명령(bash/zsh)을 실행하여 터미널 작업을 자동화할 수 있습니다.
• 영구 메모리: 상담원은 “영혼” 시스템(soul.md)을 통해 사용자의 선호도와 과거 상호작용에 대한 고유하고 장기적인 기억을 구축합니다.
• 브라우저 제어: 양식을 작성하고 실시간 데이터를 추출하며 복잡한 웹 인터페이스를 탐색할 수 있는 관리형 브라우저를 제공합니다.

개발자는 오픈클로 AI 프레임워크와 오픈클로 게임 엔진을 구분하는 것이 중요합니다. 후자는 디지털 보존을 위해 최신 SDL2 라이브러리를 사용하는 1997년 출시된 플랫포머 게임인 Captain Claw를 C++11로 재구현한 것입니다. 반면, AI 프레임워크는 에이전트 인텔리전스와 “랍스터 방식”(지속적인 성장과 클로허브의 방대한 커뮤니티 기반 기술 라이브러리를 통해 더 강력한 버전으로 “탈피'하는 것을 상징하는 철학)에 중점을 둔 Node.js 24를 기반으로 구축되었습니다.

사전 요구 사항: OpenClaw의 하드웨어 및 소프트웨어 요구 사항

설치를 시작하기 전에 사용 중인 환경이 엄격한 2026 기술 요구 사항을 충족하는지 확인하세요. 이제 게이트웨이에 권장되는 런타임은 Node.js 24이지만, 레거시 호환성을 위해 Node 22 LTS는 계속 지원됩니다.

• 운영 체제: macOS(기본), Linux(Ubuntu 24.04 이상) 또는 Windows(WSL2 필수).
• 하드웨어: 안정적인 백그라운드 처리를 위해서는 최소 8GB RAM이 필요합니다. 24시간 연중무휴로 작업하려면 Raspberry Pi 5 또는 Mac Mini가 이상적입니다.
• 권한: 전체 자동화 제품군을 사용하려면 게이트웨이 터미널에 파일 읽기/쓰기 및 스크립트 실행에 대한 액세스 권한을 부여해야 합니다.

여러 번의 청구 주기로 인한 마찰 없이 자율 에이전트가 가장 안정적인 추론 모델에 액세스할 수 있도록 하기 위해 많은 개발자가 OpenClaw 게이트웨이를 GlobalGPT의 통합 API 허브에 연결하는 것을 선호합니다.

단계별 가이드: 모든 플랫폼에 OpenClaw를 설치하는 방법?

OpenClaw를 배포하려면 OS 환경에 맞는 특정 명령 순서가 필요합니다. 다음은 2026.3.11 릴리스의 공식 방법입니다.

방법 1: macOS에 OpenClaw 설치하기(애플 실리콘에 고도로 최적화)

OpenClaw는 Apple 실리콘(M1/M2/M3/M4) 아키텍처에 매우 최적화되어 있습니다. AI 에이전트는 백그라운드에서 지속적으로 실행되도록 설계되었기 때문에 Mac 기기(특히 에너지 효율이 높은 Mac mini)는 로컬 호스팅에 이상적인 환경입니다. (참고: 게이트웨이를 실행하기 전에 시스템에 Node.js 버전 22 LTS 또는 24가 설치되어 있는지 확인하세요..)

원클릭 설치 명령: 터미널을 열고 공식 설치 스크립트를 실행합니다: curl -fsSL https://openclaw.ai/install.sh | bash 이 스크립트는 macOS 환경을 자동으로 감지하고, 누락된 경우 Node.js와 Git을 설치하고, OpenClaw CLI를 전역적으로 설치하며, 온보딩 마법사를 즉시 실행합니다.

macOS 컴패니언 앱: 설치 흐름은 macOS 컴패니언 앱(OpenClaw.app)을 설정하는 방법을 안내합니다. 이 앱은 상단 메뉴 표시줄에 위치하며 게이트웨이의 핵심 브로커 역할을 합니다. 이 앱은 중앙에서 모든 TCC(투명성, 동의 및 제어) 권한 AI 에이전트가 작업을 실행하는 데 필요한 권한입니다. 특히 화면 녹화, 마이크(음성 깨우기용), 접근성 및 시스템 수준 자동화/애플스크립트에 대한 권한을 처리합니다. 또한 로컬 게이트웨이의 출시 백그라운드 데몬을 사용하여 AI 어시스턴트가 연중무휴 온라인 상태를 유지하도록 합니다.

로컬 스토리지 및 함정 방지 가이드: OpenClaw의 상태 디렉터리를 구성할 때(기본값은 ~/.openclaw), 아이클라우드 드라이브는 사용하지 않는 것이 좋습니다. 또는 기타 클라우드 동기화 서비스. 상태 디렉터리가 다음 위치에 있는 경우 ~/도서관/모바일 Documents/com~apple~CloudDocs/ 또는 그 이하 ~/Library/CloudStorage/, 를 사용하면 클라우드 동기화 메커니즘이 세션 기록 및 자격 증명 파일의 빈번한 읽기/쓰기 작업을 처리하는 데 어려움을 겪을 수 있습니다. 이는 필연적으로 다음과 같은 결과로 이어집니다. 파일 잠금 또는 동기화 레이스, 를 사용하면 앱에서 심각한 지연 시간, 충돌 또는 경고 메시지가 표시될 수 있습니다. 최상의 성능과 데이터 안전을 보장하려면 엄격하게 로컬 경로를 사용하세요.

방법 2: Linux(Ubuntu 24.04/26.04 서버)에 OpenClaw 배포하기

VPS 또는 홈 랩에서 연중무휴 24시간 “AI Worker'를 구축하는 경우, Linux 배포(예: Ubuntu 22.04 LTS 이상)를 통해 가동 시간과 안정성을 극대화할 수 있습니다.

종속성 및 준비: OpenClaw에는 Node.js 버전 22(LTS) 또는 24가 필요합니다. 필수 구성 요소를 수동으로 설치할 수도 있지만, 공식 설치 스크립트가 자동으로 Linux 배포를 감지하여 누락된 경우 Node.js 및 Git을 설치해 줍니다. (전문가 팁: RAM이 2GB 미만인 등 메모리에 제약이 있는 VPS의 경우 설치 전에 스왑 파일을 할당하여 AI 워크로드 또는 npm 패키지 설치 중 메모리 부족(OOM) 충돌을 방지할 것을 적극 권장합니다..)

설치 명령: 터미널에서 공식 자동화 스크립트를 실행하세요: curl -fsSL https://openclaw.ai/install.sh | bash.

온보딩 및 지속성: 상담원이 24시간 연중무휴로 실행되도록 하려면 데몬 플래그를 사용하여 온보딩 마법사를 실행하세요: 오픈클로우 온보드 --설치-데몬. 이렇게 하면 게이트웨이가 백그라운드로 등록됩니다. systemd 사용자 서비스가 시스템 재부팅과 충돌에도 살아남도록 보장합니다. SSH 세션에서 로그아웃한 후에도 서비스가 계속 유지되도록 보장합니다, systemd “lingering”을 활성화해야 합니다. 실행 중 오픈클로 닥터 명령을 실행하면 Linux에서 이 설정이 자동으로 확인되고 적용됩니다. 언제든지 다음을 사용하여 데몬의 상태를 확인할 수 있습니다. 오픈클로 게이트웨이 상태.

헤드리스 서버 액세스(제어 UI): 기본적으로 OpenClaw 컨트롤 UI는 루프백 주소(127.0.0.1:18789). 이 포트를 공용 인터넷에 직접 노출하지 마세요. (0.0.0.0 또는 lan 바인딩)을 사용하면 보안 터널 없이도 에이전트에 대한 모든 관리 및 실행 제어 권한을 부여할 수 있습니다. 대신 로컬 컴퓨터의 브라우저에서 대시보드에 안전하게 액세스하려면 SSH 터널을 사용하세요: ssh -N -L 18789:127.0.0.1:18789 user@SERVER_IP. 터널이 활성화되면 http://127.0.0.1:18789/ 를 입력합니다. 인증 토큰을 입력하라는 메시지가 표시되며, 인증 토큰은 다음을 실행하여 서버에서 가져올 수 있습니다. 오픈클로 구성 gateway.auth.token 가져오기. 또는 안전하고 인증된 원격 액세스를 위해 Tailscale Serve를 사용할 수 있습니다.

방법 3: Windows에서 OpenClaw 설정하기(WSL2 적극 권장)

기본 Windows 설치는 PowerShell 헬퍼 스크립트를 통해 지원되지만(IWR -USEB https://openclaw.ai/install.ps1 | IEX), 터미널 인코딩 문제(예: 왜곡된 텍스트 출력) 및 종속성 오류 누락으로 인해 일반적으로 프로덕션 에이전트에서는 사용하지 않는 것이 좋습니다. 가장 안정적이고 성능이 뛰어나며 권장되는 접근 방식은 Linux용 Windows 하위 시스템(WSL2)을 사용하는 것입니다.

WSL 설정 및 설치: Linux 배포판이 설치되어 있는지 확인합니다(예: Microsoft Store를 통해 Ubuntu 22.04 또는 24.04). PowerShell 스크립트를 사용하는 대신 WSL Linux 터미널을 열고 표준 Linux 설치 관리자를 실행합니다: curl -fsSL https://openclaw.ai/install.sh | bash. 이 경로는 Node.js와의 완전한 호환성을 보장하고 올바르게 설정합니다. systemd 백그라운드 서비스를 사용하여 일반적인 네이티브 윈도우를 피합니다. npm 경로 오류.

크로스 플랫폼 포트 및 액세스: WSL 네트워크 브리지 덕분에 Linux 하위 시스템 내부에서 실행되는 OpenClaw 게이트웨이는 루프백 주소에 원활하게 바인딩됩니다. 기본 Windows 브라우저에서 제어 UI에 직접 액세스하여 AI 에이전트를 관리할 수 있습니다. http://127.0.0.1:18789.

방법 4: 고급 강화 배포(Ansible 및 Docker)

엔터프라이즈 운영, 홈 랩 또는 보안 수준이 높은 환경의 경우 전문 개발자는 공식 오픈클로-안서블 수집. 이 자동화된 플레이북은 매우 안전하고 프로덕션에 바로 사용할 수 있는 환경을 제공하며 특히 Debian/Ubuntu 시스템에 맞게 맞춤화되어 있습니다. (참고: 이 플레이북에서는 시스템 수준의 권한 위험을 방지하기 위해 베어 메탈 macOS 실행을 의도적으로 비활성화했습니다.).

심층 방어 및 도커 격리: 이 배포를 통해 OpenClaw는 엄격하게 범위가 지정된 권한이 없는 비루트 사용자로만 실행됩니다. sudo 액세스. 에이전트는 강화된 Docker 샌드박스 내에서 작동하며, 모든 컨테이너 포트는 다음과 같이 엄격하게 바인딩됩니다. 127.0.0.1 (로컬호스트)가 아닌 0.0.0.0, 를 사용하여 에이전트가 손상된 경우 폭발 반경을 최소화합니다.

강화된 네트워킹 및 위협 완화: 이 설정은 “방화벽 우선” 철학을 기반으로 구축되었습니다. 자동으로 다음을 구성합니다. UFW 방화벽에 규칙을 주입하고 DOCKER-USER iptables 체인을 사용하여 Docker가 방화벽 구성을 우회할 수 없도록 보장합니다. 또한 기본적으로 Tailscale VPN을 통합하여 공용 인터넷에 접속하지 않고도 에이전트의 API 및 제어 UI에 원격으로 안전하게 액세스할 수 있습니다.

자동화된 보안 유지 관리: 강력한 보안 태세를 유지하기 위해 플레이북이 자동으로 설치됩니다. Fail2ban 를 사용하여 SSH 무차별 대입 공격으로부터 보호하고 다음을 구성합니다. 무인 업그레이드 를 실행하여 호스트 운영 체제가 자동 보안 패치를 받도록 합니다. 이 배포는 다음을 실행하여 시작할 수 있습니다. 앤서블-갤럭시 컬렉션 오픈클로 설치 프로그램 설치 를 설정합니다.

구성 가이드: GPT-5.4 및 Claude 4.6을 핵심 모델로 설정하기

설치가 완료되면 다음을 실행합니다. 오픈클로 온보드 를 클릭하여 구성 마법사를 시작합니다. 이 대화형 도구를 사용하면 API 제공업체를 연결하고 기본 모델을 선택할 수 있습니다.

2026년 3월, GPT-5.4 는 에이전트 워크플로우에 권장되는 모델입니다. 이제 OpenClaw는 기본적으로 GPT-5.4 “도구 검색” 기능을 지원합니다. 이 메커니즘을 통해 에이전트는 시스템 프롬프트에 도구 정의를 미리 로드하지 않고 필요에 따라 가져올 수 있으므로 토큰 소비를 47% 줄일 수 있습니다.

이 기능을 사용하려면 openclaw.json config:

OpenClaw 비용은 얼마인가요? GlobalGPT로 API 지출 줄이기

OpenClaw와 같은 연중무휴 AI 에이전트를 운영하는 데는 많은 비용이 들 수 있습니다. 공식 OpenAI를 사용하면 GPT-5.4 가격 1M 입력 토큰당 $2.50, 1M 출력 토큰당 $15로 수백 개의 백그라운드 작업을 수행하는 프로액티브 에이전트는 일주일에 $100 이상의 비용을 쉽게 지불할 수 있습니다.

GlobalGPT 는 통합 구독 모델을 제공하여 이러한 재정적 병목 현상을 해결합니다. 여러 제공업체에 비용을 지불하는 대신 GlobalGPT의 $5.8 기본 요금제를 사용하여 액세스할 수 있습니다:

• ChatGPT 5.4(도구 검색에 최적화)
• Claude 4.6(코딩 및 로직에 적합)
• Gemini 3.1(1M+ 컨텍스트 창)
• 퍼플렉서티(실시간 웹 검색)

동영상 또는 고급 이미지가 필요한 크리에이티브 에이전트의 경우, 글로벌GPT 프로 요금제($10.8)가 필수이며, 이를 통해 Sora 2 Flash, Veo 3.1 및 Midjourney와 같은 도구를 OpenClaw 명령을 통해 직접 트리거할 수 있습니다.

보안 모범 사례: OpenClaw는 로컬 파일에 안전한가요?

보안은 OpenClaw 설치 튜토리얼에서 가장 중요한 구성 요소입니다. 게이트웨이는 셸 명령을 실행하고 로컬 파일을 수정할 수 있는 권한을 가지고 있기 때문에 중요한 공격 표면을 나타냅니다. 2026 업데이트부터 프레임워크는 “기본적으로 보안” 태세로 전환되었지만, 샌드박스 탈출 및 무단 데이터 유출을 방지하기 위해 사용자는 다음 세 가지 방어 계층을 수동으로 적용해야 합니다.

1. exec.ask를 통해 HITL(휴먼 인 더 루프)을 구현합니다.

가장 중요한 방어 메커니즘은 HITL(Human-in-the-Loop) 계층입니다. 기본적으로 openclaw.json 설정은 파괴 명령의 자동 실행을 방지하도록 설정되어 있습니다.

• 명령 승인: 설정 "exec.ask": "on" 를 설정하세요. 이렇게 하면 상담원이 터미널 스크립트를 실행하거나 파일에 쓰기 전에 채팅 인터페이스(WhatsApp/Discord)를 통해 일시 중지하고 명시적인 “승인” 또는 “거부”를 요청해야 합니다.
• 도구 루프 감지: 이 기능은 에이전트가 API 토큰을 소모하거나 로컬 환경을 중단시킬 수 있는 무한 반복 도구 호출에 들어가는 것을 방지합니다.

2. 오픈클로 닥터와 함께하는 사전 예방적 감사

표준 건강 검진 대신 오픈클로 닥터 명령은 종합적인 보안 감사 도구로 작동합니다.

• 자격증명 유출 탐지: 의사가 환경 변수를 검사하고 .env 파일을 사용하여 GlobalGPT 또는 공식 API 키가 일반 텍스트로 기록되거나 상담원의 자체 추론 컨텍스트에 노출되지 않도록 합니다.
• 권한 감사: 게이트웨이가 불필요한 루트 권한 또는 sudo 권한으로 실행되고 있는지 확인합니다. 2026년에는 프롬프트 인젝션 공격이 발생할 경우 “폭발 반경'을 제한하기 위해 권한 없는 사용자로 OpenClaw를 실행할 것을 권장합니다.
• 네트워크 노출 확인: 제어 UI(포트 18789)가 127.0.0.1(로컬)이 아닌 0.0.0.0(공용)에 바인딩된 경우 도구에서 경고 메시지를 표시합니다.

3. 고급 격리: 도커 및 테일스케일 강화

프로덕션급 설정의 경우 로컬 바이너리 실행을 컨테이너화된 격리로 대체해야 합니다.

• 샌드박싱: Docker 컨테이너 내에서 OpenClaw를 실행하면 가상 장벽이 생성됩니다. 에이전트가 악의적인 프롬프트를 통해 감염되더라도 공격자는 매핑된 파일 외부의 파일에 액세스할 수 없습니다. /작업 공간 디렉터리로 이동합니다.
• 네트워크 강화: OpenClaw 대시보드를 인터넷에 직접 노출하지 마세요. 2026년 공식 문서에서는 Tailscale “서브” 모드를 사용할 것을 권장합니다. 이렇게 하면 게이트웨이 포트가 퍼블릭 웹에 노출되지 않고 개인 암호화된 터널을 통해 모든 개인 기기에서 에이전트에 안전하게 액세스할 수 있습니다.
• 기술 검증: 바이러스토탈과의 파트너십을 통해 OpenClaw는 이제 ClawHub에서 다운로드한 모든 타사 기술에 대해 자동으로 서명 검사를 수행하여 확인되지 않은 커뮤니티 플러그인에서 발견되는 공급망 위험을 완화합니다.

문제 해결: 일반적인 OpenClaw 설치 오류 및 수정 사항

설정 중에 문제가 발생하면 내장된 진단 엔진이 첫 번째 방어선이 됩니다. 간단히 실행하세요. 오픈클로 닥터 를 실행하세요. 이 도구는 노드 런타임 상태부터 API 자격 증명 유효성까지 19개 항목의 검사를 수행하며, 실행 시 많은 환경 충돌을 자동으로 복구할 수 있습니다. --수정 플래그.

수동 개입이 필요한 문제는 아래의 기술 해결 매트릭스를 참조하세요:

OpenClaw 배포를 위한 자주 묻는 질문(FAQ)

초기 설정 이후, 사용자는 하드웨어 최적화, 모델 인증, 데이터 지속성에 관한 구체적인 기술적 질문에 직면하는 경우가 많습니다. OpenClaw 에이전트. 다음은 OpenClaw 2026 공식 문서에 근거한 권위 있는 답변입니다.

라즈베리파이에서 OpenClaw를 실행할 수 있나요?

예. OpenClaw는 경량으로 설계되었습니다. 24시간 연중무휴 백그라운드 작동을 위해서는 2GB 이상의 RAM이 장착된 Raspberry Pi 4 또는 5가 권장됩니다. 64비트 OS를 사용해야 하며 Node.js 24가 설치되어 있는지 확인해야 합니다. 가장 안정적인 환경을 위해 ARM 아키텍처에 해킹 가능한(git) 설치를 사용하여 로그를 쉽게 검사하세요.

OpenClaw를 사용하려면 Claude Pro 또는 OpenAI 구독이 필요한가요?

아니요. Anthropic, OpenAI 또는 Google의 표준 API 키를 사용할 수 있습니다. 그러나 OpenClaw는 다음과 같은 OAuth도 지원합니다. 코딩 중심 모델 OpenAI 코덱스 및 Claude 구독을 위한 설정 토큰과 같은 다른 모델을 사용할 수 있습니다. 공식 구독이 너무 제한적이거나 비싸다고 생각되는 경우, GlobalGPT는 $5.8부터 모든 모델에 대한 통합 액세스 포인트를 제공하므로 여러 개의 공식 월별 요금이 필요하지 않습니다.

Windows 사용자에게 WSL2를 “강력히 권장”하는 이유는 무엇인가요?

네이티브 Windows 셸은 에이전트가 셸 명령을 실행하려고 할 때 콘솔 코드 페이지 불일치(텍스트 왜곡 발생) 및 권한 문제로 어려움을 겪는 경우가 많습니다. WSL2(Linux용 Windows 하위 시스템)는 OpenClaw의 주요 개발 대상인 네이티브 Linux 환경을 제공하여 모든 자동화 도구 및 기술과의 100% 호환성을 보장합니다.

내 데이터는 어디에 저장되며 어떻게 백업하나요?

OpenClaw는 데이터를 로컬에 보관합니다. 상태 디렉토리(자격 증명 및 세션)는 ~/.openclaw에, 작업 공간(메모리 및 에이전트 파일)은 ~/.openclaw/workspace에 있습니다. “AI의 마음”을 보호하려면 에이전트 작업 공간을 비공개 Git 리포지토리에 두는 것이 좋습니다. 상태 디렉터리에는 민감한 API 키가 포함되어 있으므로 커밋하지 마세요.

“프로필에 대한 자격 증명을 찾을 수 없습니다” 오류는 어떻게 해결하나요?

이는 일반적으로 게이트웨이 서비스(systemd/launchd)가 셸의 환경 변수를 상속하지 않을 때 발생합니다.

수정: API 키를 ~/.openclaw/.env에 직접 배치하세요.

프로 팁: 오픈클로 모델 상태를 사용하여 어떤 프로필이 활성화되어 있는지 확인하세요. GlobalGPT를 사용하는 경우, 통합 토큰이 관련 공급자 블록 아래의 openclaw.json 구성에 설정되어 있는지 확인하세요.