NovitaClaw: 단일 명령으로 클라우드에서 OpenClaw 실행하기

Andrej Karpathy는 최근 주목할 만한 변화를 언급했습니다. LLM 에이전트가 LLM 위에 새로운 계층으로 등장한 것처럼, Claw는 에이전트 위의 다음 계층으로서 오케스트레이션, 스케줄링, 컨텍스트, 도구 호출 및 지속성을 에이전트 단독으로는 불가능한 수준으로 끌어올립니다.

이 계층에는 항상 가동되는 인프라가 필요합니다. Novita Sandbox에서 OpenClaw를 실행하는 개발자들은 지금까지 세션 제한을 피해 수동으로 작업해야 했습니다.

NovitaClaw가 그 격차를 해소합니다. Novita Agent Sandbox의 새로운 배포 도구로, 단일 명령으로 완전히 구성된 OpenClaw 인스턴스를 프로비저닝하며, 런타임 제한, 수동 재시작, 수명 주기 관리 오버헤드가 없습니다.

CLI가 해결하는 문제

Novita Agent Sandbox는 Sandbox 템플릿을 통해 OpenClaw 배포를 지원해 왔습니다. 이 방식은 탐색에 적합하지만, UI를 통해 생성된 샌드박스에는 세션 수명 제한이라는 엄격한 제약이 있습니다. 몇 시간 후면 샌드박스가 중지되고 에이전트가 오프라인 상태가 됩니다. 지속적인 가용성이 필요한 개발자는 일시 중지 스케줄링, 재시작 스크립팅, 인스턴스 수동 복구 등 직접 해결해야 했습니다.

NovitaClaw는 다르게 작동합니다. 세션 제한이 없습니다. 인스턴스는 필요할 때까지 24시간 내내 실행됩니다. 기본 사양(2 vCPU, 4GB RAM)은 데모가 아닌 실제 워크로드를 위해 설계되었습니다. 모델 레이어는 완전히 구성 가능하므로, Novita에서 호스팅하든 타사 제공업체에서 가져오든 에이전트를 구동할 LLM을 직접 선택할 수 있습니다.

시작하기

사전 요구사항

• Python 설치
• Novita API 키 — 획득 방법:
  • novita.ai에 로그인 — Google 또는 GitHub로 로그인(첫 로그인 시 새 계정이 자동 생성됨)하거나 이메일 주소로 가입
  • API 키 생성 — Key Management 설정 페이지로 이동하여 API 키를 생성하거나 관리합니다. 다음 단계에서 필요하므로 안전한 곳에 복사하세요.

python3 --version

sudo apt update && sudo apt install python3 python3-pip -y

설치 및 실행

1단계: NovitaClaw 설치

macOS / Linux:

sudo pip3 install novitaclaw

Windows PowerShell:

pip install novitaclaw

이전 버전이 설치되어 있다면 최신 버전으로 업그레이드:

Bash

pip3 install novitaclaw --upgrade

업그레이드가 실패하면 강제 재설치 시도:

Bash

pip3 install novitaclaw --upgrade --force-reinstall

설치 후 novitaclaw --help를 입력하여 확인하세요. 명령어 목록이 표시되면 성공입니다!

macOS / Linux:

export NOVITA_API_KEY=sk_your_api_key

Windows PowerShell:

$env:NOVITA_API_KEY = "sk_your_api_key"

3단계: 인스턴스 실행

novitaclaw launch

성공 시 CLI는 에이전트에 액세스하고 관리하는 데 사용할 세 가지 값을 반환합니다:

• Web UI URL
• Gateway WebSocket URL & 토큰
• Web Terminal URL (샌드박스에 터미널 액세스용)
• File Manager URL (작업 공간 파일 탐색 및 관리용)
• 로그인 자격 증명 (Web Terminal 및 File Manager용)

반환된 Web UI URL을 열고 Chat 탭으로 이동하여 에이전트를 사용하세요. Web Terminal URL을 사용하여 샌드박스 내부의 터미널 세션을 열고, File Manager URL을 사용하여 샌드박스 작업 공간의 파일을 탐색하고 관리할 수 있습니다.

모델 구성

인스턴스는 기본적으로 Novita에서 호스팅하는 모델이 사전 구성되어 있습니다.

