Windows版OpenClaw最新安装教程：接入本地Ollama模型与飞书机器人配置

发布时间：2026/10/13 17:59:40

Windows版OpenClaw最新安装教程：接入本地Ollama模型与飞书机器人配置
1. Windows 上跑 OpenClaw 到底卡在哪本地 Ollama 模型接入的完整链路OpenClaw 是一个可以跑在自己电脑上的个人 AI 助手框架它能接本地大模型、能挂飞书机器人、能通过网页网关对话适合想省钱又想把数据留在本地的开发者。很多人第一次在 Windows 上装它卡点其实不在 OpenClaw 本身而在三件事Node.js 环境没配好、Ollama 拉的模型不支持 tools 调用、飞书机器人回调地址填错。这篇就把这三段链路一次跑通。我实测的机器是 Windows 11Node.js 用 LTS 版本Ollama 跑 qwen3-vl:8b网关走 127.0.0.1:18789飞书那边用自建应用机器人。整个过程不需要额外网络工具全部走官方源和本地端口。下面按「环境准备 → 模型接入 → OpenClaw 配置 → 飞书联动 → 排障」的顺序写命令都可以直接复制。先说清楚整体数据流你在飞书里发一句话飞书开放平台把事件推给 OpenClaw 的 webhookOpenClaw 把这句话转成 Ollama 的 /api/chat 请求本地模型生成回复后再原路返回飞书。所以任何一环断了表现都是「飞书里机器人不回话」。定位问题时按这个链路逐段验证比盲目重装快得多。另外提醒一句OpenClaw 的网关默认只监听本机飞书要回调就必须让外网能访问到你的机器这一步在飞书配置里用「长连接」模式可以绕开公网 IP 的问题后面第 5 节会具体写。2. 前置准备Node.js、Ollama 与 TaoToken 的 API Key 获取2.1 安装 Node.js LTS 并验证去 nodejs.org 下载 LTS 版本安装时勾选「Add to PATH」。装完打开一个新的 cmd 窗口一定要新开否则 PATH 不生效执行node --version npm --version正常会输出类似v22.x.x和10.x.x。如果提示「不是内部或外部命令」说明 PATH 没配好重新安装并确认勾选项。2.2 安装 Ollama 并拉取支持 tools 的模型访问 ollama.com 下载 Windows 版安装后它会在后台常驻默认监听localhost:11434。验证服务是否起来curl http://localhost:11434/api/tags返回 JSON 列表就说明服务正常。接着拉模型这里有个关键坑不是所有模型都支持 tools 调用。OpenClaw 依赖模型的 function calling 能力deepseek-r1 系列会直接报does not support tools。推荐用 qwen 系列ollama pull qwen3-vl:8b拉完后确认ollama list能看到qwen3-vl:8b即可。如果你的机器显存较小可以换更小的 qwen 版本但上下文建议不低于 32KOpenClaw 官方推荐 64K。2.3 获取 TaoToken 的 API Key可选但推荐如果你除了本地模型还想在 OpenClaw 里挂一个云端模型做兜底本地模型答不好时切换可以准备一个 TaoToken 的 Key。它的接口兼容 OpenAI 格式Base URL 填https://taotoken.net/apiKey 在控制台生成控制台入口https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentconsoleAPI Keys 管理https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentapi-keys生成后先复制保存后面配置 provider 时要用。注意 Key 只显示一次丢了就重新生成。3. 可复制配置OpenClaw 安装、网关启动与 Ollama provider 对接3.1 安装 OpenClaw 并解决 PowerShell 脚本限制打开 PowerShell执行官方安装脚本iwr -useb https://openclaw.ai/install.ps1 | iex很多人会在这里遇到这个报错iex : 无法加载文件 D:\software\nodejs\npm.ps1因为在此系统上禁止运行脚本。 CategoryInfo : SecurityError: (:) [Invoke-Expression]PSSecurityException这是 PowerShell 执行策略拦的不是 OpenClaw 的问题。临时放开当前会话即可Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass然后再跑一次安装脚本。装完验证openclaw --version3.2 启动配置向导执行openclaw dashboard会进入交互式配置。关键选项这样填模型提供商选custom provider模型名填qwen3-vl:8bAPI Key 填任意非空字符本地 Ollama 不校验但不能留空留空会报错skill 和 hook 先跳过3.3 写入 provider 配置JSON 片段OpenClaw 的配置文件在用户目录下的.openclaw文件夹里provider 部分参考下面这段 JSON路径和字段名按你实际安装的版本对齐{ providers: { ollama-local: { type: openai-compatible, baseUrl: http://localhost:11434/v1, apiKey: ollama, models: { qwen3-vl:8b: { contextWindow: 65536, supportsTools: true } } }, taotoken-cloud: { type: openai-compatible, baseUrl: https://taotoken.net/api, apiKey: 你的_TaoToken_Key, models: { claude-sonnet-4-5: { contextWindow: 200000, supportsTools: true } } } } }注意 Ollama 的 OpenAI 兼容端点是/v1不是/api这两个别混。/api/chat是原生接口/v1/chat/completions才是 OpenAI 格式OpenClaw 走的是后者。3.4 启动网关openclaw gateway浏览器打开http://127.0.0.1:18789/能看到对话界面就说明网关起来了。如果打不开先检查 Windows 防火墙是否拦了 18789 端口临时关闭防火墙测试一下。4. 验证请求从 curl 到飞书机器人回话的成功结果4.1 先验证 Ollama 本身能对话在配置 OpenClaw 之前先用 curl 确认 Ollama 的 OpenAI 兼容接口是通的curl http://localhost:11434/v1/chat/completions -H Content-Type: application/json -d {\model\:\qwen3-vl:8b\,\messages\:[{\role\:\user\,\content\:\你好\}]}返回里有choices[0].message.content就说明模型侧没问题。如果这里就报错别往下走先解决 Ollama。4.2 验证 OpenClaw 网关能调模型在http://127.0.0.1:18789/的对话框里发一句「你好」观察返回。如果界面报reading choices之类的错误通常是 provider 的 baseUrl 写成了/api而不是/v1或者模型名拼错。4.3 飞书机器人配置与 Webhook 验证飞书这边分几步去飞书开放平台创建「企业自建应用」拿到 App ID 和 App Secret。在「事件订阅」里选择「长连接」模式这样不需要公网 IPOpenClaw 主动连飞书。在「权限管理」里开通im:message、im:message:send_as_bot等消息相关权限。在 OpenClaw 里配置 channel安装飞书插件填入 App ID 和 App Secret。配置完成后在飞书里给机器人发一条消息OpenClaw 网关日志里应该能看到事件进来然后模型返回飞书里收到回复。这一步成功整条链路就通了。如果你在飞书里想验证云端模型的效果可以临时把 provider 切到 TaoToken用模型对话页面直接测模型对话https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentchat5. 本篇常见错排查401、local proxy failed、reading choices 与 OAuth5.1 401 Unauthorized出现在调用云端 provider 时说明 API Key 错了或没带。检查配置文件里apiKey字段是否填了真实 Key注意不要有多余空格。如果是 TaoToken去 API Keys 页面重新生成一个再试。5.2 local proxy failed这个报错通常出现在 OpenClaw 尝试连本地 Ollama 时。原因有两个一是 Ollama 服务没启动二是端口不是 11434。先跑curl http://localhost:11434/api/tags确认服务活着再检查配置里的 baseUrl 端口。5.3 reading choices 报错这是解析模型返回时找不到choices字段。最常见原因是 baseUrl 用了/api而不是/v1导致返回的是 Ollama 原生格式而不是 OpenAI 格式。改成http://localhost:11434/v1即可。5.4 OAuth 相关报错飞书长连接模式如果报 OAuth 或鉴权失败检查 App ID 和 App Secret 是否配对以及应用是否已发布版本。飞书自建应用改配置后需要重新发布才生效这一步很容易漏。5.5 模型不支持 tools400 registry.ollama.ai/library/deepseek-r1:8b does not support tools换支持 function calling 的模型qwen 系列基本都支持。去 Ollama 官网的 models 页面筛选 tools 标签确认。6. 长期跑本地 AI 助手把 OpenClaw 接进日常编码与 Agent 流程链路跑通只是开始真正省事的是把它变成日常工具。如果你主要用 Claude Code 这类编码工具可以把 OpenClaw 的网关当成一个统一的模型入口本地模型处理简单问答复杂任务切到云端。TaoToken 的 Coding Plan 适合长期编码和 Agent 场景配置方式是把 Base URL 指向https://taotoken.net/apiKey 用控制台生成的Model ID 填你订阅里支持的模型Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentcoding-plan接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentdocClaude Code 的接入方式是在 settings 里配ANTHROPIC_BASE_URL和ANTHROPIC_API_KEY具体字段参考文档里的 ClaudeCodeAnthropic 章节Claude Code 接入https://taotoken.net/doc/claudecode-anthropic?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentclaudecode-anthropic最后给一个实用建议OpenClaw 的网关日志一定要开着看飞书不回话时先看日志里事件有没有进来再看模型请求有没有发出去两段一对比就知道断在哪。本地模型跑久了显存会涨定期重启 Ollama 服务能避免卡死。

