OpenClaw
Raon을 OpenClaw 프로바이더로 등록하고 기본 모델로 설정할지 선택합니다.
설치 스크립트는 Raon을 OpenClaw 프로바이더 raon으로 등록하고, 기본 모델로 설정할지 묻습니다. 동의하면 기본 모델을 Raon으로 변경하고, 거절하면 기존 기본 모델을 유지합니다. 다른 프로바이더 설정은 변경하지 않으며, 대화 중 /model 명령으로 다른 모델로 전환할 수 있습니다.
기본 모델을 변경할지 묻는 단계에서 Enter 키를 누르면 Raon으로 변경합니다. --yes 옵션(Windows는 -Yes)을 지정해도 기본 모델을 Raon으로 변경합니다. 사용자 입력을 받을 수 없는 환경에서 이 옵션 없이 실행하면 Raon만 등록하고 기존 기본 모델을 유지합니다.
설치
먼저 OpenClaw를 설치하고 온보딩을 완료하세요. 아래 설치 스크립트는 이미 설치된 OpenClaw에 Raon을 추가합니다.
curl -fsSL https://raon-console.krafton.ai/setup/openclaw.sh | bash설치 스크립트는 입력받은 API 키로 테스트 요청을 보냅니다. 이어서 ~/.openclaw/.env에 RAON_API_KEY를 저장하고, ~/.openclaw/openclaw.json에 프로바이더를 추가합니다. 두 파일은 변경 전에 백업합니다. OpenClaw는 .env 파일에서 환경 변수 값을 읽을 수 있습니다.
기본 설정에서는 변경된 모델 설정을 자동으로 불러옵니다. 설정 자동 갱신을 꺼 두었다면 설치 후 OpenClaw를 재시작해야 합니다.
셸이나 서비스에 이미 설정된 RAON_API_KEY 환경 변수가 .env의 값보다 우선 적용될 수 있습니다. 테스트 요청은 성공했는데 OpenClaw에서 인증 오류가 계속 발생하면 해당 환경 변수 값을 확인하세요. 필요한 경우 값을 수정한 뒤 서비스를 재시작하세요.
설정 확인
openclaw models list --provider raon대화 중에는 /model raon/raon-1-mini-preview 명령으로 Raon 모델로 전환하고, /model list 명령으로 사용할 수 있는 모델 목록을 확인할 수 있습니다.
모델 사용이 허용되지 않았다는 오류가 발생하면 OpenClaw의 모델 허용 정책과 에이전트별 제한을 확인하세요. 설치 스크립트는 기존 정책을 변경하지 않습니다. 따라서 프로바이더를 등록해도 모델 허용 목록에는 자동으로 추가되지 않습니다.
수동 설정
API 키를 ~/.openclaw/.env 파일에 저장합니다.
RAON_API_KEY=<your key>다음 내용을 ~/.openclaw/openclaw.json의 기존 설정에 병합합니다.
{
agents: {
defaults: { model: { primary: "raon/raon-1-mini-preview" } },
},
models: {
providers: {
raon: {
baseUrl: "https://raon-api.krafton.ai/v1",
apiKey: "${RAON_API_KEY}",
api: "openai-completions",
models: [
{
id: "raon-1-mini-preview",
name: "Raon-1 mini preview",
reasoning: true,
input: ["text"],
contextWindow: 262144,
maxTokens: 16384,
compat: { supportsUsageInStreaming: true },
},
],
},
},
},
}| 항목 | 설명 |
|---|---|
primary | Raon을 기본 모델로 지정. 기존 기본 모델을 유지하고 대화마다 전환하려면 생략 |
contextWindow | 필수. 생략하면 OpenClaw가 200,000으로 간주 |
supportsUsageInStreaming | 스트리밍 응답의 토큰 사용량 수집 |
제거
설치 스크립트가 등록한 Raon 프로바이더와 저장한 API 키를 제거합니다. OpenClaw 프로그램과 다른 프로바이더의 설정, 도구 설정은 유지합니다. 설치 스크립트가 기본 모델을 Raon으로 변경했다면 설치 전 기본 모델로 복원합니다. 설치 후 사용자가 기본 모델을 변경한 경우에는 사용자가 지정한 값을 유지합니다.
curl -fsSL https://raon-console.krafton.ai/setup/openclaw.sh | bash -s -- --uninstall설치 전에 같은 이름의 Raon 프로바이더나 API 키가 있었다면 원래 값으로 복원합니다. 다만 Raon 프로바이더를 수정했거나 기본 모델 복원 후에도 전역 기본 모델, 대체 모델(fallback), 개별 에이전트의 모델 설정이 Raon을 참조하면 프로바이더와 키를 유지하고 그 이유를 표시합니다. 설치할 때는 Raon을 등록만 하고 나중에 모델로 선택한 경우에도 같은 기준을 적용합니다. 설치 후 변경한 API 키도 삭제하지 않습니다.
제거 스크립트는 설정 파일의 모델 참조를 확인하며, 개별 대화에서 선택한 모델은 확인하지 않습니다. 대화에서도 Raon이 아닌 모델로 전환한 뒤 프로바이더를 제거하세요.
제거할 때는 설치 스크립트가 남긴 기록을 참조합니다. 수동으로 추가한 설정이나 설치 기록이 없는 이전 버전의 설정은 자동으로 제거하지 않습니다. API 키를 입력하거나 API 서버에 연결할 필요는 없습니다. 다만 설정 변경에 에이전트의 명령을 사용하므로 OpenClaw가 설치되어 있어야 합니다. 로컬에 저장한 키를 삭제해도 서버에서 발급한 API 키는 폐기되지 않습니다.