킬로클로 사용법 (오픈클로 대체)

요약

이 가이드는 KiloClaw를 배포하고 사용하는 6가지 간단한 단계를 안내합니다: app.kilo.ai/claw에서 가입하고, 배포 유형을 선택하고, 채팅 플랫폼(Telegram, Discord, Slack 등)을 연결하고, AI 모델을 선택하고, 메모리 설정을 구성한 다음, AI 비서를 사용하기 시작하세요. 전체 과정은 60초 이내에 완료되며, 신규 사용자는 7일간 무료 컴퓨팅을 제공받습니다.

소개

KiloClaw는 AI 에이전트 세계를 휩쓴 OpenClaw의 호스팅 버전입니다. 23만 개 이상의 GitHub 스타와 50개 이상의 플랫폼에 연결할 수 있는 기능을 통해 개인 AI 비서를 배포하는 것이 그 어느 때보다 쉬워졌습니다.

이 튜토리얼에서는 KiloClaw를 처음부터 설정하는 전체 과정을 안내합니다. 이 튜토리얼을 마치면 선호하는 채팅 플랫폼에 연결된 완전한 기능을 갖춘 AI 비서를 통해 자동화, 연구 및 생산성 작업을 지원받을 수 있을 것입니다.

💡

AI 에이전트 워크플로우를 구축할 때 Apidog는 비서가 수행하는 API 호출을 테스트하고 디버깅하는 데 매우 유용합니다. Apidog의 통합 요청 검사기를 사용하여 디버깅 시간을 절약하세요.

버튼

사전 준비 사항

시작하기 전에 다음 사항을 확인하세요:

요구 사항	설명
Kilo 계정	app.kilo.ai에서 가입 (무료)
채팅 플랫폼 계정	다음 중 하나 이상: Telegram, Discord, Slack 등
AI API 키 (선택 사항)	자체 키를 사용하는 경우 Anthropic, OpenAI 또는 Google 키
웹 브라우저	Chrome, Firefox, Safari 또는 Edge

그게 전부입니다. 서버, Docker, 명령줄이 필요 없습니다.

1단계: KiloClaw 계정 생성

KiloClaw로 이동

브라우저를 열고 https://app.kilo.ai/claw를 방문하세요

로그인하거나 계정을 만들 수 있는 KiloClaw 랜딩 페이지가 나타납니다.

가입 절차

"시작하기" 또는 "가입"을 클릭합니다.
가입 방법을 선택합니다:

이메일 + 비밀번호
Google 계정
GitHub 계정

인증(이메일 또는 OAuth)을 완료합니다.

계정 설정

가입 후 Kilo 대시보드로 이동합니다. Kilo를 처음 사용하는 경우:

이름 또는 표시 이름을 입력합니다.
(선택 사항) 프로필 사진을 추가합니다.
서비스 약관에 동의합니다.

이제 첫 번째 KiloClaw 인스턴스를 생성할 준비가 되었습니다.

2단계: 배포 유형 선택

KiloClaw는 사용자 경험 수준에 맞는 세 가지 배포 옵션을 제공합니다:

옵션 A: 빠른 시작 (초보자에게 권장)

비서를 실행하는 가장 빠른 방법:

✓ 사전 구성된 기본값
✓ 모든 인기 플랫폼 활성화
✓ 기본 모델 선택됨
✓ 표준 메모리 설정

배포 시간: ~30초

옵션 B: 사용자 지정 배포

원하는 바를 아는 사용자를 위한 옵션:

플랫폼 선택: 연결할 특정 플랫폼을 선택합니다.
모델 선택: 선호하는 AI 모델을 선택합니다.
메모리 구성: 대화 기록 제한을 설정합니다.
기능 조정: 특정 AgentSkills를 활성화/비활성화합니다.

배포 시간: ~60초

옵션 C: 구성 가져오기

기존 OpenClaw 사용자를 위한 옵션:

자체 호스팅 OpenClaw에서 구성을 내보냅니다.
구성 파일을 업로드합니다.
KiloClaw는 설정을 호스팅 환경에 매핑합니다.

배포 시간: ~45초

권장 사항:

3단계: 채팅 플랫폼 연결

이것이 KiloClaw의 강점입니다. AI 비서를 이미 사용 중인 플랫폼에 연결합니다.

지원되는 플랫폼

플랫폼	인증	설정 시간
텔레그램	봇 토큰	2분
디스코드	봇 토큰 + 서버 초대	3분
슬랙	OAuth 설치	3분
왓츠앱	QR 코드 페어링	2분
마이크로소프트 팀즈	OAuth + 관리자 동의	5분
시그널	전화번호 + 인증	2분
매트릭스	액세스 토큰	3분

플랫폼 설정 둘러보기

텔레그램 (가장 인기)

