OpenClaw 完整部署教程（Windows + Ollama）

🦀 OpenClaw 完整部署教程（Windows + Ollama）

📋 前置条件

操作系统：Windows 10/11
Ollama：已安装并运行（本地或远程）
Node.js：建议安装（某些功能需要）
PowerShell：Windows 自带

🚀 第一步：安装 OpenClaw

打开 PowerShell（管理员权限），运行：

powershell 复制代码

npm install -g openclaw

验证安装：

powershell 复制代码

openclaw --version

🔧 第二步：准备 Ollama

1. 启动 Ollama

确保 Ollama 正在运行：

powershell 复制代码

ollama serve

2. 拉取模型

powershell 复制代码

ollama pull qwen2.5:0.5b

3. 验证 Ollama 可用

powershell 复制代码

ollama list

应该看到：

复制代码

NAME            ID          SIZE    MODIFIED
qwen2.5:0.5b    xxx         637MB   2 days ago

第三步：配置 OpenClaw（关键步骤）

1. 初始化配置

powershell 复制代码

openclaw onboard

按照向导完成基础配置（可以选择默认选项）。

2. 手动编辑配置文件

打开配置文件：

powershell 复制代码

notepad C:\Users\space\.openclaw\openclaw.json

配置示例：

json 复制代码

{
  "meta": {
    "lastTouchedVersion": "2026.3.13",
    "lastTouchedAt": "2026-03-14T10:18:23.541Z"
  },
  "wizard": {
    "lastRunAt": "2026-03-14T10:18:23.535Z",
    "lastRunVersion": "2026.3.13",
    "lastRunCommand": "onboard",
    "lastRunMode": "local"
  },
  "models": {
    "providers": {
      "ollama": {
        "baseUrl": "http://127.0.0.1:11434",
        "apiKey": "ollama-local",
        "api": "ollama",
        "models": []
      }
    }
  },
  "agents": {
    "defaults": {
      "model": "ollama/qwen2.5:0.5b",
      "workspace": "C:\\Users\\space\\.openclaw\\workspace"
    }
  },
  "tools": {
    "profile": "coding"
  },
  "commands": {
    "native": "auto",
    "nativeSkills": "auto",
    "restart": true,
    "ownerDisplay": "raw"
  },
  "session": {
    "dmScope": "per-channel-peer"
  },
  "gateway": {
    "port": 18789,
    "mode": "local",
    "bind": "loopback",
    "auth": {
      "mode": "token",
      "token": "XXXXXXXXXXX"
    },
    "tailscale": {
      "mode": "off",
      "resetOnExit": false
    }
  }
}

📝 关键配置说明

字段	值	说明
`baseUrl`	`http://127.0.0.1:11434`	不要加 `/v1`，使用 Ollama 原生 API
`apiKey`	`ollama-local`	本地 Ollama 的固定值
`api`	`ollama`	明确指定使用 Ollama 原生工具调用
`model`	`ollama/qwen2.5:0.5b`	在 agents.defaults 中指定

⚠️ 重要提示

显式配置会禁用自动发现，所以：

✅ 如果在 agents.defaults.model 中指定了模型，models 数组可以为空
✅ 如果需要列出所有可用模型，需要在 models 数组中手动添加模型定义

🔄 第四步：启动网关

powershell 复制代码

openclaw gateway restart

验证网关状态：

powershell 复制代码

openclaw gateway status

应该看到类似：

复制代码

Gateway running on ws://127.0.0.1:18789

✅ 第五步：验证配置

1. 检查模型加载

powershell 复制代码

openclaw models list

预期输出：

复制代码

Model                                      Input      Ctx      Local Auth  Tags
ollama/qwen2.5:0.5b                        text       32k      yes   yes   default

2. 运行健康检查

powershell 复制代码

openclaw doctor

应该看到：

✅ 模型已加载
✅ Ollama 连接成功
⚠️ 一些关于 Memory/API keys 的警告（可忽略，与工具调用无关）

🧪 第六步：测试工具调用功能

方法 1：使用 TUI 交互模式（推荐）

powershell 复制代码

openclaw tui

在 TUI 界面中输入：

复制代码

请帮我计算 12345 + 67890 等于多少？

✅ 成功标志：

AI 直接返回结果：80235
❌ 失败标志：输出原始 JSON（如 {"tool_call": ...}）

方法 2：使用 agent 命令

powershell 复制代码

openclaw agent --message "请计算 25 * 37 的结果"

方法 3：测试计算器工具

powershell 复制代码

openclaw agent --message "请帮我计算 100 / 7，保留两位小数"

方法 4：使用Web UI交互

powershell 复制代码

openclaw dashboard

🔍 常见问题排查

问题 1：模型未加载

powershell 复制代码

# 错误：No models found

解决：检查 baseUrl 是否正确，Ollama 是否运行

问题 2：工具调用输出 JSON 而非结果

复制代码

# 错误输出：{"tool_calls": [{"name": "calculator", ...}]}

原因：使用了 OpenAI 兼容模式（带 /v1 后缀）
解决：确保 baseUrl 是 http://127.0.0.1:11434 而非 http://127.0.0.1:11434/v1

问题 3：连接被拒绝

复制代码

# 错误：ECONNREFUSED

解决：

powershell 复制代码

# 检查 Ollama 是否运行
ollama list

# 重启 Ollama
ollama serve

问题 4：Dashboard 无法访问

原因：网关可能未完全启动或端口被占用
解决：

powershell 复制代码

# 强制重启网关
openclaw gateway --force

# 或更换端口
openclaw config set gateway.port 18790
openclaw gateway restart

🎯 完整测试流程

运行以下命令完成完整测试：

powershell 复制代码

# 1. 启动 Ollama
ollama serve

# 2. 重启 OpenClaw 网关
openclaw gateway restart

# 3. 验证模型
openclaw models list

# 4. 运行健康检查
openclaw doctor

# 5. 测试工具调用
openclaw tui
# 在 TUI 中输入：计算 12345 + 67890

# 6. 退出 TUI
# 按 Ctrl+C 或输入 /quit

📊 预期结果

步骤	预期输出
`ollama list`	显示 `qwen2.5:0.5b`
`openclaw models list`	显示 `ollama/qwen2.5:0.5b`，Local Auth: yes
`openclaw doctor`	显示模型已加载，无连接错误
工具调用测试	直接返回计算结果，无 JSON 输出

🎉 恭喜！

如果所有步骤都成功，你已经：

✅ 成功部署 OpenClaw
✅ 正确配置 Ollama 原生 API（非 OpenAI 兼容模式）
✅ 启用了正确的工具调用功能
✅ 可以正常使用计算器等工具

现在可以开始使用 OpenClaw 的自动化功能了！🤖

💡 进阶配置

添加更多模型

json 复制代码

"models": {
  "providers": {
    "ollama": {
      "baseUrl": "http://127.0.0.1:11434",
      "apiKey": "ollama-local",
      "api": "ollama",
      "models": [
        {"name": "qwen2.5:0.5b"},
        {"name": "llama3:8b"},
        {"name": "mistral:7b"}
      ]
    }
  }
}

远程 Ollama

如果 Ollama 在另一台机器上：

json 复制代码

"baseUrl": "http://192.168.1.100:11434"

启用详细日志

powershell 复制代码

openclaw --log-level debug

遇到问题？ 检查：

Ollama 是否运行：ollama list
配置文件路径：C:\Users\space\.openclaw\openclaw.json
网关状态：openclaw gateway status
查看日志：openclaw logs

祝你使用愉快！🦀