1. OpenClaw 在 Windows 11 上跑不起来多半卡在模型接入这一步OpenClaw圈内叫小龙虾是一个开源本地 AI 智能体能操控电脑、整理文件、跑浏览器自动化、处理办公流程逻辑全在本地终端执行数据不出设备。很多人冲着「本地部署」去装装完发现 Gateway 在线了但一发指令就转圈或者报模型不可用——问题基本不在安装包而在模型接入环节没配通。这篇聚焦 Windows 11 下 OpenClaw 部署完成后的模型接入给你config.toml和settings.json的可复制骨架用 TaoToken 统一 Key 和 API 通道把模型接上最后用一次对话请求验证连通性。适合已经装好 OpenClaw、或者正准备装、想一次性跑通本地智能体的开发者。安装部分只做必要提醒重点放在配置和验证上因为这才是真正让人卡住的地方。先说清楚一件事OpenClaw 本身不带模型它是个调度框架需要你给它一个能调用的模型端点。你可以理解成 OpenClaw 是「手和脚」模型是「大脑」中间需要一根神经——也就是 API 通道。TaoToken 在这里扮演的就是这根神经把 Key 和端点统一起来省得你在多个配置文件里来回改。2. 接入前先把 TaoToken 的 Key 和通道准备好在动 OpenClaw 的配置文件之前先把外部条件备齐。这一步不做后面配置写得再对也连不通。打开 TaoToken 官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册并登录后进入控制台。控制台里能拿到两样东西API Key 和 API 基础地址。API 基础地址是https://taotoken.net/api这个地址后面要填进 OpenClaw 的配置里注意不要带任何多余路径。Key 的生成入口在控制台的 API Keys 页面直接新建一个就行。生成后立刻复制保存页面刷新后不一定还能看到完整 Key。建议命名上带个用途比如openclaw-win11以后要吊销或者换 Key 的时候好定位。注意Key 属于敏感凭证不要写进会提交到 Git 的公开仓库。本地配置文件如果放在同步盘里也要留意别把 Key 同步出去。如果你还没决定用哪个模型可以先到模型对话页面 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite 试几句确认通道正常、模型响应符合预期再往 OpenClaw 里接。这样能把「通道问题」和「OpenClaw 配置问题」分开排查省很多时间。3. config.toml 与 settings.json 的可复制配置骨架OpenClaw 的模型接入涉及两个文件config.toml管全局服务与模型端点settings.json管运行时参数。两个文件都在 OpenClaw 的安装目录下Windows 11 下路径类似D:\OpenClaw\config\。先确认安装路径是纯英文、无空格、无特殊符号这是硬性要求中文路径会导致配置文件读取异常。先看config.toml的骨架# D:\OpenClaw\config\config.toml [server] host 127.0.0.1 port 18789 gateway true [model] provider openai-compatible base_url https://taotoken.net/api api_key sk-你的TaoToken密钥 model_name gpt-4o-mini timeout 60 max_retries 2 [model.params] temperature 0.7 max_tokens 4096几个关键点解释一下。provider填openai-compatible因为 TaoToken 的 API 走的是 OpenAI 兼容协议OpenClaw 能直接识别。base_url就是前面拿到的https://taotoken.net/api结尾不要加/v1之类的后缀OpenClaw 会自己拼。api_key填你生成的 Key注意保留sk-前缀如果你的 Key 带前缀的话。model_name填你要用的模型标识具体可用模型以控制台或文档为准。再看settings.json{ runtime: { workspace: D:\\OpenClaw\\workspace, log_level: info, language: zh-CN }, agent: { max_steps: 20, auto_confirm: false, tool_timeout: 120 }, model_binding: { default: main, profiles: { main: { base_url: https://taotoken.net/api, api_key: sk-你的TaoToken密钥, model_name: gpt-4o-mini } } } }settings.json里的model_binding和config.toml的[model]有重叠这是 OpenClaw 的设计config.toml定义默认端点settings.json可以覆盖或定义多套 profile。如果你只用一个模型两处保持一致即可如果要在不同任务间切换模型就在profiles里加多个条目然后在default里指定当前用哪个。提示JSON 里反斜杠要转义D:\OpenClaw要写成D:\\OpenClaw否则解析会报错。这是 Windows 下最容易踩的坑之一。改完两个文件后重启 OpenClaw 服务让配置生效。重启方式可以是关掉主程序再双击启动也可以在托盘图标上右键选择重启。4. 用一次对话请求验证连通性配置写完不代表通了必须实际发一次请求验证。OpenClaw 主界面右上角显示「Gateway 在线」只说明本地服务起来了不代表模型通道可用。最直接的验证方式是在 OpenClaw 的对话输入框里发一条简单指令比如「你好请回复当前使用的模型名称」。如果模型正常响应说明整条链路通了。如果转圈或报错看日志。日志位置在D:\OpenClaw\logs\下找最新的.log文件。常见的有两类信息一类是 HTTP 状态码401 说明 Key 不对404 说明 base_url 或 model_name 不对429 说明触发限流另一类是连接超时多半是网络或 base_url 写错。如果你想绕过 OpenClaw 直接验证 TaoToken 通道本身可以用 curl 发一个请求curl -X POST https://taotoken.net/api/chat/completions \ -H Content-Type: application/json \ -H Authorization: Bearer sk-你的TaoToken密钥 \ -d { model: gpt-4o-mini, messages: [{role: user, content: 回复 OK}] }返回里如果有choices字段和正常内容说明通道没问题那 OpenClaw 连不上就是配置文件的问题。这个分离验证的思路很实用能帮你快速定位是通道挂了还是配置错了。验证通过后你可以试着下发一个真实任务比如「帮我整理 D 盘下载文件夹里的所有图片」观察 OpenClaw 是否能正常调度模型并执行工具调用。这一步跑通本地智能体就算真正可用了。5. 本篇常见错误排查配置过程中遇到的报错八成集中在下面几类。401 UnauthorizedKey 错了或者没带上。检查config.toml和settings.json里的api_key是否一致、是否有多余空格、是否复制完整。如果 Key 刚生成确认没有在控制台里被误删。404 Not Foundbase_url或model_name写错。base_url必须是https://taotoken.net/api不要加/v1也不要漏掉https。model_name要和控制台里可用的模型标识完全一致大小写敏感。连接超时 / timeout先确认本机网络能访问 TaoToken 的 API 地址可以用浏览器打开文档页 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 看是否能加载。如果文档能开但 API 超时检查是否有本地防火墙拦截了 OpenClaw 的出站请求。Gateway 离线这个和模型接入无关是本地服务没起来。检查安装路径是否纯英文、是否被杀软拦截、是否以管理员身份运行。Windows 11 的 Defender 实时防护有时会拦截 OpenClaw 的键鼠模拟行为需要放行。配置文件改了不生效OpenClaw 不会热加载配置改完必须重启服务。另外确认改的是安装目录下的配置文件而不是某个备份或模板文件。中文路径导致读取失败这是 Windows 11 下的高频问题。安装路径、workspace 路径都必须是纯英文D:\软件\OpenClaw这种写法会直接导致配置解析异常。排查时建议按「先通道、后配置、再本地服务」的顺序来一层层排除比盲目改配置高效得多。6. 把 Key 和通道固定下来后续接入更省事跑通一次之后建议把 Key 和通道配置固定成一套模板。OpenClaw 后续如果升级或者你要在另一台 Windows 11 机器上部署直接复用这套config.toml和settings.json骨架只改 Key 和路径就行。如果你打算长期用 OpenClaw 跑编码类或 Agent 类任务可以关注 Coding Plan https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite 它针对长时间、高频次的编码场景做了额度优化比按量计费更适合持续跑任务的用法。日常接入和排障需要的 Key 管理、文档参考分别在 API Keys https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite 和接入文档 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 里配置过程中随时对照。最后留一个实操建议每次改完配置先用 curl 验证通道再重启 OpenClaw 发一条测试指令两步都过了再跑真实任务。这个习惯能帮你把问题挡在任务执行之前而不是等智能体跑到一半报错才发现配置有问题。