메인 콘텐츠로 건너뛰기
Ollama Cloud는 Ollama의 호스팅 모델 API입니다. 로컬 Ollama 서버를 설치하거나 로컬 Ollama 앱을 클라우드 모드로 로그인하지 않고도 OpenClaw가 Ollama에서 호스팅되는 모델을 직접 호출할 수 있게 해줍니다. 제공자 ID ollama-cloud와 ollama-cloud/kimi-k2.6 같은 모델 참조를 사용하세요. 이 페이지는 직접적인 클라우드 전용 라우팅을 위한 것입니다. 이 제공자는 OpenAI 호환 /v1 경로가 아니라 Ollama의 네이티브 /api/chat 스타일을 사용합니다. OpenClaw는 클라우드 전용 자격 증명, 라이브 카탈로그 검색, 모델 선택이 로컬 ollama 호스트와 섞이지 않도록 이를 별도의 제공자 ID로 등록합니다. 클라우드 전용 라우팅을 원할 때 이 페이지를 사용하세요. 로컬 Ollama, 하이브리드 클라우드+로컬 라우팅, 임베딩, 사용자 지정 호스트 세부 정보는 Ollama를 참조하세요.

​
설정

ollama.com/settings/keys에서 Ollama Cloud API 키를 만든 다음 실행하세요. 
openclaw onboard --auth-choice ollama-cloud
또는 다음을 설정하세요. 
export OLLAMA_API_KEY="<your-ollama-cloud-api-key>" # pragma: allowlist secret

​
기본값

  • 제공자: ollama-cloud
  • 기본 URL: https://ollama.com
  • 환경 변수: OLLAMA_API_KEY
  • API 스타일: Ollama 네이티브 /api/chat
  • 예시 모델: ollama-cloud/kimi-k2.6

​
Ollama Cloud를 선택해야 하는 경우

  • 로컬에서 ollama serve를 실행하지 않고 호스팅 Ollama 모델을 사용하려는 경우.
  • OpenClaw가 로컬 Ollama에 사용하는 것과 같은 네이티브 Ollama 채팅 API 형태를 원하지만, 대상이 https://ollama.com이기를 원하는 경우.
  • 이미 Ollama의 호스팅 카탈로그에 있는 모델을 위한 간단한 클라우드 경로를 원하는 경우.
  • 로컬 모델 풀, 로컬 GPU 제어, 또는 LAN 전용 추론이 필요하지 않은 경우.
로그인된 Ollama 호스트를 통한 로컬 전용 또는 클라우드+로컬 라우팅을 원할 때는 대신 Ollama를 사용하세요. /v1/chat/completions 의미 체계 또는 제공자별 OpenAI 스타일 기능이 필요할 때는 대신 OpenAI 호환 제공자를 사용하세요.

​
모델

OpenClaw는 라이브 호스팅 카탈로그에서 Ollama Cloud 모델을 검색합니다. 일반적으로 사용 가능한 호스팅 ID는 다음과 같습니다.
  • ollama-cloud/gpt-oss:20b
  • ollama-cloud/kimi-k2.6
  • ollama-cloud/deepseek-v4-flash
  • ollama-cloud/minimax-m2.7
  • ollama-cloud/glm-5
현재 호스팅 카탈로그의 모델 ID를 사용하세요. 
openclaw models list --provider ollama-cloud
openclaw models set ollama-cloud/kimi-k2.6
모델 ID는 클라우드 카탈로그 ID이며, 로컬 풀 이름이 아닙니다. 모델 이름이 로컬 Ollama 호스트에서는 작동하지만 호스팅 카탈로그에는 없다면, 대신 해당 로컬 호스트와 함께 ollama 제공자를 사용하세요.

​
라이브 테스트

Ollama Cloud API 키 스모크 테스트의 경우 Ollama 라이브 테스트가 호스팅 엔드포인트를 가리키도록 하고 현재 카탈로그에서 모델을 선택하세요. 
export OLLAMA_API_KEY="<your-ollama-cloud-api-key>" # pragma: allowlist secret

OPENCLAW_LIVE_TEST=1 \
OPENCLAW_LIVE_OLLAMA=1 \
OPENCLAW_LIVE_OLLAMA_BASE_URL=https://ollama.com \
OPENCLAW_LIVE_OLLAMA_MODEL=kimi-k2.6 \
OPENCLAW_LIVE_OLLAMA_WEB_SEARCH=1 \
pnpm test:live -- extensions/ollama/ollama.live.test.ts
클라우드 스모크는 텍스트, 네이티브 스트림, 웹 검색을 실행합니다. Ollama Cloud API 키가 /api/embed를 승인하지 않을 수 있으므로 https://ollama.com에 대해서는 기본적으로 임베딩을 건너뜁니다.

​
문제 해결

  • Set OLLAMA_API_KEY 오류: 실제 클라우드 API 키를 제공하세요. 로컬 ollama-local 표식은 로컬 또는 비공개 Ollama 호스트 전용입니다.
  • 알 수 없는 모델 오류: openclaw models list --provider ollama-cloud를 실행하고 호스팅 모델 ID를 정확히 복사하세요.
  • 사용자 지정 Ollama 호스트의 도구 호출 또는 원시 JSON 문제: 실수로 OpenAI 호환 /v1 URL을 사용하고 있는지 확인하세요. Ollama 경로는 /v1 접미사가 없는 네이티브 기본 URL을 사용해야 합니다.

​
관련 항목