OpenClaw는 로컬 우선 에이전트 플랫폼으로, 사용자가 이미 사용 중인 채팅 앱과 연결됩니다. 따라서 어시스턴트는 질문에 답변하는 것 이상으로 실제 작업을 수행할 수 있습니다. 사용자 컴퓨터에서 실행되며, 도구를 호출하고 파일 및 워크플로우에 가깝게 유지되므로 “디지털 직원” 스타일의 자동화를 구축하는 데 이상적입니다.
이 가이드에서는 Novita의 API 를 사용하여 OpenClaw 내에서 Kimi K2.5를 실행하는 방법을 보여드리겠습니다. 이를 통해 설치부터 작동하는 Telegram 데모까지 빠르게 진행할 수 있습니다.
OpenClaw란 무엇인가?
OpenClaw는 사용자 컴퓨터에서 로컬로 실행되며 사용 중인 채팅 앱과 매끄럽게 통합되는 오픈 에이전트 플랫폼입니다. WhatsApp, Telegram, Discord, Slack 또는 Microsoft Teams 등, AI 어시스턴트는 항상 사용자가 있는 곳에 있습니다.
- 작동 방식: 채팅 앱을 위한 단일 게이트웨이
브라우저 탭에서 실행되는 대신, OpenClaw는 컴퓨터(또는 서버)에서 게이트웨이(Gateway) 프로세스로 실행됩니다. 이를 통해 WhatsApp, Telegram, Discord, iMessage 등 사용 중인 앱에서 에이전트와 대화할 수 있으며, 각 대화를 적절한 에이전트/세션으로 라우팅합니다.
- 컴퓨터에서 할 수 있는 작업
환경에 연결되어 있기 때문에, OpenClaw는 명령 실행, 파일 처리, 브라우저 제어, 도구와 상호 작용 등 실제 워크플로우를 수행할 수 있습니다. 따라서 전통적인 챗봇보다 "디지털 직원"에 가깝습니다.
- 스킬과 생태계
OpenClaw는 로컬 및 내장 스킬 시스템을 지원하며, ClawHub라는 공개 레지스트리를 통해 스킬을 발견하고 동기화할 수 있습니다. 이를 통해 연구, 운영, 코딩 등 특정 작업에 맞게 OpenClaw를 확장하기 쉽습니다.
왜 Kimi K2.5인가?
Kimi K2.5는 네이티브 멀티모달, 실제 도구 실행, 에이전트 기능을 단일 오픈 모델로 결합했기 때문에 OpenClaw 에이전트와 잘 어울립니다. 약 15T 혼합 비전-텍스트 토큰으로 훈련되어 브라우징, 증거 수집, 코드 생성, 시각적 이해 사이를 유연하게 이동할 수 있으며, 이는 장기적인 에이전트에게 정말 필요한 기능입니다.
- 장기 워크플로우를 위한 강력한 에이전트 벤치마크: 주요 에이전트 스위트에서 HLE-Full 50.2, BrowseComp 74.9, DeepSearchQA 77.1을 기록하며, BrowseComp에서 GPT-5.2 (65.8), Claude 4.5 Opus (57.8), **Gemini 3 Pro (59.2)**를 능가합니다. 반복적인 검색+개선 루프에 유용합니다.
- 리포지토리 수준 코딩에서 경쟁력, 다국어 강점: SWE-Bench Verified 76.8 및 SWE-Bench Multilingual 73.0으로 다중 파일 변경 및 혼합 언어 리포지토리에서 강점을 유지합니다.
- 개발 작업을 위한 실용적인 멀티모달 이해: MMMU Pro 78.5, OmniDocBench 1.5 88.8과 같은 최고 수준의 이미지 결과는 문서/다이어그램/UI를 읽는 데 도움이 되며, 비디오 추론(VideoMMMU 86.6, LongVideoBench 79.8)은 데모 및 녹화 분석에 유용합니다.
Novita에서는 OpenAI 호환 API를 통해 Kimi K2.5를 사용할 수 있으므로, 최소한의 구성으로 OpenClaw에 쉽게 연결할 수 있습니다.
OpenClaw 설치 방법
사전 요구 사항
시작하기 전에 다음이 있는지 확인하세요:
- Node 22+
- 인터넷에 연결된 터미널 (Windows의 경우 WSL2 권장)
OpenClaw 설치
- macOS / Linux / WSL2
curl -fsSL https://openclaw.ai/install.sh | bash
- Windows (PowerShell)
iwr -useb https://openclaw.ai/install.ps1 | iex
OpenClaw에서 Kimi K2.5 사용 방법
1단계: Novita API 키 가져오기
Novita에서 API 키를 생성하세요:
- 계정 생성 또는 로그인:
[https://novita.ai](https://novita.ai)를 방문하여 가입하거나 로그인하세요. - 키 관리로 이동: 로그인 후 "API Keys"를 찾으세요.
- 새 키 생성: “Add New Key” 버튼을 클릭하세요.
- 키를 즉시 저장: 생성된 키는 한 번만 표시되므로 즉시 복사하여 저장하세요.
2단계: OpenClaw 구성 마법사 실행
OpenClaw 구성 흐름을 시작합니다:
openclaw config
안내 흐름에서 다음 섹션을 구성하세요:
1. Workspace
- Local (this machine) 선택
2. Model
- 기본 모델: 직접 입력
- 설정:
novita/moonshotai/kimi-k2.5
novita/moonshotai/kimi-k2.5는 다음 형식을 따릅니다:
novita= 공급자 (novita);moonshotai/kimi-k2.5= 모델 IDNovita 웹사이트에서 사용 가능한 모델 ID를 찾을 수 있으며, 모델 ID를 다른 지원 모델로 교체할 수 있습니다 (
novita/공급자 접두사 유지).
3. Gateway
모든 설정을 기본값으로 유지하고 각 프롬프트에서 Enter를 눌러 계속 진행하세요.
4. Channels
- Configure/link 선택
- 채널 선택: Telegram (Bot API) 를 선택하고 Telegram Bot Token 입력
- Finished 입력
- DM 액세스 정책 구성: Pairing 선택
Telegram Bot Token을 얻는 방법?
Telegram에서 @BotFather를 검색하고 /newbot을 입력하여 새 봇을 만드세요.
5. Continue (마법사 완료)
3단계: Novita 공급자 구성 적용
OpenClaw는 OpenAI 호환 엔드포인트를 통해 Novita와 통합됩니다. OpenClaw 구성 파일을 엽니다:
구성 경로: ~/.openclaw/openclaw.json
open ~/.openclaw/openclaw.json
아래 구성 블록을 구성에 붙여넣으세요. 한 필드만 업데이트하세요:
"models": {
"providers": {
"novita": {
"baseUrl": "https://api.novita.ai/openai/v1",
"apiKey": "<your-api-key>", #Novita API 키로 설정
"api": "openai-completions",
"models": [
{
"id": "moonshotai/kimi-k2.5",
"name": "Kimi K2.5 (Novita)",
"reasoning": false,
"input": [
"text"
],
"cost": {
"input": 0,
"output": 0,
"cacheRead": 0,
"cacheWrite": 0
},
"contextWindow": 200000,
"maxTokens": 8192
}
]
}
}
},
4단계: 게이트웨이 시작 및 Telegram 페어링
OpenClaw 게이트웨이를 설치하고 다시 시작합니다:
openclaw gateway install
openclaw gateway restart
Telegram에서 페어링 코드를 표시하면 새 터미널에서 승인합니다:
openclaw pairing approve --channel telegram <your-pairing-code>
Telegram에서 OpenClaw 페어링 코드 표시
승인되면 Telegram 봇이 Novita가 제공하는 Kimi K2.5를 사용하여 로컬에서 실행 중인 OpenClaw 에이전트에 연결됩니다.
5단계: Telegram에서 빠른 확인
10초 동안 간단히 확인해 보세요:
- Telegram에서 다음 명령 실행:
/model(현재 모델로 Kimi K2.5가 표시되는지 확인)
- 간단한 메시지 보내기:
hello(정상 응답을 받는지 확인)
두 가지 모두 작동하면 Telegram에서 Novita + Kimi K2.5 기반의 실제 워크플로우(메시지 초안 작성, 정보 수집 어시스턴트, 고객 지원 자동화 등)를 실행할 준비가 된 것입니다.
결론
OpenClaw는 에이전트가 로컬에서 실행되고 사용 중인 채팅 앱을 통해 작동하도록 하여 실용성을 높입니다. 에이전트 워크플로우와 멀티모달 이해에 강점을 가진 Kimi K2.5와 함께 사용하면, 브라우징, 추론, 실제 작업을 종단간 실행하는 어시스턴트를 구축할 수 있습니다.
Novita의 OpenAI 호환 API를 사용하면 Kimi K2.5를 OpenClaw에 쉽게 연결할 수 있으며, 설정부터 작동하는 데모까지 단 몇 분 만에 완료할 수 있습니다.
Novita AI 는 개발자에게 사용하기 쉬운 API와 저렴하고 안정적인 GPU 인프라를 제공하여 AI 애플리케이션을 구축하고 확장할 수 있도록 하는 선도적인 AI 클라우드 플랫폼입니다.
자주 묻는 질문
OpenClaw는 무엇을 하나요?
OpenClaw는 자체 호스팅되는 오픈 소스 AI 에이전트/어시스턴트로, 채팅 앱(예: WhatsApp, Telegram, Discord, iMessage)을 AI 에이전트에 연결하고 설치된 “스킬”(확장 기능)을 통해 작업을 수행할 수 있게 합니다.
OpenClaw는 사용해도 안전한가요?
주의해서 실행한다면 안전할 수 있지만, "기본적으로 안전"하지는 않습니다. 보안 보고에 따르면 공개 스킬 생태계에 악성 스킬이 나타난 적이 있으며, 에이전트의 광범위한 권한으로 인해 신뢰할 수 없는 스킬을 설치하면 위험이 증가할 수 있습니다.
OpenClaw가 Moltbot인가요?
네, OpenClaw는 이전에 Moltbot(그리고 더 이전에는 Clawdbot)으로 알려졌던 프로젝트의 브랜드 변경입니다.
추천 읽을거리
