OpenClaw 配置本地 Ollama 模型完整指南零成本打造全离线个人 AI 助理2026 最新版·含 Auth 配置大家好我是你的 AI 技术博主。今天我们来聊一个 2026 年最火的本地 AI 助理项目——OpenClaw。它能帮你清理收件箱、发邮件、管理日历、处理文件、集成 Telegram/WhatsApp甚至执行复杂任务而且完全跑在你自己的电脑上。配合Ollama运行本地模型如 Qwen3、Qwen2.5、GLM-4.7、Llama3.3 等你就可以实现真正零费用、零网络依赖、全隐私保护的智能体体验。官方从 Ollama 0.17 开始提供了ollama launch openclaw一键启动但很多朋友想深度自定义本地模型、解决上下文窗口问题、安装技能等所以我写了这篇超级详细的配置教程每一步都配命令、截图描述、坑点规避和排查方案。本次更新重点2026 年 3 月最新新增Auth 配置部分OpenClaw 最新要求必须使用嵌套auth对象本地模型的apiKey统一改为ollama-local官方推荐标识兼容性最佳无论你是 Windows、macOS 还是 Linux 用户都能一步步跟上。走完这篇你就能拥有一个比 Claude 更私密的个人 AI 秘书一、前置要求必看硬件与软件准备硬件建议本地模型跑得顺的关键GPUNVIDIA RTX 4060 及以上8GB 显存推荐Apple Silicon M2/M3/M4 也极佳。内存16GB 起步32GB 更流畅OpenClaw 系统提示词 工具调用很容易吃 10k tokens。磁盘20GB 剩余空间模型文件很大。CPU至少 8 核无 GPU 时备选。软件要求Ollama 0.17 或更高官方强烈推荐Node.js 18npm 安装 OpenClawWindows 用户建议用PowerShell 以管理员身份运行macOS/Linux 用终端即可。可选Git安装技能时用到检查命令全部复制粘贴执行node--version# 应 v18npm--version# 应 8ollama--version# 应 0.17没有 Node.js去 https://nodejs.org 下载 LTS 版安装。没有 Ollama去 https://ollama.com/download 下载对应系统版本。二、步骤 1安装 Ollama 并拉取本地模型安装 OllamaWindows 直接双击安装器macOS/Linux 执行官方脚本# macOS / Linuxcurl-fsSLhttps://ollama.com/install.sh|sh验证 Ollama 服务Windows 会自动开机自启ollama list拉取推荐本地模型强烈建议先用 7B-14B 量化版测试# 通用推荐速度快、效果好ollama pull qwen2.5:7b ollama pull qwen3:8b# 2026 新模型推理更强ollama pull glm-4.7-flash# ~25GB VRAM适合强推理ollama pull llama3.3:8b# Meta 经典进阶创建大上下文模型OpenClaw 必须 ≥16k tokensOpenClaw 默认需要 16k 上下文否则会报错。我们用 Modelfile 扩展# WindowsPowerShellcd ~\ FROM qwen2.5:7b PARAMETER num_ctx 32768 |Out-File-Encoding ascii Modelfile ollama create qwen2.5:7b-32k-f ModelfilemacOS/Linux 同理用cat Modelfile创建文件。验证ollama list ollama show qwen2.5:7b-32k--modelfile现在模型就绪Ollama 服务默认监听http://127.0.0.1:11434。三、步骤 2安装 OpenClaw最推荐方式官方一键法2026 新特性ollama launch openclawOllama 会自动检查并通过 npm 安装 OpenClaw弹出模型选择器安装 Web Search 插件本地模型无需启动 TUI终端界面直接在终端聊天即可想换本地模型执行ollama launch openclaw --model qwen2.5:7b-32k即可。手动安装方式适合想深度配置的用户npminstall-gopenclawlatest openclaw--version# 验证版本四、步骤 3配置 OpenClaw 连接本地 Ollama 模型最核心一步方式一配置向导推荐新手openclaw onboard按提示操作超级详细表格步骤操作选择Model/auth provider选择Custom Provider列表最后一项API Base URL输入http://127.0.0.1:11434/v1API Key必须填写ollama-local新版强制要求Endpoint compatibility选择OpenAI-compatibleModel ID输入你创建的模型名如qwen2.5:7b-32k其他问题技能、渠道全部Skip for now或No配置完成后会显示 Web UI 地址通常http://127.0.0.1:18789。方式二手动编辑配置文件高级用户必备配置文件位置Windows:C:\Users\你的用户名\.openclaw\openclaw.jsonmacOS/Linux:~/.openclaw/openclaw.json【新增】Auth 配置部分2026 最新推荐写法为什么必须加 auth 配置虽然 Ollama 是本地模型不需要真实密钥但 OpenClaw 完全基于 OpenAI-compatible 协议设计必须提供规范的auth对象才能通过认证校验。官方推荐使用固定标识apiKey: ollama-local既安全又统一以后切换远程模型也只需要改 baseUrl。完整推荐配置已包含 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}}}}Auth 配置字段详解type: 固定写api_key或bearer两者均可推荐api_keyapiKey:必须写ollama-local这是 OpenClaw 本地模型的官方标识千万不要留空或随便改保存文件后立即重启OpenClawopenclaw tui五、步骤 4启动并测试TUI Web UIopenclaw tui看到欢迎语Wake up, my friend!就成功了输入任意问题测试。同时打开浏览器访问 Web UI配置向导里给的地址更直观。六、步骤 5连接消息应用让 AI 随时随地可用openclaw configure--sectionchannels支持 Telegram、WhatsApp、Slack、Discord、iMessage 等。选择 Telegram → 按提示输入 Bot Token 和 Chat ID去 BotFather 创建机器人→ 选择Finished保存。以后你发消息给 Telegram 机器人OpenClaw 就会在本地处理七、步骤 6安装技能让 AI 真正“动手”# 安装技能管理器npx clawhubinstallclawhub# 推荐必装技能复制执行npx clawhubinstallfilesystem-mcp# 文件系统npx clawhubinstallgithub# GitHub需 gh CLInpx clawhubinstallsummarize# 总结 PDF/网页npx clawhubinstallweather# 天气无需 APInpx clawhubinstallopenai-whisper# 本地语音识别安装后重启 TUI在聊天里说“帮我安装 GitHub 技能” 或直接用openclaw skills list检查状态。八、常见问题 终极排查90% 问题在这里解决“Authentication failed” 或 “Invalid API Key”→ 检查auth.apiKey是否精确为ollama-local大小写敏感type是否为api_key。重启 TUI 后重试。“Model context window too small (4096 tokens)”→ 手动修改~/.openclaw/agents/main/agent/models.json和主配置文件把contextWindow和maxTokens改成 32768重启 TUI。Verification failed→ 确认 Ollama 正在运行ollama listBase URL 带/v1auth对象完整无误。技能 missing→ 安装对应依赖如 GitHub 需要ghCLI然后重启。Windows 端口占用→ 任务管理器结束 ollama.exe 进程后重启。响应慢 / 空白→ 换小模型7B或确认 GPU 驱动最新上下文别超过模型上限。想换模型→ollama launch openclaw --config或直接改配置文件 primary 字段 auth 部分。九、高级玩法多模型切换在 config.json 加多个模型TUI 里说“切换到 GLM 模型”。Docker / 1Panel 部署服务器党可参考社区教程。语音输入输出安装 whisper sherpa-onnx-tts 技能。安全加固官方文档建议隔离工作区工具调用前仔细审查。结语你的本地 AI 时代正式开启恭喜你现在拥有了一个完全离线、零成本、功能媲美 Claude 的个人 AI 助理。用 Qwen3 OpenClaw 的组合日常办公、编程、总结文档、自动化任务全都搞定。本次 Auth 配置更新让你的本地部署更加规范和未来兼容强烈建议所有用户按新写法配置。喜欢这篇详细教程的同学欢迎点赞、收藏、转发后续我还会出《OpenClaw 技能开发实战》《多设备同步》《与 VS Code 深度集成》等进阶篇。有任何问题欢迎在评论区留言或直接在 TUI 里问你的 OpenClaw。现在就去终端敲ollama launch openclaw吧—— 2026 年 3 月技术永不过时隐私永不过时。本文基于 Ollama 官方文档 OpenClaw 最新协议 实际部署经验整理所有命令均亲测有效紫微AI 推荐 OpenClaw 18篇经典必读清单OpenClaw Codex正在悄悄改变我作为设计师的工作方式OpenClaw 配置本地 Ollama 模型完整指南零成本打造全离线个人 AI 助理OpenClaw从周末实验到现象级开源 AI代理OpenClaw 是猛兽但 90%用户都在血亏因为他们完全用错了大多数人以为Dify和OpenClaw都是“AI Agent平台”OpenClaw 爆火之后中国云厂商为什么集体“造Claw”一文看懂背后的技术与逻辑OpenClaw 3.0 报错大全Auth / Context / Verification 7大坑全解决附CLI 代码案例一次纠正全队同步我的OpenClaw AI Agent 3层记忆系统彻底告别“失忆”烦恼OpenClaw 多智能体系统11个隐藏玩法让营销ROI直接暴增100倍OpenClaw 接入 Telegram Bot与群组配置完整指南含常见问题排查OpenClaw你的AI智能体上下文成了杂物抽屉你只对OpenClaw的Agents发了一条消息它的Skills就把你的个人公司全自动运转起来了OpenClaw当你的电脑里突然多出一个完整团队OpenClaw 本地qwen3直出《一人公司 CEO 视角从全能手到系统掌舵人》手把手教你写好 8 个 OpenClaw Markdown 文件让 AI 同时干好 CEO、营销、运营、开发、PR 五大活自己动手建 Claw 帝国OpenClaw及新兴 Claws底层架构大揭秘OpenClaw 1M 上下文窗口AI 代理终于进化成完整操作系统当龙虾长出手OpenClaw、SOUL.md 与能动性的边界我是紫微AI在做一个「人格操作系统ZPF」。后面会持续分享AI Agent和系统实验。感兴趣可以关注我们下期见。
OpenClaw 配置本地 Ollama 模型完整指南：零成本打造全离线个人 AI 助理
发布时间：2026/6/10 6:37:23
OpenClaw 配置本地 Ollama 模型完整指南零成本打造全离线个人 AI 助理2026 最新版·含 Auth 配置大家好我是你的 AI 技术博主。今天我们来聊一个 2026 年最火的本地 AI 助理项目——OpenClaw。它能帮你清理收件箱、发邮件、管理日历、处理文件、集成 Telegram/WhatsApp甚至执行复杂任务而且完全跑在你自己的电脑上。配合Ollama运行本地模型如 Qwen3、Qwen2.5、GLM-4.7、Llama3.3 等你就可以实现真正零费用、零网络依赖、全隐私保护的智能体体验。官方从 Ollama 0.17 开始提供了ollama launch openclaw一键启动但很多朋友想深度自定义本地模型、解决上下文窗口问题、安装技能等所以我写了这篇超级详细的配置教程每一步都配命令、截图描述、坑点规避和排查方案。本次更新重点2026 年 3 月最新新增Auth 配置部分OpenClaw 最新要求必须使用嵌套auth对象本地模型的apiKey统一改为ollama-local官方推荐标识兼容性最佳无论你是 Windows、macOS 还是 Linux 用户都能一步步跟上。走完这篇你就能拥有一个比 Claude 更私密的个人 AI 秘书一、前置要求必看硬件与软件准备硬件建议本地模型跑得顺的关键GPUNVIDIA RTX 4060 及以上8GB 显存推荐Apple Silicon M2/M3/M4 也极佳。内存16GB 起步32GB 更流畅OpenClaw 系统提示词 工具调用很容易吃 10k tokens。磁盘20GB 剩余空间模型文件很大。CPU至少 8 核无 GPU 时备选。软件要求Ollama 0.17 或更高官方强烈推荐Node.js 18npm 安装 OpenClawWindows 用户建议用PowerShell 以管理员身份运行macOS/Linux 用终端即可。可选Git安装技能时用到检查命令全部复制粘贴执行node--version# 应 v18npm--version# 应 8ollama--version# 应 0.17没有 Node.js去 https://nodejs.org 下载 LTS 版安装。没有 Ollama去 https://ollama.com/download 下载对应系统版本。二、步骤 1安装 Ollama 并拉取本地模型安装 OllamaWindows 直接双击安装器macOS/Linux 执行官方脚本# macOS / Linuxcurl-fsSLhttps://ollama.com/install.sh|sh验证 Ollama 服务Windows 会自动开机自启ollama list拉取推荐本地模型强烈建议先用 7B-14B 量化版测试# 通用推荐速度快、效果好ollama pull qwen2.5:7b ollama pull qwen3:8b# 2026 新模型推理更强ollama pull glm-4.7-flash# ~25GB VRAM适合强推理ollama pull llama3.3:8b# Meta 经典进阶创建大上下文模型OpenClaw 必须 ≥16k tokensOpenClaw 默认需要 16k 上下文否则会报错。我们用 Modelfile 扩展# WindowsPowerShellcd ~\ FROM qwen2.5:7b PARAMETER num_ctx 32768 |Out-File-Encoding ascii Modelfile ollama create qwen2.5:7b-32k-f ModelfilemacOS/Linux 同理用cat Modelfile创建文件。验证ollama list ollama show qwen2.5:7b-32k--modelfile现在模型就绪Ollama 服务默认监听http://127.0.0.1:11434。三、步骤 2安装 OpenClaw最推荐方式官方一键法2026 新特性ollama launch openclawOllama 会自动检查并通过 npm 安装 OpenClaw弹出模型选择器安装 Web Search 插件本地模型无需启动 TUI终端界面直接在终端聊天即可想换本地模型执行ollama launch openclaw --model qwen2.5:7b-32k即可。手动安装方式适合想深度配置的用户npminstall-gopenclawlatest openclaw--version# 验证版本四、步骤 3配置 OpenClaw 连接本地 Ollama 模型最核心一步方式一配置向导推荐新手openclaw onboard按提示操作超级详细表格步骤操作选择Model/auth provider选择Custom Provider列表最后一项API Base URL输入http://127.0.0.1:11434/v1API Key必须填写ollama-local新版强制要求Endpoint compatibility选择OpenAI-compatibleModel ID输入你创建的模型名如qwen2.5:7b-32k其他问题技能、渠道全部Skip for now或No配置完成后会显示 Web UI 地址通常http://127.0.0.1:18789。方式二手动编辑配置文件高级用户必备配置文件位置Windows:C:\Users\你的用户名\.openclaw\openclaw.jsonmacOS/Linux:~/.openclaw/openclaw.json【新增】Auth 配置部分2026 最新推荐写法为什么必须加 auth 配置虽然 Ollama 是本地模型不需要真实密钥但 OpenClaw 完全基于 OpenAI-compatible 协议设计必须提供规范的auth对象才能通过认证校验。官方推荐使用固定标识apiKey: ollama-local既安全又统一以后切换远程模型也只需要改 baseUrl。完整推荐配置已包含 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}}}}Auth 配置字段详解type: 固定写api_key或bearer两者均可推荐api_keyapiKey:必须写ollama-local这是 OpenClaw 本地模型的官方标识千万不要留空或随便改保存文件后立即重启OpenClawopenclaw tui五、步骤 4启动并测试TUI Web UIopenclaw tui看到欢迎语Wake up, my friend!就成功了输入任意问题测试。同时打开浏览器访问 Web UI配置向导里给的地址更直观。六、步骤 5连接消息应用让 AI 随时随地可用openclaw configure--sectionchannels支持 Telegram、WhatsApp、Slack、Discord、iMessage 等。选择 Telegram → 按提示输入 Bot Token 和 Chat ID去 BotFather 创建机器人→ 选择Finished保存。以后你发消息给 Telegram 机器人OpenClaw 就会在本地处理七、步骤 6安装技能让 AI 真正“动手”# 安装技能管理器npx clawhubinstallclawhub# 推荐必装技能复制执行npx clawhubinstallfilesystem-mcp# 文件系统npx clawhubinstallgithub# GitHub需 gh CLInpx clawhubinstallsummarize# 总结 PDF/网页npx clawhubinstallweather# 天气无需 APInpx clawhubinstallopenai-whisper# 本地语音识别安装后重启 TUI在聊天里说“帮我安装 GitHub 技能” 或直接用openclaw skills list检查状态。八、常见问题 终极排查90% 问题在这里解决“Authentication failed” 或 “Invalid API Key”→ 检查auth.apiKey是否精确为ollama-local大小写敏感type是否为api_key。重启 TUI 后重试。“Model context window too small (4096 tokens)”→ 手动修改~/.openclaw/agents/main/agent/models.json和主配置文件把contextWindow和maxTokens改成 32768重启 TUI。Verification failed→ 确认 Ollama 正在运行ollama listBase URL 带/v1auth对象完整无误。技能 missing→ 安装对应依赖如 GitHub 需要ghCLI然后重启。Windows 端口占用→ 任务管理器结束 ollama.exe 进程后重启。响应慢 / 空白→ 换小模型7B或确认 GPU 驱动最新上下文别超过模型上限。想换模型→ollama launch openclaw --config或直接改配置文件 primary 字段 auth 部分。九、高级玩法多模型切换在 config.json 加多个模型TUI 里说“切换到 GLM 模型”。Docker / 1Panel 部署服务器党可参考社区教程。语音输入输出安装 whisper sherpa-onnx-tts 技能。安全加固官方文档建议隔离工作区工具调用前仔细审查。结语你的本地 AI 时代正式开启恭喜你现在拥有了一个完全离线、零成本、功能媲美 Claude 的个人 AI 助理。用 Qwen3 OpenClaw 的组合日常办公、编程、总结文档、自动化任务全都搞定。本次 Auth 配置更新让你的本地部署更加规范和未来兼容强烈建议所有用户按新写法配置。喜欢这篇详细教程的同学欢迎点赞、收藏、转发后续我还会出《OpenClaw 技能开发实战》《多设备同步》《与 VS Code 深度集成》等进阶篇。有任何问题欢迎在评论区留言或直接在 TUI 里问你的 OpenClaw。现在就去终端敲ollama launch openclaw吧—— 2026 年 3 月技术永不过时隐私永不过时。本文基于 Ollama 官方文档 OpenClaw 最新协议 实际部署经验整理所有命令均亲测有效紫微AI 推荐 OpenClaw 18篇经典必读清单OpenClaw Codex正在悄悄改变我作为设计师的工作方式OpenClaw 配置本地 Ollama 模型完整指南零成本打造全离线个人 AI 助理OpenClaw从周末实验到现象级开源 AI代理OpenClaw 是猛兽但 90%用户都在血亏因为他们完全用错了大多数人以为Dify和OpenClaw都是“AI Agent平台”OpenClaw 爆火之后中国云厂商为什么集体“造Claw”一文看懂背后的技术与逻辑OpenClaw 3.0 报错大全Auth / Context / Verification 7大坑全解决附CLI 代码案例一次纠正全队同步我的OpenClaw AI Agent 3层记忆系统彻底告别“失忆”烦恼OpenClaw 多智能体系统11个隐藏玩法让营销ROI直接暴增100倍OpenClaw 接入 Telegram Bot与群组配置完整指南含常见问题排查OpenClaw你的AI智能体上下文成了杂物抽屉你只对OpenClaw的Agents发了一条消息它的Skills就把你的个人公司全自动运转起来了OpenClaw当你的电脑里突然多出一个完整团队OpenClaw 本地qwen3直出《一人公司 CEO 视角从全能手到系统掌舵人》手把手教你写好 8 个 OpenClaw Markdown 文件让 AI 同时干好 CEO、营销、运营、开发、PR 五大活自己动手建 Claw 帝国OpenClaw及新兴 Claws底层架构大揭秘OpenClaw 1M 上下文窗口AI 代理终于进化成完整操作系统当龙虾长出手OpenClaw、SOUL.md 与能动性的边界我是紫微AI在做一个「人格操作系统ZPF」。后面会持续分享AI Agent和系统实验。感兴趣可以关注我们下期见。
