OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Providers

Ollama Cloud

Ollama Cloud es la API de modelos alojada de Ollama. El proveedor ollama-cloud la invoca directamente en https://ollama.com mediante la API nativa /api/chat de Ollama, sin un servidor Ollama local ni una aplicación Ollama local con sesión iniciada en modo nube. Usa referencias de modelo como ollama-cloud/kimi-k2.6.

OpenClaw registra ollama-cloud con su propio id. de proveedor para que las credenciales exclusivas de la nube, la detección en vivo del catálogo y la selección de modelos no se mezclen con un host ollama local. Para Ollama local, el enrutamiento híbrido entre la nube y el entorno local, los embeddings y los detalles de hosts personalizados, consulta Ollama.

Configuración

Crea una clave de API de Ollama Cloud en ollama.com/settings/keys y, a continuación, ejecuta:

bash
openclaw onboard --auth-choice ollama-cloud

También puedes definir:

bash
export OLLAMA_API_KEY="<your-ollama-cloud-api-key>" # pragma: allowlist secret

La incorporación no interactiva acepta la clave directamente:

bash
openclaw onboard --auth-choice ollama-cloud --ollama-cloud-api-key "<key>"

La incorporación establece el modelo predeterminado en ollama-cloud/kimi-k2.5:cloud.

Valores predeterminados

  • Proveedor: ollama-cloud
  • URL base: https://ollama.com
  • Variable de entorno: OLLAMA_API_KEY
  • Estilo de API: /api/chat nativa de Ollama
  • Modelo predeterminado de incorporación: ollama-cloud/kimi-k2.5:cloud

Cuándo elegir Ollama Cloud

  • Quieres modelos Ollama alojados sin ejecutar ollama serve localmente.
  • Quieres la misma estructura de la API de chat nativa de Ollama que OpenClaw usa para Ollama local, pero dirigida a https://ollama.com.
  • Quieres una ruta sencilla en la nube para modelos que ya están en el catálogo alojado de Ollama.
  • No necesitas descargar modelos localmente, controlar una GPU local ni realizar inferencias solo en la LAN.

Usa Ollama en su lugar cuando quieras un enrutamiento exclusivamente local o híbrido entre la nube y el entorno local mediante un host Ollama con sesión iniciada. Usa en su lugar un proveedor compatible con OpenAI cuando necesites la semántica de /v1/chat/completions o funciones específicas del proveedor con el estilo de OpenAI.

Modelos

El proveedor requiere una clave de API; sin ella, permanece inactivo. Con una clave, OpenClaw detecta en vivo los modelos de Ollama Cloud en el catálogo alojado:

bash
openclaw models list --provider ollama-cloudopenclaw models set ollama-cloud/kimi-k2.6

Los id. alojados del catálogo en vivo incluyen deepseek-v4-flash, glm-5, gpt-oss:20b, kimi-k2.6 y minimax-m2.7. Cuando la detección en vivo no devuelve nada, OpenClaw recurre a las filas incluidas kimi-k2.5:cloud, minimax-m2.7:cloud, glm-5.1:cloud y glm-5.2:cloud.

Los id. de modelo son id. del catálogo en la nube, no nombres de descarga local. Si un nombre de modelo funciona en un host Ollama local, pero no está en el catálogo alojado, usa en su lugar el proveedor ollama con ese host local.

Prueba en vivo

Para las pruebas rápidas de Ollama Cloud con clave de API, dirige la prueba en vivo de Ollama al punto de conexión alojado y elige un modelo de tu catálogo actual:

bash
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 \pnpm test:live -- extensions/ollama/ollama.live.test.ts

La prueba rápida en la nube ejecuta texto, transmisión nativa y búsqueda web; define OPENCLAW_LIVE_OLLAMA_WEB_SEARCH=0 para omitir la búsqueda web. De forma predeterminada, omite los embeddings para https://ollama.com porque es posible que las claves de API de Ollama Cloud no autoricen /api/embed; fuérzalos con OPENCLAW_LIVE_OLLAMA_EMBEDDINGS=1.

Solución de problemas

  • Errores Ollama Cloud requires an API key / Set OLLAMA_API_KEY: proporciona una clave de API real de la nube. El marcador local ollama-local es solo para hosts Ollama locales o privados.
  • Errores de modelo desconocido: ejecuta openclaw models list --provider ollama-cloud y copia exactamente el id. del modelo alojado.
  • Problemas con llamadas a herramientas o JSON sin procesar en hosts Ollama personalizados: comprueba si estás usando por accidente una URL /v1 compatible con OpenAI. Las rutas de Ollama deben usar la URL base nativa sin el sufijo /v1.

Recursos relacionados

Was this useful?
On this page

On this page