Ollama 是本地模型运行平台,支持在本机或远程主机运行开源模型。OpenClaw 支持三种使用模式。

运行模式

模式说明
云 + 本地主模型用云端,部分功能(如嵌入)用本地 Ollama
仅云不使用 Ollama
仅本地全部模型走本地 Ollama

默认端口:http://127.0.0.1:11434

认证规则

  • 本地(127.0.0.1):无需认证
  • 远程主机:需配置 OLLAMA_API_KEY 或自定义 header

模型发现

Ollama 是隐式提供商,OpenClaw 会自动发现本地已拉取的模型,无需手动列举。

ollama pull llama3.2
ollama pull nomic-embed-text

基础配置

# 最简配置(自动发现)
model: ollama/llama3.2
 
# 显式指定
model: ollama/llama3.2:latest
 
# 自定义 URL(远程 Ollama)
providers:
  ollama:
    url: http://192.168.1.100:11434

高级功能

OpenAI 兼容模式

providers:
  ollama:
    openai_compat: true

上下文窗口控制

providers:
  ollama:
    context_window: 8192

推理模型(Thinking)

支持带思考过程的推理模型:

model: ollama/deepseek-r1:7b
thinking: true

内存嵌入

memory:
  embedding:
    provider: ollama
    model: nomic-embed-text

视觉支持

支持多模态视觉模型(如 llava、bakllava)进行图像描述:

model: ollama/llava:13b

相关链接

  • providers - 所有 Provider 概览
  • models - 模型配置说明
  • notes/local-models - 本地模型实践经验