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

OpenClaw + Ollama 本地全离线部署实战指南

在 Windows 系统下搭建本地 AI Agent 的完整流程。首先安装 Node.js 和 Git 环境,随后部署 Ollama 并拉取通义千问模型。接着全局安装 OpenClaw,配置其与本地 Ollama 服务的连接。最后通过 Web 控制台生成令牌登录,实现完全离线的 AI 对话与任务自动化。该方案零费用且保护数据隐私。

PhpPioneer发布于 2026/4/6更新于 2026/7/2559 浏览

一、环境准备

在开始之前,请以管理员身份打开 PowerShell(按下 Win + X 选择)。这是我们接下来的操作中心。

1. 安装 Node.js (v18+)

Node.js 是 OpenClaw 的运行环境,安装它时 npm 会自动就位。

  1. 访问 Node.js 官网,下载 LTS (长期支持) 版本的 Windows 安装包 (.msi)。
  2. 双击运行安装程序。关键步骤:在自定义安装界面,务必勾选 Add to PATH。
  3. 一路 Next 完成安装。

验证:在 PowerShell 中输入以下命令,若显示版本号(如 v18.x.x),则成功。

node -v
npm -v
2. 安装 Git

Git 用于管理代码和扩展技能,是生态的重要组成部分。

  1. 访问 Git 官网 下载 Windows 版安装包。
  2. 运行安装程序,建议保持所有默认选项,特别是确保将 Git 添加到系统 PATH 中。

验证:在 PowerShell 中输入命令,若显示版本信息则成功。

git --version

二、部署 Ollama (本地模型引擎)

Ollama 是你的本地模型管家,负责承载 AI 的'大脑'。

1. 安装与配置
  1. 访问 Ollama 官网 下载 Windows 版本并安装。
  2. 环境变量配置 (推荐):为了让模型响应更快,避免重复加载,建议设置模型常驻内存。
    • 按下 Win 键,搜索'环境变量',点击「编辑系统环境变量」 -> 「环境变量」。
    • 在'系统变量'中点击「新建」:
      • 变量名:OLLAMA_KEEP_ALIVE
      • 变量值:24h
2. 下载核心模型

很多用户报错 file does not exist 是因为模型标签过旧或拼写错误。请使用以下绝对可用的命令:

首选通用命令 (推荐): 直接运行以下命令,Ollama 会自动匹配并下载一个性能均衡的量化版通义千问模型(约 5-6GB)。

ollama run qwen:8b-instruct-q4_K_M

解释:q4_K_M 是目前兼容性最好的量化格式,在 8GB 显存的设备上也能流畅运行。

备选方案: 如果官网下载速度慢或失败,可以尝试使用镜像源:

ollama run dengcao/qwen:8b-q4_0

验证:下载完成后,看到 >>> 符号即代表模型已在本地运行。

三、部署 OpenClaw (AI Agent 核心)

OpenClaw 是 AI 的大脑,它将利用 Ollama 提供的模型能力,执行复杂的任务自动化。

1. 安装 OpenClaw

在 PowerShell 中执行以下命令进行全局安装:

npm install -g openclaw

若安装速度慢,可先切换国内源:

npm config set registry https://registry.npmmirror.com

验证:

openclaw --version
2. 初始化与配置
  1. 初始化向导:
openclaw onboard
  1. 在交互式向导中,除模型配置外可一路回车。当询问是否配置模型时,选择 Skip for now (稍后手动配置)。
  2. 手动对接 Ollama: 依次执行以下三行命令,告诉 OpenClaw 如何连接本地的 Ollama。注意:第三行的模型名必须与 ollama list 中显示的完全一致。
openclaw config set models.providers.ollama.apiKey "ollama-local"
openclaw config set models.providers.ollama.baseUrl "http://localhost:11434/v1"
openclaw config set models.default "ollama/qwen:8b-instruct-q4_K_M"
  1. 重启生效:
openclaw restart
openclaw gateway start

四、启动与验证

1. 获取访问令牌

在 PowerShell 中执行,生成并复制你的登录令牌:

openclaw token generate
2. 打开 Web 控制台
  1. 打开浏览器,访问:http://localhost:18789/
  2. 粘贴刚才复制的令牌,点击登录。