相关新闻

YOLOv8 RTSP流目标检测实战：从拉流到推理的工程化落地

YOLOv8 RTSP流目标检测实战：从拉流到推理的工程化落地

简介：本资源面向计算机视觉开发者与视频监控、智能交通、工业自动化方向的工程人员，提供YOLOv8结合RTSP实时流做目标检测的完整工程包，解决从拉流、推理到结果展示的落地问题。压缩包共467个文件，约169.25MB，以145个py…

2026/10/13 16:51:46 阅读更多 →
SLR(1)分析器原理与实战调试指南

SLR(1)分析器原理与实战调试指南

简介：本资源是一份面向高校编译原理课程学习者与实验实践者的SLR(1)语法分析器Java实现项目，聚焦自底向上语法分析核心算法，帮助学生深入理解文法处理、分析表构建与移进-归约机制。压缩包共85个文件，含76个Java源码（覆…

2026/10/13 17:24:39 阅读更多 →
守望先锋S5卡顿根源：Windows内存调度深度优化指南

守望先锋S5卡顿根源：Windows内存调度深度优化指南

1. 项目概述：这不是游戏优化，而是一场系统级“内存压力测试” “守望先锋s5”这个标题里藏着三个关键信号： 版本迭代、性能瓶颈、用户集体性崩溃体验 。它不是某个人的个例，而是大量玩家在赛季更新后集中爆发的典型症状——内存…

