워크플로 · 영상 게시 2026-02-07 · 5분 35초

Railway에 openclaw 배포하고 OpenRouter로 원하는 모델 쓰기

Railway 템플릿으로 openclaw를 클라우드에 배포하고, OpenRouter 키와 텔레그램 봇을 연결한 뒤 설정 파일에서 Kimi K2.5 같은 모델로 바꾸는 과정을 정리했습니다.

이 영상에서 단테는 openclaw를 Railway 템플릿으로 클라우드에 배포하고, OpenRouter를 연결해 Anthropic 모델 외에 원하는 모델(예: Kimi K2.5)을 쓰는 방법을 보여 줍니다. 텔레그램 봇 연동과 모델 설정 파일 수정까지 다루므로, openclaw를 클라우드에서 쓰면서 모델 선택 폭을 넓히고 싶은 사람에게 맞는 실습입니다.

왜 Railway로 옮겼나

단테는 이전 영상에서 Cloudflare 환경에 openclaw를 설치하는 방법을 소개했습니다. 그런데 Cloudflare가 제공하는 저장소를 기반으로 배포하다 보니 커스텀 모델 사용에 제한이 있었습니다. 새 모델이 나와도 별도 커밋이 반영돼야 쓸 수 있었고, 영상 게시 시점(2026-02-07) 기준으로 Kimi K2.5 지원 요청도 아직 반영되지 않은 상태였습니다. 그래서 OpenRouter 같은 경로로 여러 모델을 쓸 수 있는 클라우드 플랫폼을 찾았고, 그 답이 Railway였습니다.

Railway 템플릿으로 배포하기

Railway에서 openclaw를 검색하면 여러 템플릿이 나옵니다. 단테가 사용한 것은 설명란의 Railway openclaw 템플릿입니다.

  1. Railway 계정으로 로그인한 뒤 템플릿에서 Deploy Now를 누릅니다.
  2. 설정 화면이 열리면 대부분은 이미 채워져 있으므로, 사용할 비밀번호만 입력합니다.
  3. Deploy를 누르면 빌드가 시작되고, 배포가 끝나면 링크로 접속할 수 있습니다.
  4. 사용자 이름에 admin, 비밀번호에 앞서 설정한 값을 넣어 로그인합니다.

프로바이더와 텔레그램 봇 설정

로그인하면 셋업 화면이 나옵니다. 처음 로딩될 때는 프로바이더 그룹을 선택할 수 없으니 로딩이 끝날 때까지 기다립니다. 상태가 "not configured"로 바뀌면 프로바이더 그룹에서 OpenRouter를 고릅니다.

OpenRouter API 키는 OpenRouter에 로그인한 뒤 오른쪽 위 Keys 메뉴에서 새로 만들거나 기존 키를 재사용하면 됩니다. 키를 셋업 화면에 넣고 나머지 항목은 그대로 둡니다.

메신저 채널은 텔레그램, 디스코드, 슬랙 등을 연결할 수 있는데, 영상에서는 텔레그램을 예로 들었습니다.

  1. 텔레그램에서 BotFather와 대화를 열고 /newbot 명령을 입력합니다.
  2. 봇 이름과 고유한 사용자 이름을 정하면 토큰이 발급됩니다.
  3. 토큰을 openclaw 셋업 화면에 붙여 넣고 Run Setup을 누르면, 앞서 넣은 OpenRouter 키가 정상인지 함께 확인합니다.
  4. 텔레그램 연동은 페어링이 필요합니다. 만든 봇과 채팅을 시작하면 페어링 코드가 나오고, 셋업 화면의 페어링 항목에 채널 이름(telegram)과 그 코드를 입력하면 완료됩니다.

모델이 응답하지 않을 때: 설정 파일 수정

페어링까지 끝나도 처음에는 에이전트 실패가 날 수 있습니다. 모델이 OpenRouter의 auto로 지정돼 있기 때문입니다. 이를 고치는 순서는 다음과 같습니다.

  1. 셋업 화면에서 openclaw URL을 열면 게이트웨이 토큰이 없다는 메시지가 나옵니다.
  2. Railway 대시보드에서 게이트웨이 토큰을 복사해, openclaw의 Overview 탭에 입력합니다.
  3. Settings의 Config에서 폼 보기를 Raw로 바꾸면 전체 설정 파일을 JSON으로 볼 수 있습니다.
  4. auto로 지정된 모델 값을 원하는 OpenRouter 모델로 바꿉니다.

모델 이름은 OpenRouter에서 원하는 모델을 검색해 가져오면 됩니다. Kimi K2.5라면 OpenRouter가 제공하는 Moonshot AI의 모델 식별자를 복사합니다. 주의할 점은 식별자만 붙이는 것이 아니라 앞에 openrouter/ 접두어까지 붙여야 한다는 것입니다. 단테는 모델 값을 바꿀 때 관련된 키 두 곳을 모두 바꿔야 한다는 점도 강조합니다.

저장하고 리로드한 뒤 텔레그램에서 메시지를 보내면 정상적으로 응답이 오고, 봇은 스스로를 openclaw 플랫폼에서 실행된 AI 어시스턴트로 인식합니다. 이후 모델을 바꾸고 싶을 때는 같은 형식으로 설정 값을 고친 뒤 리로드만 하면 됩니다.

정리

  • Cloudflare 기반 배포는 새 모델 반영이 저장소 커밋에 묶여 있어, 모델 선택이 자유로운 Railway 템플릿을 대안으로 썼습니다.
  • Railway 템플릿은 비밀번호만 정하면 원클릭으로 배포되고, admin 계정으로 셋업 화면에 들어갑니다.
  • 프로바이더는 OpenRouter, 채널은 텔레그램 BotFather 토큰과 페어링 코드로 연결합니다.
  • 기본값 auto 때문에 응답이 실패하면 Raw 설정에서 모델 값을 openrouter/ 접두어가 붙은 식별자로 바꾸고 리로드합니다.

영상: 유튜브에서 보기 · 정정 요청: dante@quokkalabs.net