教程

OpenClaw 模型提供商完全指南：从 Anthropic 到 Ollama 本地模型的配置方法

OpenClaw 20+ 模型提供商配置完全指南：Anthropic（API Key + OAuth）、OpenAI、OpenRouter 统一接口、Ollama 本地离线模型、Venice AI 隐私推荐、Amazon Bedrock、LiteLLM 统一网关，以及模型故障转移和 per-Agent 模型配置。

2026/3/23分钟 阅读ClaudeEagle

OpenClaw 支持 20+ 个主流 LLM 提供商，包括 Anthropic、OpenAI、Ollama 本地模型、OpenRouter 等。本文覆盖核心提供商的配置方式。

快速开始

选择提供商并设置默认模型：

bash
openclaw onboard  # 交互式向导，最简单的方式

或直接配置：

json
{
  "agents": {
    "defaults": {
      "model": {
        "primary": "anthropic/claude-opus-4-6"
      }
    }
  }
}

模型 ID 格式

所有模型用 provider/model 格式指定：

示例说明
anthropic/claude-sonnet-4-6Anthropic Claude Sonnet 4.6
openai/gpt-4oOpenAI GPT-4o
openrouter/anthropic/claude-opus-4-5通过 OpenRouter 使用 Claude
ollama/llama3.2本地 Ollama 模型
venice/llama-3.3-70bVenice AI（隐私优先）

Anthropic 配置

API Key 方式

json
{
  "models": {
    "providers": {
      "anthropic": {
        "apiKey": "sk-ant-..."
      }
    }
  }
}

或设置环境变量：ANTHROPIC_API_KEY=sk-ant-...

Claude Code CLI OAuth 方式

bash
openclaw onboard  # 通过 Claude Code CLI 完成 OAuth 授权

OAuth 方式无需手动管理 API Key，但注意：这种方式不支持向量记忆搜索的嵌入 API。

OpenAI 配置

json
{
  "models": {
    "providers": {
      "openai": {
        "apiKey": "sk-..."
      }
    }
  }
}

环境变量：OPENAI_API_KEY=sk-...

OpenRouter（访问多种模型）

OpenRouter 提供统一接口访问数百个模型，包括 Claude、GPT、Gemini、Llama 等：

json
{
  "models": {
    "providers": {
      "openrouter": {
        "apiKey": "sk-or-..."
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "openrouter/anthropic/claude-opus-4-5"
      }
    }
  }
}

OpenRouter 的优势：单一账单、访问不直接提供 API 的模型、自动负载均衡。

Ollama（本地模型，完全离线）

bash
# 先安装 Ollama
brew install ollama  # macOS
# 或 curl https://ollama.ai/install.sh | sh  # Linux

# 拉取模型
ollama pull llama3.2
ollama pull qwen2.5-coder
json
{
  "models": {
    "providers": {
      "ollama": {
        "baseUrl": "http://localhost:11434"
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "ollama/llama3.2"
      }
    }
  }
}

Ollama 无需 API Key，完全本地运行，数据不离开你的机器。

Venice AI（隐私优先推荐）

OpenClaw 推荐的隐私优先推理方案：

json
{
  "models": {
    "providers": {
      "venice": {
        "apiKey": "your-venice-key"
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "venice/llama-3.3-70b"
      }
    }
  }
}
  • 默认推荐：venice/llama-3.3-70b
  • 最强效果：venice/claude-opus-45

Amazon Bedrock

json
{
  "models": {
    "providers": {
      "bedrock": {
        "region": "us-east-1",
        "profile": "default"
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "bedrock/anthropic.claude-opus-4-5-v1:0"
      }
    }
  }
}

使用 AWS CLI 凭证文件（~/.aws/credentials），或设置 AWS_ACCESS_KEY_ID / AWS_SECRET_ACCESS_KEY 环境变量。

LiteLLM（统一网关）

已有 LiteLLM 代理服务器时：

json
{
  "models": {
    "providers": {
      "litellm": {
        "baseUrl": "http://localhost:4000",
        "apiKey": "your-master-key"
      }
    }
  }
}

模型故障转移（Failover）

主模型失败时自动切换：

json
{
  "agents": {
    "defaults": {
      "model": {
        "primary": "anthropic/claude-opus-4-6",
        "fallback": "openai/gpt-4o",
        "fallbackOnErrors": ["rate_limit", "overloaded"]
      }
    }
  }
}

per-Agent 模型配置

不同 Agent 使用不同模型，平衡成本和效果：

json
{
  "agents": {
    "defaults": {
      "model": { "primary": "anthropic/claude-sonnet-4-6" }
    },
    "list": [
      {
        "id": "heavy",
        "model": { "primary": "anthropic/claude-opus-4-6" }
      },
      {
        "id": "fast",
        "model": { "primary": "anthropic/claude-haiku-4-5" }
      }
    ]
  }
}

Claude Max API 代理（社区工具）

将 Claude Max/Pro 订阅用作 OpenAI 兼容 API 端点：

json
{
  "models": {
    "providers": {
      "claude-max": {
        "baseUrl": "http://localhost:8080"
      }
    }
  }
}

需要先安装 Claude Max API Proxy 工具（社区项目，见 docs.openclaw.ai/providers/claude-max-api-proxy）。

原文：Model Providers - OpenClaw | 来源：OpenClaw 官方文档