Ollama Cloud

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-cloudopenclaw 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을 사용해야 합니다.

관련 항목

• Ollama
• 모델 제공자
• 모든 제공자