2026/10/13 16:51:39 阅读更多 →

最新新闻

mmaction2 Charades-STA 数据集准备指南：从标注下载到 C3D 特征组织，再到 DRN 视频定位训练

mmaction2 Charades-STA 数据集准备指南：从标注下载到 C3D 特征组织，再到 DRN 视频定位训练

人工智能计算机视觉深度学习 【免费下载链接】mmaction2 OpenMMLabs Next Generation Video Understanding Toolbox and Benchmark 项目地址： https://gitcode.com/gh_mirrors/mm/mmaction2 点击查看 免费下载 本文围绕 mmaction2 仓库中 Charades-STA 数据准备文档…

2026/10/13 17:59:40 阅读更多 →
QT框架下旅行模拟查询系统的开发与优化实践

QT框架下旅行模拟查询系统的开发与优化实践

1. 项目概述与核心价值这个旅行模拟查询系统本质上是一个集成了地图可视化、路径规划和信息查询的桌面端应用。不同于简单的网页版工具，基于QT框架的C实现让它具备了本地化运行的高效性，特别适合需要处理大量地理数据或复杂计算场景的旅行规划需求。我去…

2026/10/13 17:59:40 阅读更多 →
向量库索引膨胀致C盘0字节？从原理到重建的完整排查指南

向量库索引膨胀致C盘0字节？从原理到重建的完整排查指南

C盘红了、0字节，数据库直接罢工，这段经历让我每次想起来都后背发凉。我跑的这个微客AI 项目其实不大，原始数据只有 75M，本来以为撑死占个几百兆磁盘空间，结果向量库硬生生把索引撑到了 48.6G，直接把 C 盘干…

2026/10/13 17:59:40 阅读更多 →
SSM毕设实战：农村宅基地管理系统设计与运行全解析

SSM毕设实战：农村宅基地管理系统设计与运行全解析

简介：这是一套基于SSM框架开发的农村宅基地管理系统，属于完整的JavaWeb工程项目，适合计算机相关专业学生用于毕业设计或课程设计实训。系统围绕宅基地审批业务，设计了村民、村委、镇府、县委、管理员五个角色端，覆盖村…

2026/10/13 17:59:40 阅读更多 →
C语言学习心得：从基础语法到项目实战的完整成长路线

C语言学习心得：从基础语法到项目实战的完整成长路线

1. 初识C语言:为什么值得下一个"笨功夫"1.1 一个现实的选择:C语言到底能做什么说起我和C语言的结缘，很多人可能不信——一开始我根本不是奔着"成为程序员"去的。那时候我只是想弄明白，电脑上那些程序到底是怎么跑起来的。同学给我推…

2026/10/13 17:59:40 阅读更多 →
WSL 下 CPU 版 Caffe 与 Faster R-CNN 环境搭建实战

WSL 下 CPU 版 Caffe 与 Faster R-CNN 环境搭建实战

1. 为什么要在 WSL 里折腾 CPU 版 Caffe 和 Faster R-CNN先把场景说清楚。你手里大概率是一台 Windows 笔记本或者台式机，显卡要么是核显，要么是 N 卡但驱动环境不想动，总之短期内不打算碰 CUDA。可你又想跑通一个经典的目标检测流程&#xf…

