OpenClaw는 채팅 애플리케이션과 AI 에이전트 사이의 다리 역할을 하는 오픈소스 AI 에이전트 Gateway입니다. 중앙 집중식 Gateway 프로세스를 통해 Telegram, WhatsApp, Discord 등의 채팅 플랫폼을 AI 코딩 에이전트에 연결하여 채팅 창에서 직접 AI 프로그래밍 상호작용을 가능하게 합니다.
OpenClaw에서 EvoLink API를 커스텀 모델 제공자로 설정하고 Telegram Bot을 연결하면, Telegram에서 직접 EvoLink의 Claude 모델(Claude 4.6 Opus, Claude 4.5 Sonnet, Claude 4.5 Haiku 등)을 사용하여 AI 지원 코딩 대화를 할 수 있습니다.
이 가이드에서 다루는 내용:
- OpenClaw Gateway 설치 및 설정
- Telegram Bot 생성 및 OpenClaw 연결
- EvoLink API를 커스텀 모델 제공자로 설정
- 연결 확인 및 시작하기
사전 준비
설정하기 전에 다음 사항을 준비하세요:
1. Node.js 설치
OpenClaw는 npm을 통해 설치됩니다. 먼저 Node.js를 설치해야 합니다.
2. EvoLink API Key 발급
- EvoLink Dashboard에 로그인합니다
- 대시보드에서 API Keys를 찾아 ‘새 키 생성’ 버튼을 클릭한 후, 생성된 Key를 복사합니다
- API Key는 보통
sk-로 시작합니다
3. Telegram 계정 준비
Bot을 생성하고 통합을 테스트하는 데 필요합니다.
Step 1: OpenClaw 설치
터미널에서 다음 명령어를 실행합니다:
npm install -g openclaw@latest
Step 2: 온보딩
온보딩 명령어를 실행합니다. OpenClaw가 초기 설정을 안내하고 백그라운드 데몬 서비스를 설치합니다:
openclaw onboard --install-daemon
1. 설치 확인
시스템이 위험 고지 사항을 표시합니다. 확인하여 진행합니다:
2. 설치 모드 선택
설치 모드를 선택하라는 메시지가 표시되면 Quickstart를 선택합니다:
3. 제공자 선택
모델 제공자를 선택하라는 메시지가 표시되면 Skip을 선택합니다. 나중에 EvoLink를 커스텀 제공자로 수동 설정합니다:
4. 모델 선택
활성화할 모델을 선택하라는 메시지가 표시되면 All을 선택합니다:
5. 기본 모델 선택
기본 모델을 선택하라는 메시지가 표시되면 Keep current를 선택합니다:
Step 3: Telegram Bot 생성
온보딩 과정에서 채팅 채널을 선택하라는 메시지가 표시됩니다. **Telegram (Bot API)**를 선택합니다.
1. BotFather 방문
Telegram을 열고 @BotFather를 방문한 후, START BOT을 클릭하여 시작합니다:
2. Bot 생성
채팅에서 /start를 입력합니다. BotFather가 사용 가능한 명령어 목록을 응답합니다:
/newbot을 입력합니다. 안내에 따라 bot으로 끝나는 고유한 Bot 사용자 이름을 설정합니다 (예: my_evolink_bot).
생성이 완료되면 BotFather가 다음 형식의 Token이 포함된 메시지를 반환합니다:
123456789:ABCdefGHIjklMNOpqrsTUVwxyz
3. Token 입력
터미널의 온보딩 과정으로 돌아가서 Bot Token을 프롬프트에 붙여넣고 확인합니다:
4. Gateway 재시작
Token을 입력한 후, 설정을 적용하기 위해 Gateway를 재시작합니다:
Step 4: EvoLink API 설정
1. 설정 파일 찾기
OpenClaw 설치 디렉토리에서 openclaw.json 설정 파일을 찾아 편집용으로 엽니다:
2. 모델 제공자 설정
openclaw.json에서 models 필드를 찾아 EvoLink를 커스텀 모델 제공자로 추가합니다:
"models": {
"providers": {
"anthropic": {
"api": "anthropic-messages",
"baseUrl": "https://code.evolink.ai",
"apiKey": "your-evolink-api-key",
"models": [
{
"id": "claude-opus-4-6",
"name": "Claude Opus 4.6",
"reasoning": false,
"input": ["text"],
"cost": {
"input": 0,
"output": 0,
"cacheRead": 0,
"cacheWrite": 0
},
"contextWindow": 200000,
"maxTokens": 8192
}
]
}
}
}
3. 기본 모델 설정
agents 필드에서 model.primary를 방금 추가한 EvoLink 모델로 설정합니다:
"model": {
"primary": "anthropic/claude-opus-4-6"
}
4. Telegram 설정 확인
channels 필드에서 Telegram 설정을 확인합니다. botToken은 온보딩 과정에서 자동으로 입력되었으므로 변경할 필요가 없습니다:
"channels": {
"telegram": {
"enabled": true,
"botToken": "your-bot-token (auto-filled)",
"dmPolicy": "pairing",
"groups": { "*": { "requireMention": true } }
}
}
enabled: Telegram 채널 활성화dmPolicy: "pairing"으로 설정하면, 인증되지 않은 사용자가 DM을 보낼 때 페어링 코드를 통해 인증해야 합니다groups: "*"는 모든 그룹을 허용하며, requireMention을 true로 설정하면 그룹에서 @멘션할 때만 Bot이 응답합니다
Step 5: 연결 확인
1. Bot 방문
Telegram에서 방금 생성한 Bot 사용자 이름을 검색하고 채팅을 엽니다:
2. 페어링 코드 받기
Bot에 /start를 보냅니다. Bot이 페어링 코드를 반환합니다:
3. 페어링 완료
새 터미널 창을 열고 다음 명령어를 실행하여 페어링을 완료합니다:
openclaw pairing approve telegram <pairing-code>
<pairing-code>를 Bot이 반환한 실제 코드로 교체하세요. 꺾쇠괄호 <>를 반드시 제거하세요.
4. 연결 테스트
원래 터미널 창으로 돌아가서 다음을 입력하여 연결이 정상적으로 작동하는지 테스트합니다:
페어링이 완료되면 Telegram에서 Bot에 메시지를 보내도 AI 응답을 받을 수 있으며, 이는 통합이 성공적으로 완료되었음을 확인합니다.