跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客我的书AI学习GitHub 精选镜像AI 生图工具UI配色美学关于
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
JavaScriptNode.jsAI

OpenClaw 配置本地 Ollama 模型完整指南

OpenClaw 是一款支持本地部署的 AI 智能体工具。如何在本地环境中配置 OpenClaw 连接 Ollama 运行的大语言模型。内容包括硬件软件前置要求、Ollama 模型拉取与上下文扩展、OpenClaw 安装方式、核心配置文件中的 Auth 设置、TUI 及 Web UI 启动测试、消息应用集成以及技能安装。同时提供了常见问题排查方案,帮助用户实现零成本、全离线的个人 AI 助理搭建。

清心发布于 2026/4/5更新于 2026/9/1396 浏览
OpenClaw 配置本地 Ollama 模型完整指南

OpenClaw 配置本地 Ollama 模型完整指南

本文介绍如何配置 OpenClaw 连接本地 Ollama 模型,实现零成本、全离线的个人 AI 助理体验。支持 Windows、macOS 和 Linux 系统。

一、前置要求(硬件与软件准备)

硬件建议:

  • GPU:NVIDIA RTX 4060 及以上(8GB+ 显存推荐),Apple Silicon M2/M3/M4 也极佳。
  • 内存:16GB 起步,32GB 更流畅。
  • 磁盘:20GB+ 剩余空间。
  • CPU:至少 8 核(无 GPU 时备选)。

软件要求:

  • Ollama 0.17 或更高
  • Node.js 18+(npm 安装 OpenClaw)
  • Windows 用户建议用 PowerShell 以管理员身份运行;macOS/Linux 用终端即可。
  • 可选:Git(安装技能时用到)

检查命令:

node --version
npm --version
ollama --version

二、步骤 1:安装 Ollama 并拉取本地模型

拉取推荐本地模型:

# 通用推荐
ollama pull qwen2.5:7b
ollama pull qwen3:8b
ollama pull glm-4.7-flash
ollama pull llama3.3:8b

进阶:创建大上下文模型 OpenClaw 默认需要 16k+ 上下文。使用 Modelfile 扩展:

Windows (PowerShell):

cd ~
@" 
FROM qwen2.5:7b
PARAMETER num_ctx 32768
"@ | Out-File -Encoding ascii Modelfile
ollama create qwen2.5:7b-32k -f Modelfile

macOS/Linux:

cat > Modelfile << EOF
FROM qwen2.5:7b
PARAMETER num_ctx 32768
EOF
ollama create qwen2.5:7b-32k -f Modelfile

验证模型:

ollama list
ollama show qwen2.5:7b-32k --modelfile

Ollama 服务默认监听 http://127.0.0.1:11434。

三、步骤 2:安装 OpenClaw

官方一键法:

ollama launch openclaw

手动安装方式:

npm install -g openclaw@latest
openclaw --version

四、步骤 3:配置 OpenClaw 连接本地 Ollama 模型

方式一:配置向导

openclaw onboard

按提示操作:

步骤操作选择
Model/auth providerCustom Provider
API Base URLhttp://127.0.0.1:11434/v1
API Keyollama-local
Endpoint compatibilityOpenAI-compatible
Model IDqwen2.5:7b-32k

方式二:手动编辑配置文件 配置文件位置:

  • Windows: C:\Users\你的用户名\.openclaw\openclaw.json
  • macOS/Linux: ~/.openclaw/openclaw.json

Auth 配置部分:

