OpenClaw는 게이트웨이 프로세스를 통해 대화를 선택한 모델 제공자로 라우팅하여 이미 사용 중인 채팅 앱(Telegram/Discord/WhatsApp/iMessage 등)에 AI 에이전트를 연결할 수 있도록 도와줍니다.
이 튜토리얼에서는 Novita AI의 API를 사용하여 OpenClaw 내에서 GLM-5를 실행합니다. 이를 통해 빠르게 작동하는 Telegram 스타일 데모를 구축한 다음 통합 인터페이스를 변경하지 않고 사용량을 확장할 수 있습니다.
아직 키가 없다면 Novita 콘솔에서 Novita API 키를 생성하고 GLM-5 모델 페이지를 열어 모델 ID(
zai-org/glm-5)와 엔드포인트 형식을 확인하세요.
OpenClaw란 무엇인가?
OpenClaw는 개발자가 대규모 언어 모델(LLM)을 Telegram과 같은 실제 커뮤니케이션 채널에 빠르게 연결할 수 있도록 하는 오픈소스 AI 에이전트 프레임워크입니다. 모델 자체라기보다는 OpenClaw는 사용자 메시지를 선택한 LLM으로 라우팅하고, 구성을 관리하며, 간단한 CLI 워크플로를 통해 배포를 처리하는 오케스트레이션 계층 역할을 합니다. 백엔드 인프라를 처음부터 구축할 필요를 없애줌으로써 개발자가 강력한 모델을 몇 분 안에 프로덕션 준비가 완료된 AI 에이전트로 전환할 수 있게 해줍니다.
OpenClaw에 GLM-5를 선택해야 하는 이유
OpenClaw는 다단계 작업을 완료하고, 실제 통합 코드를 작성하며, 긴 채팅 세션 내에서 도구를 안정적으로 사용할 수 있는 모델과 가장 잘 작동합니다. GLM-5는 Agentic Engineering을 위해 설계되었으며, 그 벤치마크 기록이 이를 반영합니다.
- 업계 표준 평가에서 입증된 코딩 능력
GLM-5는 널리 사용되는 소프트웨어 엔지니어링 및 터미널 기반 코딩 벤치마크에서 오픈소스 최고 수준의 결과를 보고하며, 에이전트가 구성을 편집하거나 문제를 디버깅하거나 도구를 위한 '글루 코드’를 생성하는 OpenClaw 설정과 잘 맞습니다. - 다단계 벤치마크에서 강력한 에이전트/도구 성능
또한 도구 호출, 계획 수립 및 여러 단계에 걸친 실행을 강조하는 에이전트 지향 평가에서 오픈소스 순위를 선도합니다. 이는 에이전트 게이트웨이를 통해 실제 대화를 라우팅할 때 피해야 할 실패 모드와 정확히 일치합니다. - 긴 세션 신뢰성
GLM-5의 장기적 능력은 장기 운영 성능을 측정하는 벤치마크 주장에 의해 뒷받침되며, 이는 확장된 스레드와 간헐적인 사용자 응답에 걸쳐 작업을 유지해야 하는 채팅 앱 에이전트에 직접 매핑됩니다.
Novita AI에서 GLM-5는 간단한 사용량 기반 가격으로 제공됩니다: 입력 토큰 100만 개당 $1, 출력 토큰 100만 개당 $3.2입니다. 컨텍스트 캐싱을 활성화하면 캐시 읽기는 100만 토큰당 $0.2로, 반복 프롬프트와 장기 실행 에이전트 세션의 비용을 줄일 수 있습니다.
OpenClaw 설치 방법
하드웨어 / 환경 체크리스트
시작하기 전에 준비하세요:
- Node.js 22+
- 인터넷에 접속할 수 있는 머신 (Windows 사용자는 종종 WSL2 사용)
- 배포 선택: OpenClaw는 게이트웨이 노출 및 운영 관리 방식에 따라 로컬 머신 또는 클라우드 VM/컨테이너에서 실행할 수 있습니다.
OpenClaw 설치
참조 가이드와 동일한 설치 패턴을 따르세요:
- macOS / Linux / WSL2
curl -fsSL https://openclaw.ai/install.sh | bash
- Windows (PowerShell)
iwr -useb https://openclaw.ai/install.ps1 | iex
OpenClaw에서 GLM-5 사용하기
1단계: Novita API 키 받기
Novita에서 API 키를 생성합니다(일반적으로 한 번만 표시되므로 즉시 저장하세요). 참조 흐름:
- **https://novita.ai**에 방문하여 Novita 계정을 생성/로그인합니다.
- API 키로 이동합니다.
- 새 키 추가를 클릭합니다.
- 즉시 복사하여 저장합니다.
2단계: OpenClaw 구성 실행
구성 흐름을 시작합니다:
openclaw config
1. 작업공간
2. 모델
수동 입력을 선택한 다음 기본 모델 novita/zai-org/glm-5를 설정합니다:
novita/zai-org/glm-5는 참조 튜토리얼에서 사용된 “novita/<model-id>” 형식을 반영하며,novita는 제공자 접두사이고 나머지 부분은 Novita에서 보는 모델 ID입니다.Novita 웹사이트에서 사용 가능한 모델 ID를 찾을 수 있으며, 모델 ID를 다른 지원되는 모델로 교체할 수 있습니다(
novita/제공자 접두사 유지).
3. 게이트웨이
첫 실행 시 기본값을 유지하고 Enter를 눌러 계속합니다.
4. 채널
- 구성/링크 선택
- 채널 선택: Telegram (Bot API) 및 Telegram Bot Token 입력 (아래 가이드에 따라 @BotFather에서 가져오기)
- 완료 입력
- DM 액세스 정책 구성 및 페어링 선택
💡Telegram Bot Token 얻는 방법?
Telegram에서 @BotFather를 검색하고
/newbot을 입력하여 새 봇을 생성합니다. 새 봇 생성을 완료하면 봇 토큰을 받게 됩니다.
5. 계속 (완료)
3단계: Novita 제공자 구성 적용 (GLM-5)
OpenClaw는 OpenAI 호환 엔드포인트를 통해 Novita와 통합할 수 있습니다. OpenClaw 구성 파일에 Novita를 제공자로 추가하겠습니다.
구성 파일 경로:~/.openclaw/openclaw.json
# 파일 열기:
open ~/.openclaw/openclaw.json
이제 아래 구성 블록을 구성 파일에 붙여넣으세요. 한 필드만 업데이트:<Your API Key> → 본인의 Novita API 키
"models": {
"providers": {
"novita": {
"baseUrl": "https://api.novita.ai/openai/v1",
"apiKey": "<Your API Key>",
"api": "openai-completions",
"models": [
{
"id": "zai-org/glm-5",
"name": "GLM-5 (Novita)",
"reasoning": false,
"input": [
"text"
],
"cost": {
"input": 0,
"output": 0,
"cacheRead": 0,
"cacheWrite": 0
},
"contextWindow": 200000,
"maxTokens": 8192
}
]
}
}
},
참고:
reasoning,cost,contextWindow,maxTokens필드는 선택 사항입니다. 생략하면 OpenClaw가 기본값을 문서화합니다.- Novita에서 GLM-5의 모델 ID는
zai-org/glm-5입니다. 원하는 모델로 변경할 수도 있습니다.
4단계: 게이트웨이 시작
OpenClaw 게이트웨이를 설치하고 다시 시작합니다:
openclaw gateway install
openclaw gateway restart
5단계: Telegram 페어링
Telegram에서 생성한 봇을 열고 /start를 보냅니다. 봇이 페어링 코드를 제공하면 새 터미널에서 승인합니다:
openclaw pairing approve --channel telegram <your-pairing-code>
6단계: Telegram에서 빠른 확인 (10초)
Telegram에서 /model을 보내 활성 모델을 확인합니다.
결론
OpenClaw는 사용자가 이미 작업하는 곳(채팅 앱)에 에이전트를 배치할 수 있는 실용적인 게이트웨이를 제공하며, GLM-5는 강력한 에이전트 추론, 도구 호출 및 다단계 워크플로를 위한 긴 컨텍스트 지원을 제공합니다.
Novita AI의 API를 사용하면 최소한의 글루 코드로 GLM-5를 통합하고 데모가 프로덕션 워크로드로 전환됨에 따라 사용량을 확장할 수 있습니다.
Novita AI 는 개발자가 AI 애플리케이션을 구축하고 확장할 수 있도록 사용하기 쉬운 API와 저렴하고 안정적인 GPU 인프라를 제공하는 선도적인 AI 클라우드 플랫폼입니다.
자주 묻는 질문
OpenClaw는 무엇을 하나요?
OpenClaw는 사용자가 이미 사용하고 있는 채팅 앱(Telegram, Discord, WhatsApp, iMessage 등)을 항상 켜져 있는 어시스턴트에 연결하는 장기 실행 게이트웨이 프로세스를 실행합니다. 게이트웨이는 제어 평면 역할을 하여 채널, 세션 및 라우팅을 처리하므로 채팅 앱의 메시지를 올바른 에이전트 컨텍스트와 도구에 전달할 수 있습니다.
OpenClaw는 AI 에이전트인가요?
OpenClaw 자체는 모델이 아닙니다. 에이전트 런타임 + 게이트웨이로서 에이전트 세션을 호스팅하고 라우팅합니다. '지능’은 사용자가 구성한 모델에서 비롯되며, OpenClaw는 해당 모델이 메시징 채널, 도구 및 세션 전반에서 에이전트처럼 동작하도록 하는 배관을 제공합니다.
Clawdbot은 무료인가요?
네—Clawdbot은 OpenClaw의 이전 이름을 나타내며, 소프트웨어는 MIT 라이선스 하에 무료 및 오픈소스입니다. 실제 비용은 여기에 연결하는 것(모델/API 사용, 호스팅 및 활성화한 유료 도구/서비스)에서 발생합니다.
추천 자료