KiloClaw 대시보드에서 "플랫폼 추가" → "텔레그램"을 클릭합니다.
텔레그램을 열고 @BotFather에게 메시지를 보냅니다.
새 봇을 생성합니다: /newbot
봇 토큰을 복사합니다.
토큰을 KiloClaw에 붙여넣습니다.
"연결"을 클릭합니다.
봇과 채팅을 시작합니다!

텔레그램 봇 토큰 형식: 1234567890:ABCdefGHIjklMNOpqrsTUVwxyz

디스코드

디스코드 개발자 포털로 이동합니다.
새로운 애플리케이션을 생성합니다.
애플리케이션에 봇을 추가합니다.
봇 토큰을 복사합니다.
KiloClaw에서 토큰을 붙여넣고 서버를 지정합니다.
필요한 권한을 설정합니다:

메시지 읽기
메시지 보내기
메시지 관리 (선택 사항)

초대 링크를 생성하고 봇을 서버에 추가합니다.

슬랙

api.slack.com에서 슬랙 앱을 생성합니다.
봇 토큰 범위 활성화:

chat:write
channels:read
im:write

앱을 작업 공간에 설치합니다.
봇 사용자 OAuth 토큰을 복사합니다.
KiloClaw에 붙여넣습니다.

여러 플랫폼 연결

KiloClaw는 여러 플랫폼에 동시에 연결하는 것을 지원합니다. AI 비서는 연결된 모든 채널에서 접근할 수 있습니다:

예시 설정:
├── 텔레그램: @MyAIAssistant
├── 디스코드: MyServer 내 #ai-assistant
├── 슬랙: 작업 공간 내 @ai-assistant
└── 왓츠앱: +1-555-AI-HELP

모든 플랫폼은 동일한 메모리와 컨텍스트를 공유하며, 마법처럼 작동합니다!

4단계: AI 모델 선택

KiloClaw는 비서가 생각하는 방식을 유연하게 선택할 수 있도록 합니다.

옵션 A: Kilo 게이트웨이 모델

Kilo의 통합 게이트웨이를 통해 500개 이상의 모델에 접근합니다:

모델 카테고리		최적의 사용 사례
추론	Claude 4 Opus, GPT-4.5	복잡한 문제 해결
균형	Claude 3.5 Sonnet, GPT-4o	일반적인 작업
빠른 속도	GPT-4o-mini, Claude 3 Haiku	빠른 응답
코딩	Claude 4.5 Code, Codex	개발 작업
비전	Claude 4 Vision, GPT-4V	이미지 이해

가격: Kilo Gateway 요율에 따라 토큰당 지불 (추가 수수료 없음)

옵션 B: 자체 키 사용

기존 API 키 사용:

"자체 키 사용"을 클릭합니다.
제공자 선택: Anthropic, OpenAI 또는 Google
API 키를 붙여넣습니다.
해당 제공자의 모델을 선택합니다.
저장합니다.

귀하의 API 키는 Kilo의 인프라를 통해 안전하게 저장되고 프록시됩니다. 로컬 환경에는 절대 닿지 않습니다.

모델 선택 팁

Claude 3.5 Sonnet으로 시작: 기능과 비용의 훌륭한 균형을 제공합니다.
작업별로 전환: 다양한 사용 사례에 맞춰 다양한 구성을 생성합니다.
간단한 작업에는 빠른 모델 사용: 복잡한 추론에는 Opus/GPT-4를 아껴두세요.

5단계: 메모리 및 기본 설정 구성

KiloClaw의 가장 강력한 기능 중 하나는 영구 메모리입니다. 비서는 세션 간에 컨텍스트를 기억합니다.

메모리 설정

설정	설명	기본값
대화 기록	유지할 메시지 수	100개
사용자 기본 설정	사용자 설정 기억	활성화됨
컨텍스트 창	요청당 컨텍스트 양	제공자 제한
메모리 형식	영구 저장을 위한 마크다운 파일	활성화됨

사용자 지정 지침

비서의 동작을 정의하는 시스템 프롬프트를 설정합니다:

당신은 다음 분야에 특화된 유용한 AI 비서입니다:
- 소프트웨어 개발 및 코드 검토
- 연구 및 사실 확인
- 이메일 및 문서 작성

간결하고 정확하며 능동적으로 행동하세요. 불확실할 때는 명확하게 질문하세요.

개인 정보 보호 제어

비서가 접근할 수 있는 항목을 구성합니다:

읽기 권한: 어떤 플랫폼에서 읽을 수 있습니까?
쓰기 권한: 어떤 플랫폼에서 응답할 수 있습니까?
도구 접근: 어떤 기능이 활성화됩니까?
데이터 보존: 기록은 얼마나 오래 보관됩니까?

6단계: 배포 및 사용 시작

인스턴스 시작

