1. OpenClaw 2.6.4 到底是什么Windows 小白第一次部署会遇到什么OpenClaw 2.6.4 是一个能在你自己 Windows 电脑上跑起来的本地 AI 智能体框架社区里习惯叫它「小龙虾」。它和普通聊天机器人的区别在于你给它一句自然语言指令它会自己拆解步骤、调用工具、操作文件甚至控制浏览器把整件事从头做到尾。适合谁适合不想写代码、但想让电脑帮忙干重复活的人比如整理下载文件夹、批量提取 Word 内容、把搜索结果汇总成表格。我第一次在 Windows 上装它的时候卡在 Gateway 离线整整半小时后来才发现是安装路径里带了一个中文字符。所以这篇部署指南会把你可能踩的坑提前铺平从安装包获取、环境准备、解压、启动拦截处理到激活验证和第一个任务跑通每一步都给可复制的动作。需要先明确一点OpenClaw 本体负责「调度和干活」真正让它能听懂话、能推理的是背后接的大模型。默认它需要你填一个模型服务的地址和 Key。很多新手在这一步懵掉因为不知道去哪找稳定的 API 通道。我实测下来用 TaoToken 的统一 Key 通道接进去最省事一个 Key 就能调多种模型不用在好几个平台之间来回注册。官网入口是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 地址是 https://taotoken.net/api 后面第三节会给完整的配置片段。这一节先把「部署前你要准备什么」讲清楚。你的 Windows 建议是 Win10 1909 以上或 Win11内存 8GB 起步16GB 更稳磁盘留出至少 5GB 空间。安装包大约 47.5MB解压后展开会到几百 MB因为里面内置了运行依赖。下载时建议用浏览器自带下载或带断点续传的工具避免下到一半断了导致压缩包损坏——损坏的包解压出来会缺文件启动时直接报错这是新手最常见的翻车点之一。还有一件事必须提前做临时关闭杀毒软件的实时防护。OpenClaw 要模拟键鼠、读写文件、控制浏览器这些行为在杀软眼里和恶意程序高度相似很容易被拦截甚至直接删掉核心文件。关掉只是为了防止误删装完验证没问题后你可以再开回来把 OpenClaw 目录加进白名单即可。这不是让你长期裸奔而是给部署过程让路。环境准备其实就三件事确认系统版本、留足磁盘、关掉实时防护。剩下的 Git、Node.js、Python 这些依赖2.6.4 的一键包会自己检测并补齐你不需要手动装。这一点比早期版本友好太多早期你得自己配环境变量现在全程可视化点几下就行。下面进入正式部署。2. TaoToken 前置准备拿到统一 Key 和 API 地址在启动 OpenClaw 之前我建议你先把模型通道准备好否则装完打开界面发现没法对话还得回头折腾。TaoToken 在这里扮演的角色是「统一模型入口」你注册后拿到一个 API Key再配一个 Base URL就能在 OpenClaw 里调用多种模型不用为每个模型单独申请账号。第一步打开官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 完成注册登录。登录后进入控制台地址是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_campaignrewriteutm_contentconsole 。在控制台里你能看到账户余额、用量统计以及最关键的 API Key 管理入口。第二步创建 API Key。进入 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_campaignrewriteutm_contentapi-keys 点新建系统会生成一串以 sk- 开头的密钥。这串东西只显示一次复制下来存到记事本里别截图发群里。如果你不小心泄露了回这个页面删掉重建即可。第三步记住两个地址。Base URL 用 https://taotoken.net/api 注意这里不加任何查询参数就是干净的 API 根地址。模型 ID 你可以先在模型对话页面试一下有哪些可用地址是 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_campaignrewriteutm_contentchat 在里面选一个模型发句话确认能正常回复再把这个模型 ID 填进 OpenClaw。这里解释一下为什么推荐走统一通道。OpenClaw 的配置里要填 Base URL、API Key、Model ID 三样东西。如果你直连某个模型厂商换模型就得改地址、换 Key、改模型名三处都要动。用 TaoToken 的话Base URL 和 Key 固定不变只改 Model ID 就能切换模型对新手来说少了很多出错机会。而且一个 Key 的额度是通用的不用在多个平台分别充值。如果你打算长期用 OpenClaw 跑自动化任务比如每天定时整理文件、批量处理文档那调用量会比较大可以考虑 Coding Plan 这类面向持续使用的方案入口在 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_campaignrewriteutm_contentcoding-plan 。它的定位是给长期编码和 Agent 场景用的比按次调用更划算。不过第一次部署验证用普通 Key 就够了先跑通再说。拿到 Key 之后先别急着关页面我们马上要在 OpenClaw 里填进去。你可以把 Key 先粘到记事本等会儿复制粘贴用。顺便确认一下你的账户有余额余额为 0 的话请求会返回 401这个报错后面第五节会专门讲怎么对照排查。3. 可复制配置OpenClaw 2.6.4 的安装与模型接入片段这一节是整篇的核心给你可以直接复制的配置和逐步动作。先说安装包获取2.6.4 版本的一键包在官方发布渠道下载文件名类似 Openclaw-Windows-2.6.4.zip。下载完成后千万别用 Windows 自带的解压工具它经常把长路径文件解坏或者丢权限。用 WinRAR 或 7-Zip右键压缩包选「解压到当前文件夹」等一两分钟会生成一个 Openclaw-win 文件夹里面有个红色龙虾图标的「一键启动.exe」看到它就说明解压成功。双击启动程序如果弹出「Windows 已保护你的电脑」点左下角「更多信息」再点「仍要运行」。这是 SmartScreen 的正常拦截不是病毒。进入欢迎界面后点「开始使用」接下来是安装路径选择这一步是部署成败的关键路径必须是纯英文不能有中文、空格、特殊符号。推荐 D:\OpenClaw不要用 D:\软件\OpenClaw 或 D:\Open Claw。选好路径勾选协议点「开始安装」然后等 3 到 5 分钟期间不要关窗口。安装完成后程序会自动启动第一次会显示「正在等待 Gateway 就绪」等 1 到 3 分钟界面跳到聊天窗口右上角显示「Gateway 在线」就成功了。接下来是接入模型。OpenClaw 的配置文件在安装目录下的 config 文件夹里2.6.4 版本主要认两个文件一个是 .env一个是 settings.json。你可以直接在界面里的设置页填也可以手动改文件。手动改更直观我给你可复制的片段。先看 .env 文件路径是 D:\OpenClaw\config.env用记事本打开填入下面内容# TaoToken 统一模型通道 OPENAI_API_BASEhttps://taotoken.net/api OPENAI_API_KEYsk-你刚才复制的Key OPENCLAW_MODEL_IDgpt-4o-mini OPENCLAW_GATEWAY_PORT18789注意 OPENAI_API_BASE 后面不要加斜杠也不要加 /v1就写到 /api 为止。Key 换成你自己的。Model ID 先填一个你确认可用的比如 gpt-4o-mini跑通后再换别的。再看 settings.json路径是 D:\OpenClaw\config\settings.json这个文件控制 Gateway 和模型路由片段如下{ gateway: { host: 127.0.0.1, port: 18789, autoStart: true }, model: { provider: openai-compatible, baseUrl: https://taotoken.net/api, apiKey: sk-你刚才复制的Key, modelId: gpt-4o-mini, timeout: 60000 }, agent: { mode: auto, maxSteps: 20 } }这两个文件里的 Base URL、Key、Model ID 三件套必须一致否则会出现「配置读取成功但请求失败」的怪现象。改完保存回到 OpenClaw 界面点右上角「重启」让 Gateway 重新加载配置。重启后右上角应该还是「在线」如果变离线看第五节排查。如果你用的是 Claude Code 这类工具做润色或辅助配置逻辑一样Base URL 填 https://taotoken.net/api Key 填同一个Model ID 按需换。文档入口在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_campaignrewriteutm_contentdoc 里面有各客户端的接入示例遇到字段名对不上可以对照查。配置写完后建议先别急着跑复杂任务用一条最简单的指令验证链路。在输入框里发「你好请回复当前使用的模型名称」如果它能正常回你说明 Key、Base URL、Model ID 三样都通了。这一步过了再上自动化任务。4. 验证请求与成功结果跑通第一个本地任务配置改完重启后怎么确认真的通了我给你一套逐步验证动作照着做就行。第一步看 Gateway 状态。主界面右上角显示「Gateway 在线」绿色标识。如果显示离线先别慌点旁边的「重启」按钮等 30 秒再看。第一次启动时 Gateway 初始化慢是正常的等 1 到 3 分钟。第二步发一条探针指令。在底部输入框输入「请用一句话说明你现在能做什么」按 Enter。正常情况 2 到 5 秒内会返回一段文字。如果超过 30 秒没反应或者报错记下报错原文对照第五节。第三步跑一个真实的小任务。我建议从最简单的文件整理开始指令写具体一点比如「帮我统计 D:\Test 文件夹里有多少个文件把文件名列出来」。先在 D 盘建一个 Test 文件夹随便放几个文件进去。发送后OpenClaw 会调用工具去读目录然后把结果返回给你。成功的话你会看到它列出了文件名和数量。第四步验证模型调用确实走了 TaoToken。回到 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_campaignrewriteutm_contentconsole 刷新用量页面你应该能看到刚才那几次请求的记录包括消耗的 token 数。这一步很关键它证明你的请求真的打到了统一通道而不是本地缓存或者别的什么。如果控制台没有记录说明配置里的 Base URL 或 Key 没生效回去检查 .env 和 settings.json 是否一致。第五步试一个稍复杂的任务确认 Agent 能多步执行。指令「打开浏览器搜索今天的天气把结果整理成一句话告诉我」。这个任务会触发浏览器控制工具OpenClaw 会自己打开浏览器、输入关键词、读取页面、汇总结果。第一次跑可能会慢一点因为要初始化浏览器控制组件。成功返回天气信息就说明你的 OpenClaw 已经是一个能干活的数字员工了。实测下来从安装到跑通第一个任务顺利的话 15 分钟内能搞定。卡住的地方基本集中在三处路径含中文、杀软拦截、模型配置三件套不一致。这三处我在前面都给了规避方法。跑通之后你可以把常用指令存成模板比如「整理下载文件夹」「提取 Word 标题」下次直接调用。还有个小技巧OpenClaw 的日志在安装目录的 logs 文件夹里遇到奇怪问题时打开最新的 log 文件搜 error 或 fail能看到具体是哪一步断了。比在界面上瞎点高效得多。5. 本篇常见报错排查对照表401、local proxy failed、reading choices、OAuth部署和使用过程中报错是难免的。这一节把最常见的几类报错和对应处理列出来你遇到时直接对照。401 Unauthorized。这个几乎都是 Key 的问题。可能原因Key 复制时多了空格或换行Key 已过期或被删除账户余额为 0。处理回到 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_campaignrewriteutm_contentapi-keys 重新复制一次 Key注意首尾不要带空格。然后确认控制台余额大于 0。改完 .env 和 settings.json 两处重启 Gateway。local proxy failed / 本地代理失败。这个报错通常出现在 Gateway 启动阶段意思是本地端口被占用或者配置里的 host 写错了。处理检查 settings.json 里 gateway.host 是不是 127.0.0.1port 是不是 18789。如果端口被别的程序占了把 18789 改成 18790 再重启。另外确认你没有在系统里设置过全局代理OpenClaw 走的是直连多余的代理设置会干扰它。reading choices / 读取 choices 字段失败。这个报错说明请求发出去了但返回的数据结构不是 OpenClaw 预期的格式。常见原因是 Base URL 写错了比如多加了 /v1 或者结尾多了斜杠。处理把 OPENAI_API_BASE 严格写成 https://taotoken.net/api 不要加任何后缀。同时确认 Model ID 是真实可用的填了一个不存在的模型名也会导致返回格式异常。OAuth 相关报错 / 授权失败。如果你在配置里误开了某些需要 OAuth 的 provider或者 Model ID 填成了需要额外授权的模型会报这个。处理把 provider 改成 openai-compatible用 Key 认证而不是 OAuth。确认 settings.json 里 model.provider 字段是 openai-compatibleapiKey 字段填的是 sk- 开头的 Key。Gateway 一直离线。按顺序排查杀软是否彻底关闭含后台进程安装路径是否纯英文点重启按钮等 30 秒还不行就关掉 OpenClaw重新运行一键启动.exe。如果重装先把旧目录删干净再装。第一次启动特别慢。这是正常的第一次要初始化依赖和浏览器组件等 1 到 3 分钟。后续启动几秒就开。不要因为慢就反复关掉重开那样反而更慢。界面能开但发指令没反应。先看 Gateway 是否在线再看控制台有没有请求记录。如果控制台没记录说明请求没发出去检查 Base URL 和 Key。如果有记录但界面没显示可能是前端渲染问题重启一次界面。把这几条存下来遇到报错先对照能省下大量到处搜的时间。排查的核心思路就一条先确认 Gateway 在线再确认三件套Base URL、Key、Model ID一致最后看控制台有没有请求记录。这三步能定位 90% 的问题。6. 长期使用建议与接入文档入口跑通第一个任务之后你可能会想让它干更多活。这里给几个实用建议。第一把常用指令写成固定模板存在本地比如「整理下载文件夹」「批量提取文档标题」需要时直接调用比每次重新描述省事。第二定期去控制台看用量了解自己的调用习惯如果发现某类任务消耗特别大可以针对性优化指令让它少走弯路。第三给 OpenClaw 的安装目录加进杀软白名单这样你重新开启实时防护后它也不会被误伤。如果你打算把 OpenClaw 接到更多场景比如定时任务、多步骤自动化建议先把接入文档过一遍地址是 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_campaignrewriteutm_contentdoc 里面有字段说明和示例遇到配置对不上时查起来很快。模型对话页面 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_campaignrewriteutm_contentchat 可以用来快速测试某个模型 ID 是否可用换模型前先去那里试一句确认能回复再填进配置能避免很多「配置改了但跑不通」的情况。长期跑自动化任务的话Coding Plan 那个入口可以了解一下https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_campaignrewriteutm_contentcoding-plan 它面向的是持续调用场景比零散按次更合适。不过还是那句话先把基础链路跑稳再考虑升级方案。最后提醒一个容易忽略的点OpenClaw 的配置文件改完后一定要重启 Gateway 才生效光保存文件不重启是没用的。我见过有人改完配置直接发指令结果还是走旧配置折腾半天以为是 Key 坏了。养成「改配置就重启」的习惯能省很多事。