OpenClaw 启用 Ollama 指南

在已安装 Ollama 并可通过 UI 界面访问的前提下，下面是在 OpenClaw 中启用 Ollama 的详细步骤。

步骤 1：确保 Ollama 服务正在运行

1. 启动 Ollama：打开 Ollama UI 界面（通过 ollama.exe），确保 Ollama 服务正在后台运行，在 UI 中查看已安装的模型。
2. 验证 Ollama API 可访问：打开 PowerShell 并运行：

Invoke-WebRequest -Uri "http://localhost:11434/api/tags"

如果返回模型列表，则表示 Ollama 服务正常运行。

步骤 2：设置环境变量

在 PowerShell 中运行：

# 设置 Ollama API 密钥（任何值都可以）
[Environment]::SetEnvironmentVariable("OLLAMA_API_KEY", "ollama-local", "User")

# 重新加载环境变量
$env:OLLAMA_API_KEY = "ollama-local"

步骤 3：配置 OpenClaw 使用 Ollama

修改 c:\Users\Administrator\.openclaw\openclaw.json 文件，添加或更新以下配置：

{
    "agents": {
        "defaults": {
            "model": {
                "primary": "ollama/你的模型名称",
                "fallbacks": []
            }
        }
    }
}

将 “你的模型名称” 替换为 Ollama 中实际安装的模型名称，例如：

• ollama/llama3.3
• ollama/gpt-oss:20b
• ollama/qwen2.5-coder:32b

步骤 4：验证配置

1. 检查模型状态：

cd c:\Users\Administrator\Desktop\openclaw-main
node openclaw.mjs models status

2. 列出可用模型：

node openclaw.mjs models list

应该能看到 Ollama 中的模型出现在列表中。

步骤 5：测试使用本地模型

node openclaw.mjs chat "你好，请介绍一下你自己"

常见问题解决

1. Ollama 未被检测到：确保 Ollama 服务正在运行、检查环境变量是否正确设置、验证 API 地址是否可访问。
2. 模型不可用：确保拉取的模型支持工具调用，可在 Ollama UI 中查看模型详情。
3. 连接被拒绝：检查 Ollama 是否在默认端口 11434 上运行，尝试重启 Ollama 服务。

高级配置（可选）

如果需要更详细的配置，例如指定 Ollama 服务的地址或手动配置模型参数，可以在 openclaw.json 中添加：

{
    "models": {
        "providers": {
            "ollama": {
                "baseUrl": "http://localhost:11434",
                "apiKey": "ollama-local",
                "api": "ollama",
                "models": [
                    {
                        "id": "llama3.3",
                        "name": "Llama 3.3",
                        "reasoning": true,
                        "input": ["text"],
                        "cost": {
                            "input": 0,
                            "output": 0,
                            "cacheRead": 0,
                            "cacheWrite": 0
                        },
                        "contextWindow": 8192,
                        "maxTokens": 81920
                    }
                ]
            }
        }
    }
}

完成以上步骤后，OpenClaw 将使用本地 Ollama 模型进行推理，享受本地运行的隐私和成本优势。