{
  "models": {
    "providers": {
      "ollama": {
        "baseUrl": "http://127.0.0.1:11434/v1",
        "auth": {
          "type": "api_key",
          "apiKey": "ollama-local"
        },
        "api": "openai-completions",
        "models": [
          {
            "id": "qwen2.5:7b-32k",
            "name": "Qwen2.5 7B 32K (本地)",
            "reasoning": true,
            "input": ["text"],
            "cost": { "input": 0, "output": 0 },
            "contextWindow": 32768,
            "maxTokens": 32768
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "ollama/qwen2.5:7b-32k"
      }
    }
  }
}

保存文件后,立即重启 OpenClaw:

openclaw tui

五、步骤 4:启动并测试

openclaw tui

看到欢迎语即成功。同时可访问 Web UI 地址进行直观操作。

六、步骤 5:连接消息应用

openclaw configure --section channels

支持 Telegram、WhatsApp、Slack 等。选择对应渠道按提示输入 Token 或 Chat ID。

七、步骤 6:安装技能

# 安装技能管理器
npx clawhub install clawhub

# 推荐必装技能
npx clawhub install filesystem-mcp
npx clawhub install github
npx clawhub install summarize
npx clawhub install weather
npx clawhub install openai-whisper

八、常见问题 & 排查

  1. Authentication failed:检查 auth.apiKey 是否为 ollama-local,type 是否为 api_key。
  2. Model context window too small:修改配置文件中的 contextWindow 和 maxTokens 为 32768。
  3. Verification failed:确认 Ollama 正在运行,Base URL 带 /v1,auth 对象完整无误。
  4. 技能 missing:安装对应依赖(如 GitHub 需要 gh CLI),然后重启。
  5. 响应慢 / 空白:换小模型(7B),或确认 GPU 驱动最新。

九、高级玩法

  • 多模型切换:在 config.json 加多个模型。
  • Docker 部署:服务器党可参考社区教程。
  • 语音输入输出:安装 whisper + sherpa-onnx-tts 技能。
  • 安全加固:隔离工作区,工具调用前仔细审查。

恭喜!你现在拥有了一个完全离线、零成本、功能强大的个人 AI 助理。

目录

  1. OpenClaw 配置本地 Ollama 模型完整指南
  2. 一、前置要求(硬件与软件准备)
  3. 二、步骤 1:安装 Ollama 并拉取本地模型
  4. 通用推荐
  5. 三、步骤 2:安装 OpenClaw
  6. 四、步骤 3:配置 OpenClaw 连接本地 Ollama 模型
  7. 五、步骤 4:启动并测试
  8. 六、步骤 5:连接消息应用
  9. 七、步骤 6:安装技能
  10. 安装技能管理器
  11. 推荐必装技能
  12. 八、常见问题 & 排查
  13. 九、高级玩法

更多推荐文章

查看全部
  • GraphRAG:基于知识图谱的检索增强生成技术详解与实战
  • Python GUI 开发指南:Tkinter 与 PyQt5 对比及安装教程
  • Qwen-Multiple-Angles 插件实现图像多角度生成支持 ComfyUI 与 WebUI
  • 跨架构兼容的 C++ 并行计算框架设计指南
  • 多线程程序崩溃原因:C++ 同步机制常见陷阱与解决方案
  • LeetCode 86: 分隔链表
  • GitHub Copilot 学生认证流程指南(2026 版)
  • ClawX 可视化 AI 智能体使用指南
  • 4x Tesla P40 训练 Llama-3.3-70B 大模型技术方案
  • Unreal Engine 4.27 结合 AirSim 搭建澳洲农村无人机仿真环境
  • Qwen2.5-VL 多模态模型基于 LLaMA-Factory WebUI 的 LoRA 微调教程
  • JCache(JSR-107)核心拓扑模式:LOCAL 与分布式扩展详解
  • Gemini Pro 实测:多模态、推理与代码能力的真实表现
  • HarmonyOS ArkUI 实战:从零打造计数器应用
  • 5 分钟了解 Sora 技术原理与应用前景
  • Flutter for OpenHarmony 通义万相 AIGC 联调与相册持久化
  • AI 编辑器收费模式变革:Token 计费下的开发者生存逻辑
  • 解决 VS Code 中 GitHub Copilot 模型不可用问题
  • Flutter 三方库 ethereum_addresses 的鸿蒙化适配指南
  • JDK 21 安装与环境配置指南

相关免费在线工具

  • RSA密钥对生成器

    生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online

  • Mermaid 预览与可视化编辑

    基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online

  • 随机西班牙地址生成器

    随机生成西班牙地址(支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选),支持数量快捷选择、显示全部与下载。 在线工具,随机西班牙地址生成器在线工具,online

  • Keycode 信息

    查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具,Keycode 信息在线工具,online

  • Escape 与 Native 编解码

    JavaScript 字符串转义/反转义;Java 风格 \uXXXX(Native2Ascii)编码与解码。 在线工具,Escape 与 Native 编解码在线工具,online

  • JavaScript / HTML 格式化

    使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具,JavaScript / HTML 格式化在线工具,online