3. 开始对话

在输入框中输入:'你好,本地助手!',如果收到流畅回复,恭喜你,部署成功!现在你可以断开网络测试,它依然能工作。

五、常见问题与避坑指南

问题现象解决方案
拒绝访问 / 权限不足请务必右键点击 PowerShell,选择 '以管理员身份运行' 后再执行命令。
node 不是内部命令Node.js 安装时未配置环境变量。请重装 Node.js,并勾选 Add to PATH。
拉取模型速度极慢使用镜像命令 ollama run dengcao/qwen:8b-q4_0,或开启代理工具。
模型上下文太小请务必使用 q4_K_M 等量化版本,它们通常已包含足够的上下文窗口(约 32K)。

进阶提示: 部署完成后,你可以在控制台安装'文件处理'、'浏览器控制'等插件,让你的本地 AI 助手帮你自动整理下载文件夹、查询资料,真正解放生产力!

目录

  1. 一、环境准备
  2. 1. 安装 Node.js (v18+)
  3. 2. 安装 Git
  4. 二、部署 Ollama (本地模型引擎)
  5. 1. 安装与配置
  6. 2. 下载核心模型
  7. 三、部署 OpenClaw (AI Agent 核心)
  8. 1. 安装 OpenClaw
  9. 2. 初始化与配置
  10. 四、启动与验证
  11. 1. 获取访问令牌
  12. 2. 打开 Web 控制台
  13. 3. 开始对话
  14. 五、常见问题与避坑指南
  • 免费图片AI生成工具免费生成了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 免费图片视频在线生成30秒,将你的创意变成现实开始设计
  • X/Twitter免费视频下载器免登陆无限额度免费视频解析下载了解详情
  • 100+免费在线小游戏爽一把
极客日志微信公众号二维码

微信扫一扫,关注极客日志

微信公众号「极客日志V2」,在微信中扫描左侧二维码关注。展示文案:极客日志V2 zeeklog

更多推荐文章

查看全部
  • AI 内容安全审核:Qwen3Guard-Gen-WEB 部署与使用教程
  • Kiro AI 助手完整使用指南
  • Elden Ring AI 绘画指南:基于 Stable Diffusion 的黑暗奇幻创作
  • C++11 左值右值引用区别与移动语义解决传值返回对象销毁问题
  • AI 编程实战:自动化代码生成、低代码与算法优化
  • 前缀和算法详解:一维与二维前缀和模板实现
  • SpringBoot+Vue 老年人景区订票系统设计与实现
  • VSCode 连接 GitHub 全攻略:上传与克隆代码操作指南
  • Windows 系统安装 RabbitMQ 及 Erlang 环境配置指南
  • Webnovel Writer:基于 Claude Code 的长篇网文 AI 创作系统
  • UnityMCP+Claude+VSCode 构建 AI 游戏开发环境
  • Faster Whisper v1.7 本地部署教程:支持 AMD 显卡与日文转中文
  • OpenCode 能否替代 Copilot?生产环境落地对比评测
  • VSCode 远程 SSH 环境下 Copilot Claude 模型及 Agent 模式配置指南
  • OpenClaw 安装及飞书机器人配置流程
  • AI 绘画提示词引导系数设置指南:从原理到实践
  • Ubuntu 部署 Ollama 与 Open WebUI 运行本地大模型
  • 前端文本测量瓶颈突破:Pretext 用户态纯 TypeScript 引擎
  • Flutter 三方库 dart_webrtc 在鸿蒙系统上的适配指南
  • OpenClaw 集成 GitHub Copilot 指南

相关免费在线工具

  • 加密/解密文本

    使用加密算法(如AES、TripleDES、Rabbit或RC4)加密和解密文本明文。 在线工具,加密/解密文本在线工具,online

  • RSA密钥对生成器

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

  • Mermaid 预览与可视化编辑

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

  • 随机西班牙地址生成器

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

  • Gemini 图片去水印

    基于开源反向 Alpha 混合算法去除 Gemini/Nano Banana 图片水印,支持批量处理与下载。 在线工具,Gemini 图片去水印在线工具,online

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online