에이전트가 사용하는 모델을 변경하려면 Settings → Config로 이동하여 Raw를 클릭해 Raw JSON5 보기로 전환한 다음, “2 secrets redacted” 옆의 reveal 버튼을 클릭하여 전체 구성을 확인하세요. 다음 두 섹션을 업데이트합니다:

1단계: 제공업체 아래에 모델 등록

models.providers.novita 내의 models 배열에 새 객체를 추가:

"models": [
  {
    "id": "model-id",
    "name": "표시 이름",
    "reasoning": true,
    "input": ["text"],
    "contextWindow": 200000,
    "maxTokens": 50000
  }
]

2단계: 기본 또는 폴백으로 설정

agents.defaults 아래의 model 필드를 provider/model-id 형식으로 모델을 참조하도록 업데이트:

"agents": {
  "defaults": {
    "model": {
      "primary": "provider/model-id",
      "fallbacks": [
        "provider/model-id"
      ]
    }
  }
}

Update를 클릭하여 저장합니다. Novita 플랫폼에서 사용 가능한 모든 LLM이 지원됩니다. 타사 제공업체도 구성할 수 있습니다. 자체 LLM을 가져오면 샌드박스 런타임 비용만 지불하고 Novita 모델 사용 비용은 청구되지 않습니다.

Claw가 실행 중입니다. 이제 더 똑똑하게 만들어 보세요.

BotLearn은 세계 최초의 Bot 대학입니다. OpenClaw 위에 기본적으로 구축된 학습 및 유통 레이어입니다. Bots는 배우고, 인간은 수익을 얻습니다. 에이전트는 구조화된 스킬, 벤치마킹 및 작업을 완료하여 실제 돈을 버는 Agent-to-Agent 마켓플레이스인 Botcord에 액세스할 수 있습니다.

에이전트를 등록하려면 다음 메시지를 보내기만 하면 됩니다:

“이것은 내가 당신이 가입하길 원하는 Bot University입니다. https://www.botlearn.ai/SKILL.md를 읽고 지침에 따라 BotLearn에 가입하세요. 설치 중 보안 문제가 발생하면 진행하기 전에 각 단계를 확인해 주세요.”

에이전트가 나머지를 처리합니다.

채널 연결

OpenClaw는 외부 메시징 채널을 지원하므로 Web UI 외부에서도 에이전트에 접근할 수 있습니다. 채널은 기본적으로 활성화되어 있지 않으며 구성이 필요합니다.

Telegram

1단계: Telegram 봇 생성

1. Telegram을 열고 @BotFather를 검색
2. /newbot을 보내고 프롬프트에 따라 봇 이름 지정
3. BotFather가 제공하는 봇 토큰 복사

2단계: Chat 탭에 봇 토큰 보내기

Web UI에서 Chat 탭으로 이동하여 봇 토큰을 보냅니다.

3단계: Telegram 봇 페어링 및 사용

Telegram에서 생성한 봇을 열고 /start를 보냅니다. 코드를 복사하여 Chat 탭에 붙여넣습니다.

연결되면 Telegram 봇으로 보낸 메시지가 OpenClaw 에이전트로 직접 라우팅됩니다. 더 많은 채널 통합이 지원됩니다. 전체 목록과 설정 지침은 공식 OpenClaw 채널 가이드를 참조하세요.

서비스 안정성

샌드박스의 모든 핵심 서비스는 프로덕션 등급 안정성을 위해 systemd로 관리됩니다:

충돌 자동 복구: Gateway가 반복적으로 충돌하면 시스템이 자동으로 진단을 실행하고, 복구를 시도하며, 백업에서 마지막으로 알려진 올바른 구성을 복원합니다. 수동 개입이 필요하지 않습니다.

구성 자동 백업: 모든 구성 쓰기 시 자동 백업이 생성됩니다. 잘못된 구성으로 인해 충돌이 발생하면 복구 프로세스가 가장 최근의 유효한 백업에서 복원합니다.

명령어 참조

launch

새로운 샌드박스 인스턴스를 생성합니다.

Bash

novitaclaw launch [옵션]

list

활성 샌드박스 인스턴스 목록을 표시합니다.

Bash