2026/10/13 17:58:35 阅读更多 →

日新闻

物联网系统集成避坑指南：从选型到验收的关键要点

物联网系统集成避坑指南：从选型到验收的关键要点

做了这么多年物联网系统集成的项目，我最大的感受是，大部分坑不是出在技术前沿，而是出在一些看起来很平常的地方。设备选了便宜的、协议没问清楚、现场没摸透、验收标准写得含糊——这些细枝末节，最后都会变成延期、超支和扯皮的大…

2026/10/13 0:00:57 阅读更多 →
ESP32舵机控制全攻略：从PWM原理到高级玩法与常见故障排查

ESP32舵机控制全攻略：从PWM原理到高级玩法与常见故障排查

如果你玩ESP32有一阵子了，很难不碰到舵机控制这道坎。做智能小车要转方向，做机械臂要抬关节，做云台要偏航俯仰，背后都是同一个东西在干活：舵机。而我见过太多人卡在“代码能编译、舵机就是不听话”这个阶段&#xff0c…

2026/10/13 0:00:57 阅读更多 →
CAN总线原理与STM32实战：抗干扰、仲裁、错误处理全解析

CAN总线原理与STM32实战：抗干扰、仲裁、错误处理全解析

1. 为什么CAN总线至今仍是工业现场的“硬通货”？——从汽车底盘到智能温室的真实需求你有没有拆过一辆老款燃油车的中控台？或者调试过某高校实验室里那台跑着Modbus协议却频频丢帧的PLC控制柜？又或者，在某个农业物联网项目里&…

2026/10/13 0:00:57 阅读更多 →

周新闻

流感时间序列预测实战：ARIMA/LSTM全流程拆解与避坑指南

流感时间序列预测实战：ARIMA/LSTM全流程拆解与避坑指南

简介：基于 ARIMA、LSTM、Transformer 等模型的流感时间序列预测 Python 源码，面向计算机相关专业课程设计与期末大作业学生，以及项目实战学习者。内容覆盖预处理、平稳性检验、定阶、残差分析、多模型对比预测的完整时序建模流程，…

2026/10/13 2:54:56 阅读更多 →
影刀RPA新手教程：键盘模拟输入实战——输入文本与模拟按键的区别

影刀RPA新手教程：键盘模拟输入实战——输入文本与模拟按键的区别

影刀RPA新手教程：键盘模拟输入实战——输入文本与模拟按键的区别 做影刀RPA自动化，十个新手有八个栽在"往输入框里填东西"这件事上：要么填不进去，要么填了一半，要么直接把原来内容追加在后面。这背后的根因&…

2026/10/13 16:22:04 阅读更多 →
影刀RPA新手教程：阅文起点小说数据采集实战——书籍信息与章节内容

影刀RPA新手教程：阅文起点小说数据采集实战——书籍信息与章节内容

影刀RPA新手教程：阅文起点小说数据采集实战——书籍信息与章节内容 1. 认识影刀：什么场景该用RPA采小说数据 起点中文网的页面结构相对稳定——分类榜单、书籍详情、章节内容三块独立页面，跳转链路清晰。这种场景非常适合影刀自动化&#x…

2026/10/13 1:58:08 阅读更多 →

月新闻

我发现了一个新思路：用 Remotion + Claude Code 像写代码一样自动化生成短视频

我发现了一个新思路：用 Remotion + Claude Code 像写代码一样自动化生成短视频

/* MD / 富文本中的 .toc（含博客园搬家等嵌套结构）；.toc-box 在侧栏，不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p（:empty 仍占 20px），一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/10/12 21:05:09 阅读更多 →
Windows下 Codex 中 Chrome 和 Computer Use 插件不可用问题排查及解决参考方式：TaoToken 统一 Key 配置与验证

Windows下 Codex 中 Chrome 和 Computer Use 插件不可用问题排查及解决参考方式：TaoToken 统一 Key 配置与验证

/* MD / 富文本中的 .toc（含博客园搬家等嵌套结构）；.toc-box 在侧栏，不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p（:empty 仍占 20px），一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/10/13 14:57:39 阅读更多 →
黑夜航拍船只数据集训练YOLOV5模型全流程解析

黑夜航拍船只数据集训练YOLOV5模型全流程解析

/* MD / 富文本中的 .toc（含博客园搬家等嵌套结构）；.toc-box 在侧栏，不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p（:empty 仍占 20px），一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/10/12 18:11:17 阅读更多 →