1. 为什么新手部署 OpenClaw 2.6.4 总卡在最后一步OpenClaw 2.6.4 是一个能在 Windows 本地运行的 AI 智能体框架你可以把它理解成一个「听得懂人话、还能自己动手操作电脑」的数字员工你说一句「把下载文件夹里的图片按日期归档」它会自己拆解任务、调用工具、执行文件操作。它适合谁适合不想写代码、但想让电脑帮忙干重复活的人——整理文件、批量重命名、抓取网页数据、生成表格这些都能交给它。但我在帮朋友装的时候发现一个规律安装包解压、启动程序、等 Gateway 就绪这些步骤大部分人能过真正让人卡住的是最后一步——模型通道没配好。OpenClaw 本身只是个「身体」它需要接一个「大脑」才能理解指令。默认配置里要么留空要么指向一个你根本没有的本地模型地址结果就是界面显示 Gateway 在线但你一发指令就报连接超时或者 401。这篇教程就按「先跑通安装、再配通模型」的顺序走。安装部分我尽量写得傻瓜化配置部分给出完整的config.toml骨架并且用 TaoToken 的统一 Key 作为模型通道——这样你不需要分别去申请多家模型的 Key一个 Key 就能切换不同模型对新手来说少踩很多坑。全程 Windows 环境跟着做基本能一次跑通。2. 部署前的环境准备与安装包获取2.1 确认你的 Windows 环境OpenClaw 2.6.4 对系统要求不算高但有几个硬性条件得先确认项目最低要求建议配置系统版本Windows 10 1909Windows 11 22H2内存8GB16GB磁盘空间5GB 可用20GB 可用模型缓存会涨运行库.NET 4.8.NET 4.8 VC 2015-2022按Win R输入winver能看到系统版本。如果低于 1909建议先更新系统否则启动程序可能直接闪退。2.2 获取安装包安装包从官方发布渠道获取下载后是一个压缩包大小在几十 MB 量级。下载时建议用浏览器自带下载或支持断点续传的工具避免中途断流导致包损坏。下载完成后先别急着解压右键看一下文件大小是否和页面标注一致差太多就重新下。2.3 解压别用系统自带工具这一步很多人栽跟头。Windows 自带的解压对含大量小文件的包容易丢权限解压出来启动程序点不动。用 7-Zip 或 WinRAR右键选择「解压到当前文件夹」等它跑完。解压后目录里应该有一个带图标的启动程序双击能弹出欢迎界面就说明包是完整的。注意解压路径同样建议纯英文比如D:\OpenClaw。路径里带中文或空格后面配置阶段容易出莫名其妙的错。2.4 关闭实时防护仅安装阶段OpenClaw 需要模拟键鼠、读写文件这类行为容易被实时防护误判。安装和首次启动阶段把 Windows Defender 的实时防护、以及第三方安全软件的防护临时关掉。装完、确认能正常跑起来之后再把防护开回来并把 OpenClaw 的安装目录加入白名单。这样既不影响安全也不会误删核心文件。3. 启动安装与 Gateway 就绪验证3.1 运行启动程序进入解压目录双击启动程序。如果弹出「Windows 已保护你的电脑」点「更多信息」再点「仍要运行」。这是 SmartScreen 对未知发布者的常规拦截不是病毒告警。3.2 选择安装路径并开始安装欢迎界面点「开始使用」进入路径选择。这里再强调一次纯英文、无空格、无特殊符号。推荐D:\OpenClaw。勾选协议后点「开始安装」程序会自动检测环境、补齐依赖、部署核心文件、创建快捷方式。整个过程 3 到 5 分钟期间不要关窗口中断了得重来。3.3 第一次启动等待 Gateway安装完成后程序会自动启动主界面。第一次启动时 Gateway 服务要初始化界面会显示「正在等待 Gateway 就绪」。等 1 到 3 分钟是正常的后续启动就几秒。等右上角变成「Gateway 在线」说明身体部分装好了。到这里只是「身体」能动了但还没接「大脑」。下面进入配置环节。4. 接入 TaoToken 统一 Key 的 config.toml 骨架4.1 先拿到统一 Key打开 TaoToken 官网注册后进入控制台创建 API Key。地址是 https://taotoken.net/api 控制台里能看到 Key 管理和用量统计。创建好的 Key 形如一串字符复制保存好后面要填进配置文件。TaoToken 的好处是统一通道你不需要为每个模型单独申请 Key一个 Key 就能调用不同模型。对 OpenClaw 这种需要频繁切换模型的场景很省事。4.2 找到配置文件OpenClaw 的配置文件在安装目录下的config文件夹里文件名是config.toml。用记事本或 VS Code 打开。如果里面已经有内容先备份一份再改。4.3 完整的 config.toml 骨架下面这份骨架可以直接参考把your_api_key_here换成你刚才复制的 Key# OpenClaw 2.6.4 模型通道配置 [gateway] host 127.0.0.1 port 8765 auto_start true [model] # 使用 TaoToken 统一通道 provider openai_compatible base_url https://taotoken.net/api/v1 api_key your_api_key_here model_name gpt-4o-mini timeout 60 max_retries 3 [agent] mode auto max_steps 20 workspace D:\\OpenClaw\\workspace [log] level info path D:\\OpenClaw\\logs几个关键字段说明base_url指向 TaoToken 的 API 入口注意结尾是/v1这是 OpenAI 兼容格式的约定。api_key填你创建的那串 Key。model_name可以先填一个通用模型跑通之后再换。workspace是智能体操作文件的默认目录建议单独建一个别直接指向整个 D 盘。注意TOML 里反斜杠要写成双反斜杠\\否则会被当成转义字符。这是新手最容易忽略的细节。4.4 保存并重启 Gateway改完保存回到 OpenClaw 主界面点右上角「重启」让配置生效。重启后 Gateway 会重新读取 config.toml。5. 连通性验证发一条真实指令看结果配置改完不能只看界面显示得实际发一条指令验证通道是否真的通了。5.1 用 curl 先测通道在 PowerShell 里跑一条请求确认 Key 和地址没问题curl -X POST https://taotoken.net/api/v1/chat/completions ^ -H Authorization: Bearer your_api_key_here ^ -H Content-Type: application/json ^ -d {\model\:\gpt-4o-mini\,\messages\:[{\role\:\user\,\content\:\ping\}]}如果返回里带choices字段和一段回复内容说明通道是通的。如果返回 401检查 Key 有没有复制错返回 404检查base_url结尾的/v1有没有漏。5.2 在 OpenClaw 里发指令回到主界面在底部输入框发一条简单指令比如「列出我 workspace 目录下的所有文件」。如果智能体能返回文件列表说明从 OpenClaw 到 TaoToken 再到模型的整条链路都通了。5.3 验证成功的样子成功的标志有三个右上角 Gateway 在线、指令发出后几秒内有响应、响应内容符合你的指令意图。这时候你可以试着发一条稍复杂的比如「在 workspace 里新建一个 test 文件夹然后在里面写一个 hello.txt内容写 hello openclaw」。看它能不能自己拆解成建目录、写文件两步并执行。6. 本篇常见报错排查6.1 Gateway 一直离线先确认安装路径是纯英文再确认实时防护有没有把核心文件删了。如果文件被隔离去隔离区恢复重新解压。还不行就关掉 OpenClaw重新运行启动程序。6.2 发指令报 401 Unauthorized九成是 Key 的问题。检查 config.toml 里api_key有没有多余空格有没有把引号也复制进去。重新去控制台复制一次 Key粘贴时注意别带换行。6.3 报连接超时检查base_url是不是https://taotoken.net/api/v1结尾的/v1不能少。另外确认本机网络能正常访问外网公司网络如果有端口限制可能需要换网络环境测试。6.4 模型返回内容为空可能是model_name填了一个当前通道不支持的模型。换一个通用模型名再试。如果换了还不行用 5.1 的 curl 命令单独测通道把问题范围缩小到是配置问题还是通道问题。6.5 智能体执行到一半停住看max_steps是不是设太小了。复杂任务需要多步默认 20 步一般够用如果任务特别长可以调到 30。另外看日志目录里的日志能定位到卡在哪一步。7. 跑通之后把 Key 用顺手的几个建议装好只是开始。TaoToken 的统一 Key 有个好处是可以在控制台看到每个模型的调用量和消耗你可以根据实际使用情况调整model_name。日常轻量任务用便宜的小模型复杂任务再切大模型一个 Key 切换不用改代码。如果你后面打算长期用 OpenClaw 做编码辅助或者跑 Agent 任务可以了解一下 Coding Plan它针对高频编码场景做了额度优化比按量付费更划算。接入文档在 https://taotoken.net/api 里有详细说明遇到配置问题可以先翻文档。模型对话功能可以在控制台直接试不用装任何东西就能验证 Key 是否可用适合在配 OpenClaw 之前先确认通道没问题。API Keys 管理页面则是创建和吊销 Key 的地方建议给 OpenClaw 单独建一个 Key方便追踪用量也方便出问题时单独吊销而不影响其他应用。最后提醒一句workspace 目录别设成整个磁盘根目录智能体有文件操作权限限定在一个专门的工作目录里更稳妥。跑通之后先拿几个不重要的文件练手熟悉它的行为模式再逐步放开更复杂的任务。