novitaclaw list --api-key YOUR_API_KEY

status

샌드박스 인스턴스 상태를 확인합니다.

Bash

novitaclaw status <SANDBOX_ID> --api-key YOUR_API_KEY

stop

샌드박스 인스턴스를 종료합니다.

Bash

novitaclaw stop <SANDBOX_ID> --api-key YOUR_API_KEY

tui

터미널 UI를 통해 샌드박스에 연결합니다.

Bash

novitaclaw tui <SANDBOX_ID> --token <GATEWAY_TOKEN>

doctor

샌드박스 인스턴스에 대한 진단 및 복구 검사를 실행합니다.

Bash

novitaclaw doctor <SANDBOX_ID> --api-key YOUR_API_KEY

gateway update

샌드박스 내부의 OpenClaw를 최신 버전으로 업데이트합니다.

Bash

novitaclaw gateway update <SANDBOX_ID> --api-key YOUR_API_KEY

gateway restart

샌드박스에서 OpenClaw Gateway를 재시작합니다.

Bash

novitaclaw gateway restart <SANDBOX_ID> --api-key YOUR_API_KEY

services setup

기존 샌드박스에 Web Terminal 및 File Manager를 설치하고 시작합니다. 이러한 서비스가 포함되기 전에 실행된 이전 샌드박스에 서비스를 추가하려면 사용하세요.

Bash

novitaclaw services setup <SANDBOX_ID> --api-key YOUR_API_KEY

pair list

채널의 대기 중인 페어링 요청을 나열합니다.

Bash

novitaclaw pair list <SANDBOX_ID> --channel <CHANNEL_NAME> --api-key YOUR_API_KEY

pair approve

채널의 페어링 요청을 승인합니다.

Bash

novitaclaw pair approve <SANDBOX_ID> --channel <CHANNEL_NAME> --code <PAIRING_CODE> --api-key YOUR_API_KEY

update

CLI 업데이트를 확인하고 최신 버전으로 업그레이드합니다.

Bash

novitaclaw update

프로그래매틱 사용

자동화를 위해 JSON 출력 사용:

Bash

novitaclaw -j launch --api-key YOUR_API_KEY

응답 예시:

{
  "success": true,
  "data": {
    "sandbox_id": "xxx",
    "webui": "https://xxx.sandbox.novita.ai?token=xxx",
    "gateway_ws": "wss://xxx.sandbox.novita.ai",
    "gateway_token": "xxx",
    "terminal_url": "https://7681-xxx.sandbox.novita.ai",
    "filemanager_url": "https://7682-xxx.sandbox.novita.ai",
    "services_username": "admin",
    "services_password": "xxx"
  }
}

환경 변수

가격

문제 해결

명령어를 찾을 수 없음

다음 중 하나를 시도해 보세요:

Bash

# 전체 경로 사용 (Linux)
~/.local/bin/novitaclaw launch

# 일반적인 macOS 사용자 경로
~/Library/Python/3.x/bin/novitaclaw launch

연결 시간 초과

런치 제한 시간 증가:

Bash

novitaclaw launch --timeout 180 --api-key YOUR_API_KEY

자주 묻는 질문

다음 레이어 구축

Karpathy가 설명한 변화 — 에이전트에서 Claw로의 전환 — 는 이론적이지 않습니다. 지금 당장 실현 가능한 아키텍처 기회이며, 지속적인 상시 가동 인프라를 구축하는 팀이 그 혜택을 누릴 것입니다.

NovitaClaw는 그 기반을 제공합니다: 프로덕션 등급의 에이전트 런타임, 1분 이내 배포, 모델 레이어 및 채널 통합에 대한 완전한 제어. 샌드박스는 가동 시간을 관리하고 CLI는 프로비저닝을 관리합니다. 그 위에 무엇을 구축할지는 사용자에게 달려 있습니다.

지금 Novita Agent Sandbox에서 구축 시작하기 →

Novita AI는 빌더와 스타트업을 위한 AI 및 Agent Cloud입니다. 단일 API로 200개 이상의 LLM, 이미지, 비디오, TTS 모델에 액세스할 수 있으며, GPU 인스턴스와 몇 초 만에 실행되는 Agent Sandbox를 제공합니다.