모든 설정을 구성한 후:

"KiloClaw 배포"를 클릭합니다.
프로비저닝을 기다립니다 (~30초).
"인스턴스 실행 중" 상태를 확인합니다.
채팅을 시작합니다!

첫 대화

연결된 플랫폼에서 메시지를 보냅니다:

당신: 안녕하세요! 무엇을 도와드릴까요?

KiloClaw: 안녕하세요! 저는 귀하의 개인 AI 비서입니다. 다음을 도와드릴 수 있습니다:
- 연구 및 정보 수집
- 이메일, 문서 및 코드 작성
- 일정 관리 및 알림
- 연결된 앱 전반의 자동화
- 그 외 다양한 기능!

오늘은 무엇을 도와드릴까요?

KiloClaw AI 비서 사용하기

이제 실행 중이므로 다음과 같은 방법으로 상호 작용할 수 있습니다:

기본 명령어

명령어	설명
`help`	사용 가능한 명령어 표시
`status`	현재 구성 표시
`memory`	비서가 귀하에 대해 기억하는 내용 표시
`reset`	대화 기록 지우기

작업 예시

연구 작업

당신: AI 에이전트의 최신 개발 동향을 조사하고 주요 트렌드를 요약해 주시겠어요?

KiloClaw: [웹 조사 수행, 결과 종합, 요약 제시]

코드 지원

당신: REST API에서 오류 처리를 포함하여 데이터를 가져오는 Python 함수를 작성해 주세요.

KiloClaw: [적절한 오류 처리가 포함된 잘 주석 처리된 코드 제공]

자동화

당신: 매일 오전 9시에 풀 리퀘스트를 검토하라고 알려주세요.

KiloClaw: [예약된 알림 작업 설정]

음성 상호 작용

활성화된 경우 비서에게 말을 겁니다:

macOS: 시스템 마이크를 통한 네이티브 통합
iOS/Android: 모바일 앱 통합
전화: Twilio 통합을 통한 음성 통화

고급 구성

AgentSkills (100개 이상의 사전 구축된 기능)

KiloClaw에는 일반적인 작업을 위한 사전 구성된 스킬이 포함되어 있습니다:

카테고리	스킬
개발	코드 검토, 디버깅, 문서화
생산성	캘린더, 이메일, 메모 작성
연구	웹 검색, 데이터 추출
자동화	예약된 작업, 웹훅
커뮤니케이션	초안 작성, 번역, 요약

대시보드 설정에서 스킬을 활성화/비활성화합니다.

사용자 지정 도구

고급 사용자는 사용자 지정 기능을 추가할 수 있습니다:

JSON 스키마 형식으로 도구 정의를 생성합니다.
도구 로직을 구현합니다 (Python, JavaScript).
KiloClaw 대시보드에 도구를 등록합니다.
대화에서 사용하기 시작합니다.

웹훅

KiloClaw를 외부 서비스에 연결합니다:

{
  "trigger": "new_lead_form",
  "action": "notify_slack",
  "payload": "{{form_data}}"
}

자동화된 작업 예약

KiloClaw는 반복 작업에 대한 Cron 스타일 예약을 지원합니다.

예약된 작업 설정

"자동화" → "예약된 작업"으로 이동합니다.
"작업 추가"를 클릭합니다.
구성:

필드	예시
이름	일일 스탠드업 요약
일정	`0 9 * * 1-5` (주중 오전 9시)
작업	정의된 워크플로우 실행
알림	슬랙 #standup에 게시

일반적인 예약된 자동화

일일 브리핑: 캘린더, 이메일, 작업을 요약합니다.
주간 보고서: 분석 및 지표를 취합합니다.
모니터링: API 상태를 확인하고 실패 시 경고합니다.
데이터 동기화: 서비스 간 데이터 가져오기/내보내기.

Cron 표현식 참조

┌───────────── 분 (0-59)
│ ┌───────────── 시 (0-23)
│ │ ┌───────────── 월의 일 (1-31)
│ │ │ ┌───────────── 월 (1-12)
│ │ │ │ ┌───────────── 요일 (0-6)
│ │ │ │ │
* * * * *

인스턴스 관리

대시보드 제어

KiloClaw 대시보드에서:

작업	설명
시작/중지	인스턴스 일시 중지 또는 재개
재시작	강제 재시작 (대부분의 문제 해결)
로그 보기	활동 및 오류 로그 확인
업데이트	최신 KiloClaw 버전 적용
삭제	인스턴스 영구 제거

사용량 모니터링

KiloClaw 사용량 추적:

사용된 API 토큰: 모델별 세부 분석
처리된 메시지: 일별/주간 개수
활성 플랫폼: 연결 상태
실행 시간: 사용된 컴퓨팅 시간

스케일 업

더 높은 사용량을 위해:

