1. 为什么 Windows 新手也需要一个本地 AI 智能体OpenClaw 是一个能在 Windows 上本地运行的 AI 智能体框架它能听懂自然语言指令然后自动帮你操作电脑——整理文件、批量处理表格、抓取网页信息、定时推送消息。适合谁适合不想写代码、但想让电脑自己干活的普通办公用户。你不需要懂 Python也不需要配环境变量只要会解压文件、会点下一步就能把它跑起来。我见过太多人卡在第一步下载完压缩包解压出来一堆文件夹不知道点哪个或者双击启动程序被 Windows Defender 弹窗吓退再或者装完了发现 Gateway 一直显示离线模型根本调不通。这些问题不是因为你技术差而是因为 OpenClaw 的部署流程里藏着几个必须提前知道的坑。这篇攻略会带你从零走完整个流程下载一键部署包、规范解压、绕过系统拦截、配置 Gateway 接入、验证模型调用。每一步都有可复制的命令和配置片段你照着做就行。重点在于我会把 Gateway 配置和模型通道单独拎出来讲清楚——因为很多人装完 OpenClaw 之后卡在“智能体没反应”这一步根本原因就是 Gateway 没连上模型服务。OpenClaw 的核心价值在于“本地离线运行 无代码操作 全自动操控电脑”。它和普通对话 AI 的区别是普通 AI 只给你文字建议OpenClaw 直接帮你把事办了。比如你说“把 D 盘下载文件夹里的图片按日期分类”它会自己打开资源管理器、创建文件夹、移动文件。这种能力来自它内置的键鼠模拟和文件系统操作模块所以安全软件会误判这也是为什么部署前必须关防护。但光有 OpenClaw 还不够。它本身只是一个执行框架真正理解你指令、生成操作步骤的“大脑”是背后的大模型。默认情况下OpenClaw 需要你配置一个模型通道也就是 Gateway。Gateway 负责把 OpenClaw 的请求转发给模型服务再把模型返回的操作指令翻译成电脑动作。如果你不配 GatewayOpenClaw 就是一个空壳点啥都没反应。所以这篇教程分两条线一条是 OpenClaw 本体的安装部署另一条是 Gateway 的模型通道配置。两条线都跑通你才能看到第一个智能体任务真正执行。下面从下载安装包开始一步步来。2. TaoToken 前置给 OpenClaw 配一个稳定的模型通道OpenClaw 的 Gateway 需要对接一个模型 API 才能工作。你可以把它理解成OpenClaw 是“手”Gateway 是“神经”模型 API 是“大脑”。手和神经都在本地但大脑需要远程调用。问题来了——国内直接访问很多模型服务不稳定延迟高、容易断连OpenClaw 执行任务时一旦请求超时整个自动化流程就卡死。TaoToken 在这里的角色是统一 Key/API 通道。它把多个模型服务的接口聚合到一个入口你只需要一个 API Key就能在 OpenClaw 里调用不同的模型。对 Windows 新手来说这省去了“注册多个平台、分别拿 Key、分别配 Base URL”的麻烦。你只要在 TaoToken 控制台生成一个 Key然后把它填进 OpenClaw 的 Gateway 配置里就行。具体怎么拿 Key打开 TaoToken 官网注册后进入控制台找到 API Keys 页面点“创建新 Key”。复制生成的 Key格式类似sk-xxxxxxxx。这个 Key 就是你后面配置 Gateway 时要填的api_key字段。注意Key 只显示一次复制后先存到记事本里别关页面。TaoToken 的 API 入口是https://taotoken.net/api这个地址要填到 Gateway 配置的base_url字段。不要加任何多余路径也不要加斜杠结尾。模型 ID 根据你实际想用的模型填比如claude-3-5-sonnet或gpt-4o。如果你不确定填哪个先去 TaoToken 的模型对话页面试一下能正常对话的模型 ID 就可以直接用到 OpenClaw 里。这里有个关键点OpenClaw 的 Gateway 配置文件和普通应用的配置文件格式不一样。它用的是 JSON 格式路径在 OpenClaw 安装目录下的config/gateway.json。如果你装完之后找不到这个文件说明安装过程没走完或者你解压的版本不对。后面第三节会给出完整的配置片段你直接复制粘贴改三个字段就行。另外提醒一句TaoToken 的 Key 不要泄露不要提交到 Git也不要写在公开的配置文件里。如果你要把 OpenClaw 配置分享给别人记得先把 Key 替换成占位符。Gateway 配置里还有一个timeout字段建议设成 30 秒以上因为 OpenClaw 执行复杂任务时模型返回的操作步骤可能比较长超时太短会导致任务中断。3. 可复制配置Gateway JSON 片段与 OpenClaw 启动参数OpenClaw 安装完成后默认会在安装目录下生成一个config文件夹。如果没生成手动新建一个。然后在里面创建gateway.json文件。下面是一个完整的配置片段你直接复制把api_key换成你自己的 TaoToken Keymodel换成你想用的模型 ID{ gateway: { enabled: true, base_url: https://taotoken.net/api, api_key: sk-你的TaoTokenKey, model: claude-3-5-sonnet, timeout: 30, max_retries: 3, retry_delay: 2 }, agent: { name: OpenClaw-Windows, workspace: D:\\OpenClaw\\workspace, auto_start: true, log_level: info } }注意几个细节base_url必须是https://taotoken.net/api不要写成https://taotoken.net/api/v1或者加斜杠。api_key填你从 TaoToken 控制台复制的完整 Key。model字段填模型 ID如果你用 Claude 系列填claude-3-5-sonnet如果用 GPT 系列填gpt-4o。workspace是你想让 OpenClaw 操作的文件夹路径必须是纯英文路径不能有中文和空格。配置写完后还需要在 OpenClaw 的启动脚本里指定 Gateway 配置文件的位置。如果你是用一键启动程序它默认会读取config/gateway.json。但如果你手动启动需要在命令行里加参数OpenClaw.exe --config D:\OpenClaw\config\gateway.json --gateway-enabled如果你用的是 PowerShell命令类似.\OpenClaw.exe --config D:\OpenClaw\config\gateway.json --gateway-enabled启动后OpenClaw 会先加载 Gateway 配置然后尝试连接 TaoToken 的 API 入口。如果配置正确界面右上角会显示“Gateway 在线”。如果显示离线先检查base_url和api_key是否填对再看网络能不能正常访问https://taotoken.net/api。还有一个容易忽略的点OpenClaw 的 Gateway 配置里max_retries和retry_delay控制重试次数和间隔。如果你网络环境一般建议把max_retries设成 3retry_delay设成 2 秒。这样即使某次请求失败OpenClaw 也会自动重试不会直接报错退出。timeout设成 30 秒是保守值如果你经常执行复杂任务可以调到 60 秒。配置改完后一定要保存文件然后重启 OpenClaw。不要只关窗口要在任务管理器里确认 OpenClaw 进程完全退出再重新启动。否则旧配置可能还在内存里新配置不生效。4. 验证请求用模型对话确认 Gateway 连通配置写完、OpenClaw 重启后怎么确认 Gateway 真的连上了最直接的方法是在 OpenClaw 主界面底部的输入框里发一条简单指令比如“列出 D 盘根目录下的所有文件夹”。如果 Gateway 正常OpenClaw 会先调用模型解析指令然后执行文件系统操作最后在界面显示结果。如果 Gateway 没连上界面会提示“模型请求失败”或“Gateway 离线”。但更稳妥的验证方式是先用 TaoToken 的模型对话页面单独测一下 Key 和模型 ID 是否可用。打开模型对话页面选择你配置里填的同一个模型 ID发一条“你好”看能不能正常回复。如果能回复说明 Key 和模型 ID 没问题问题出在 OpenClaw 的 Gateway 配置上。如果不能回复说明 Key 或模型 ID 有误先去控制台检查。另一个验证方法是直接用 curl 请求 TaoToken 的 API 入口模拟 OpenClaw 的调用方式curl -X POST https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer sk-你的TaoTokenKey \ -H Content-Type: application/json \ -d { model: claude-3-5-sonnet, messages: [{role: user, content: 回复OK}], max_tokens: 10 }如果返回 JSON 里包含content: OK或类似内容说明 API 通道正常。注意这个 curl 命令里的路径是/api/v1/chat/completions但 OpenClaw 配置里的base_url只写到/apiOpenClaw 会自动拼接后面的路径。所以你在配置文件里不要写/v1/chat/completions只写https://taotoken.net/api就行。验证通过后你可以试一个完整的智能体任务。比如在 OpenClaw 输入“在桌面新建一个文件夹叫 TestClaw然后在里面创建一个文本文档写入当前时间”。如果 Gateway 和 OpenClaw 都正常你会看到鼠标自动移动、文件夹自动创建、文档自动写入。这个过程不需要你手动操作全是 OpenClaw 通过模型解析指令后自动执行的。如果任务执行到一半卡住先看 OpenClaw 的日志文件。日志默认在logs/openclaw.log里面会记录每次 Gateway 请求的耗时和返回状态。如果看到401 Unauthorized说明 Key 不对如果看到timeout说明网络延迟太高把timeout调大如果看到model not found说明模型 ID 填错了。5. 本篇常见错排查401、local proxy failed、reading choices、OAuth部署 OpenClaw 和配置 Gateway 的过程中有几个报错几乎每个人都会遇到。下面逐个拆解原因和解决办法。401 Unauthorized这是最常见的错误意思是 TaoToken 的 API Key 无效。可能原因有三个Key 复制时漏了字符、Key 已经被删除、Key 前面多了空格。解决办法重新去 TaoToken 控制台复制 Key粘贴到gateway.json的api_key字段时确保前后没有空格。如果你用的是记事本编辑注意不要多按回车。改完后重启 OpenClaw。local proxy failed这个报错通常出现在 OpenClaw 启动时提示本地代理连接失败。原因是 OpenClaw 的 Gateway 尝试通过本地代理端口转发请求但代理没启动或者端口被占用。解决办法检查gateway.json里有没有多余的proxy字段如果有删掉。OpenClaw 默认直连 TaoToken 的 API 入口不需要本地代理。如果你之前配过其他代理工具先把它们关掉再重启 OpenClaw。reading choices 报错这个错误一般出现在模型返回格式异常时OpenClaw 解析响应失败。常见原因是模型 ID 填错或者 TaoToken 的 API 返回了非标准格式。解决办法先用 curl 命令测试同一个模型 ID看返回的 JSON 里有没有choices字段。如果没有说明模型 ID 不对换一个模型试。如果有choices但 OpenClaw 还是报错检查gateway.json里model字段是否和 curl 里用的一致。OAuth 相关报错如果你在 OpenClaw 里看到 OAuth 认证失败说明你误用了需要 OAuth 的模型服务。TaoToken 的 API 通道用的是 Bearer Token 认证不需要 OAuth。解决办法确认gateway.json里没有oauth相关字段api_key填的是 TaoToken 的 Key而不是其他平台的 OAuth token。如果你之前配过其他模型服务把它们的配置删掉只保留 TaoToken 的配置。还有一个隐藏坑OpenClaw 的 Gateway 配置里base_url如果写成https://taotoken.net/api/结尾带斜杠会导致请求路径拼接错误返回 404。解决办法去掉结尾斜杠只写https://taotoken.net/api。这个细节很容易忽略但报错信息不会直接提示路径问题只会显示“请求失败”。如果你用的是 CC Switch 或 Cline MCP 这类工具来管理 OpenClaw 的模型配置需要确保三件套完整Base URL 填https://taotoken.net/apiKey 填 TaoToken 的 KeyModel ID 填你实际用的模型。缺任何一个Gateway 都连不上。Codex 的auth.json也是类似逻辑但 OpenClaw 不用auth.json它用gateway.json别搞混。6. 跑通第一个智能体任务后的实用技巧当你看到 OpenClaw 自动完成第一个任务后可以开始试更复杂的指令。比如“遍历 D 盘工作文件夹里所有 Excel 文件把每个文件的第一个工作表名称提取出来汇总到一个新表格里保存到桌面”。这种任务涉及文件遍历、Excel 读取、数据汇总、文件写入OpenClaw 会拆成多个步骤依次执行。实测下来指令描述越具体执行精准度越高。不要只说“整理文件”要说“把 D 盘下载文件夹里所有 .jpg 和 .png 文件按修改日期创建子文件夹移动到对应文件夹里”。OpenClaw 对文件扩展名和路径的识别比较准但对模糊描述容易理解偏差。如果你想让 OpenClaw 长期自动运行可以在gateway.json里把auto_start设为true然后把 OpenClaw 加到 Windows 启动项里。这样每次开机后Gateway 会自动连接 TaoTokenOpenClaw 处于待命状态。你随时发指令它随时执行。最后提醒OpenClaw 的 Gateway 配置里workspace字段决定了它能操作哪个文件夹。为了安全不要把workspace设成 C 盘根目录或系统文件夹。建议单独建一个工作目录比如D:\OpenClaw\workspace所有自动化任务都在这个目录里操作。这样即使指令有误也不会影响系统文件。如果你在配置过程中遇到其他报错先去 TaoToken 的接入文档页面查一下 API 调用规范确认base_url和认证方式没写错。大部分 Gateway 连接问题都是配置字段填错导致的仔细核对一遍就能解决。