전용 인스턴스로 업그레이드
팀원 추가
엔터프라이즈 기능 활성화

일반적인 문제 해결

봇이 응답하지 않음

증상: 메시지를 보냈지만 응답이 없음

해결 방법:

대시보드에서 플랫폼 연결 상태를 확인합니다.
봇에 필요한 권한이 있는지 확인합니다.
인스턴스를 재시작합니다.
로그에서 오류를 확인합니다.

속도 제한

증상: "요청이 너무 많습니다" 오류

해결 방법:

속도 제한 시간이 초기화될 때까지 기다립니다.
더 빠른 모델로 전환합니다.
메시지 전송 빈도를 줄입니다.

메모리 문제

증상: 비서가 컨텍스트를 잊거나 반복합니다.

해결 방법:

구성에서 메모리 설정을 늘립니다.
비서에게 컨텍스트를 수동으로 상기시킵니다.
사용 중인 모델의 사용 가능한 컨텍스트 창을 확인합니다.

플랫폼 연결 오류

증상: 플랫폼 연결에 "실패" 메시지

해결 방법:

인증 자격 증명을 확인합니다.
플랫폼 API 상태를 확인합니다.
토큰/키를 재생성합니다.
대시보드에서 플랫폼을 다시 연결합니다.

모범 사례

보안

최소 권한 사용: 필요한 플랫폼만 활성화합니다.
정기적인 키 순환: API 키를 주기적으로 업데이트합니다.
활동 모니터링: 의심스러운 행동에 대해 로그를 검토합니다.
기능 제한: 사용하지 않는 AgentSkills를 비활성화합니다.

성능

적절한 모델 선택: 간단한 작업에는 빠른 모델을 사용합니다.
합리적인 제한 설정: 무제한 기록을 유지하지 않습니다.
지능적인 예약: 비수기 시간에 무거운 작업을 실행합니다.

사용자 경험

명확한 지침 설정: 비서의 역할을 명확하게 정의합니다.
철저한 테스트: 모든 플랫폼이 예상대로 작동하는지 확인합니다.
피드백 수집: 사용자에게 개선 사항을 요청합니다.
반복: 간단하게 시작하고 필요에 따라 복잡성을 추가합니다.

결론

KiloClaw는 강력한 개인 AI 비서를 누구나 쉽게 배포할 수 있도록 합니다. 60초 이내에 50개 이상의 플랫폼에 연결되고 500개 이상의 모델로 구동되는 AI 에이전트를 통해 자동화, 연구 및 생산성 작업을 처리할 수 있습니다.

7일 무료 체험 기간 동안 기능을 충분히 탐색할 수 있습니다. 빠른 시작 배포로 시작한 다음, 필요에 가장 적합한 것을 파악하면서 사용자 지정하세요.

다음 단계:

버튼

자주 묻는 질문

KiloClaw 설정에 얼마나 걸립니까?

전체 과정은 빠른 시작 배포로 60초 이내에 완료됩니다. 플랫폼 추가는 인증 요구 사항에 따라 각 2-5분 정도 소요됩니다.

KiloClaw를 사용하려면 코딩 기술이 필요합니까?

아니요. KiloClaw는 비기술 사용자를 위해 설계되었습니다. 코딩은 고급 사용자 지정 도구에만 필요하며, 이는 선택 사항입니다.

KiloClaw를 무료로 사용할 수 있습니까?

예. 신규 사용자는 7일간 무료 컴퓨팅을 제공받습니다. 그 후에는 Kilo Gateway 요율에 따라 컴퓨팅 시간과 AI 토큰에 대해 추가 수수료 없이 지불합니다.

여러 채팅 플랫폼을 어떻게 연결합니까?

KiloClaw 대시보드에서 "플랫폼"으로 이동하여 각 플랫폼을 하나씩 추가합니다. 각 플랫폼에는 자체 인증 절차(봇 토큰, OAuth 등)가 있습니다.

자체 API 키를 사용할 수 있습니까?

예. KiloClaw는 Anthropic, OpenAI, Google 또는 OpenAI 호환 API에서 자체 키를 사용하는 것을 지원합니다.

인스턴스가 충돌하면 어떻게 됩니까?

KiloClaw는 충돌한 인스턴스를 자동으로 재시작합니다. 필요한 경우 대시보드에서 수동으로 재시작할 수도 있습니다.

자동화된 작업을 예약할 수 있습니까?

예. KiloClaw는 반복 일정으로 실행되는 자동화된 워크플로우에 대한 Cron 스타일 예약을 지원합니다.

KiloClaw 인스턴스를 어떻게 삭제합니까?

대시보드 → 설정 → 인스턴스 삭제로 이동합니다. 이 작업은 인스턴스와 모든 관련 데이터를 영구적으로 제거합니다.