1. Win11 遇到 SmartScreen 弹窗先把拦截和模型通道分开看Win11 部署小龙虾 OpenClawSmartScreen 弹窗和中文路径报错最容易卡住第一关。结论先放这里系统安全拦截按官方流程正常放行模型通道交给 TaoToken在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_contentopenclaw_win11 建好 API Key再把 OpenClaw 的 Base URL 填成 https://taotoken.net/api基本就能避开 401 和「多写一个 /v1」这类连通问题。「小龙虾」这个外号来自 OpenClaw 的图标。它做的事情很实在扫描并整理本地文件夹、批量处理文档、驱动浏览器抓取页面内容再归档成表。整套流程大部分在本地完成只有「思考」那一步要调用远程模型 API。很多人装完看到主界面右上角写着 Gateway 在线以为大功告成结果下发第一条指令转两圈就没反应——问题不在安装在模型通道没接对。所以这篇把两件事拆开讲。第一件是 Win11 的安全机制怎么按正常路径放行第二件是放行之后模型通道怎么配。两者混在一起讨论只会让人误以为「跑不起来」是因为被系统拦了其实多半是 Key 或 Base URL 填错。1.1 Defender 拦下来的那一帧属于系统常规动作双击一键启动程序屏幕中间弹出「Windows 已保护你的电脑」蓝色标题栏下面一行小字写着「Windows SmartScreen 阻止了无法识别的应用启动」。这个提示针对的是「没有数字签名」或「下载量还不高」的可执行文件和程序本身有没有问题是两回事。OpenClaw 这类工具需要调用键鼠模拟、本地文件读写、浏览器进程管控这些系统能力。对安全软件来说这些行为模式确实和某些灰色程序相似所以被标记成「需要你确认一下」很正常。你要做的是走完系统给的确认路径而不是去把 SmartScreen 全局关掉——后者影响的是整台机器的防护级别代价比点两下鼠标大得多。同一类误判还会出现在解压阶段。360、腾讯电脑管家、火绒、Defender 的实时防护有可能在解压完成的一瞬间就把 exe 文件隔离掉你回头一看目录是空的或者只剩几个配置文件。遇到这种情况别急着怀疑压缩包坏了先去隔离区看一眼。1.2 放行解决的是「能不能装」通道解决的是「能不能用」这两件事的时间线完全不同。安全放行只在安装那一刻发生一次装完就结束了。模型通道则是每次下发指令都要走一遍OpenClaw 把任务拆成步骤每一步需要模型判断下一步做什么这个判断请求要发到某个 API 地址带上某把 Key指定某个模型。这三样只要有一样不对表现就完全不同Key 不对界面能操作指令发出去立刻返回鉴权失败。地址不对请求根本出不去或者回来一个 404。模型名不对报模型不存在或者长时间无响应。把这些错误一锅端地归到「Defender 拦了」是最常见的误判。下面几节按顺序走一遍先解决系统放行再解决通道。2. 安装前的两件准备防护软件放行清单和一把可用的 Key动手之前桌面最好只开必要的窗口。一次装完比装一半被杀软打断再重来省事得多。2.1 实时防护临时放行但别长期关着需要留意的几个位置360 安全卫士或 360 杀毒的实时防护、腾讯电脑管家、火绒安全、Win11 自带的 Defender 实时保护。安装期间临时关掉或者更稳妥的做法是把安装目录加进白名单装完立刻恢复开启。这里有个顺序问题值得说清楚先创建白名单目录再解压。因为解压出来的 exe 才是被隔离的对象如果你等解压完再想加白名单文件可能已经进隔离区了。白名单目录写你准备装的那个纯英文路径比如D:\OpenClaw。安装流程走完、Gateway 显示在线之后把实时防护重新打开。正常情况下不会再被拦——被拦的典型症状是程序启动后突然弹出「文件已被删除」的提示那就是防护又把它清掉了此时把文件从隔离区恢复并加入信任列表即可。2.2 在 TaoToken 建一把专用 Key顺手记下两个常量模型 API 这一端需要一个访问凭证。打开 TaoToken完成注册登录进控制台创建 API Key。Key 一般只在创建成功的那一刻完整显示之后列表里只留前后几位所以复制出来先粘到本地记事本里暂存。建 Key 的时候顺手确认两件事后面配置会直接用Base URLhttps://taotoken.net/api。注意末尾不带/v1这是后面 404 和 401 的高发点。模型 ID具体能填哪些以模型广场当时的列表为准别照着别人的截图抄一个可能已经下线的名字。填进 OpenClaw 之前先把这两个常量和 Key 放在一起格式像这样Base URL : https://taotoken.net/api API Key : YOUR_API_KEY Model : 以模型广场当时列表为准YOUR_API_KEY是占位符实际填你自己创建的那一串。Key 从 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_contentopenclaw_key 创建不要再从别的地方找。提示Key 属于凭证别写进截图、别发到群里、别提交到任何公开仓库。如果你有多台设备建议一台一把出问题可以单独停用。3. 解压与安装路径中文目录是路径报错的头号来源安装包拿到之后最容易被忽略、又最容易出问题的就是解压和路径这两步。3.1 用专业解压工具别依赖系统自带Win11 自带的解压功能在遇到体积偏大、层级较深的压缩包时偶尔会解出半截文件或者直接报「文件损坏」。这类问题在论坛上出现的频率不低而解决办法非常简单装个 WinRAR 或 7-Zip右键压缩包选「解压到当前文件夹」。解压完成后会生成一个以 OpenClaw 加系统标识命名的文件夹。判断解压是否完整的标准很直接——目录里能看到那个带红色图标的一键启动程序就说明文件齐了。如果只有目录没有 exe或者 exe 体积明显不对那就是被杀软清掉了或者解压过程中断了。macOS 那边用系统自带的归档工具基本没问题解压完按对应平台的启动方式走就行。3.2 纯英文路径不是建议是硬规则这一步产生的报错最典型。安装程序在初始化阶段会拼接大量路径字符串一旦目录名里出现中文、空格或特殊符号拼接结果就可能变成非法的文件系统路径表现出来往往是「找不到模块」「路径包含非法字符」或者更隐蔽的——程序能启动但 Gateway 永远起不来。可以用的路径D:\OpenClaw E:\AI\OpenClaw不要用的路径D:\软件\OpenClaw D:\小龙虾 C:\Program Files\OpenClaw第三条容易被忽略。Program Files中间有个空格而且这个目录默认受系统保护写入需要提权。把它当安装目录等于给自己埋一个权限报错。已经装在中文路径下怎么办实话讲卸载重装到英文路径比改配置省事得多。因为路径不只写在配置文件里还可能被写进服务注册信息、快捷方式、缓存索引一个个改完的时间成本远超重来一遍。注意如果你在 Win11 上用的是中文用户名系统临时目录里也会带中文。这种环境下建议把安装目录放在盘符根目录下的英文文件夹比如D:\OpenClaw减少中间环节的路径拼接。4. 从「更多信息」到 Gateway 在线中间发生了什么系统放行之后安装过程基本是自动的但有几个点值得盯一下。4.1 走完 SmartScreen 的确认路径弹窗出现时点弹窗里的更多信息下方会展开一行仍要运行的按钮点它安装引导界面就打开了。整个过程不需要你改注册表、不需要关系统防护、不需要用什么「解锁工具」。这里要明确一点这属于系统给用户的正常确认通道不是绕过安全机制。真正意义上的绕过是改系统策略、关闭全局防护那种做法既影响其他软件的安全也不该出现在一份部署教程里。TaoToken 在这件事上的角色很明确——它只提供 Key 和 Base URL不负责、也不参与任何系统安全拦截的处理。4.2 自动安装阶段在做什么进入欢迎界面点开始使用会跳到路径配置页。填好纯英文路径、勾上用户协议点开始安装接下来的几分钟程序会自己跑完一整套检测系统环境、补齐依赖组件、部署核心服务、配置运行权限、最后生成桌面快捷方式。这个阶段别关窗口也别手快点了取消。等待时间视机器性能浮动机械硬盘和老旧笔记本会更久一些。中途关掉的话依赖可能只装了一半之后再启动会报组件缺失处理起来比重装还麻烦。4.3 「Gateway 在线」到底说明了什么安装完成主界面自动弹出右上角显示 Gateway 在线。这个状态说明的是本地服务进程起来了、端口在监听、前端能和它通信。它不说明模型通道已经通了。很多人就是在这里踩坑——看到在线直接下发「帮我整理 D 盘下载文件夹里全部图片」指令转了几圈没结果回头以为还是 Defender 的问题。实际是通道没配或者配了但 Key 不对。所以下一步不是急着用而是先把模型通道填好。5. 在 OpenClaw 的模型/API 设置里填上 TaoToken通道配置这件事核心就三个字段填对就通。5.1 找到设置入口主界面一般会有设置或偏好入口进去之后找模型设置或API 设置这一类面板。不同小版本的命名可能有差异但字段结构大同小异一个填服务地址的输入框、一个填密钥的输入框、一个选模型的列表或输入框。如果界面上还区分「供应商类型」选通用/兼容 OpenAI 格式那一类即可不要选某个具体厂商的名字。5.2 三个字段的正确填法字段填什么常见错误API Base URLhttps://taotoken.net/api末尾多写/v1API KeyYOUR_API_KEY少复制了尾部字符模型 ID以 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_contentopenclaw_model 模型广场当时列表为准抄了别人截图里已下线的名字对照着填完保存重启一次 OpenClaw让配置生效。重启这个动作别省有些版本对配置文件的监听不够灵敏不重启可能还在用旧值。5.3 别自己给 Base URL 加 /v1这是最高频的一类错误。很多工具文档里写的示例地址末尾带/v1于是有人顺手也加上去结果请求打到https://taotoken.net/api/v1/...服务器找不到这个路径回来一个 404。表现就是指令一直没响应日志里能看到路径拼接异常。记住规则填进工具的地址就是https://taotoken.net/api末尾不加/v1也不加斜杠。反过来也要注意别把官网地址填进工具里——https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_contentopenclaw_model这种带参数的链接是给人点的用来注册、建 Key、看模型列表填进 API Base URL 一定报错。5.4 模型 ID 从哪来不要凭印象写。进入 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_contentopenclaw_model 打开模型广场找到你要用的那个模型复制它旁边标注的 ID原样粘进设置里。大小写和连字符都要一致差一个字符就是「模型不存在」。如果你不确定选哪个先用列表里默认推荐的那一个跑通链路等确认整条路通了再换成更适合你做文档处理或代码生成的那个。6. 发一条最小指令把 401 和离线问题一次排掉配置保存完别急着上复杂任务先用最小指令验证链路。6.1 用一句话测试在输入框里写一句最简单的需求比如「列出我桌面上所有图片文件的名字」。这句话的好处是它需要模型理解意图并生成步骤但不需要复杂推理链路通不通一秒就能看出来。如果几秒内开始输出步骤说明 Key、Base URL、模型 ID 三个都对。如果卡住不动或者弹出错误提示对照下一节的表来定位。6.2 报错对照表现象大概率原因处理立刻提示鉴权失败或 401Key 复制不全、多了空格、已停用回 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_contentopenclaw_verify 重新复制或新建一把404 或路径不存在Base URL 末尾多了/v1或误填了带参数的网页地址改成https://taotoken.net/api提示模型不存在模型 ID 拼写有误或该模型已下线去模型广场复制当前有效 IDGateway 显示离线安装路径含中文或空格或安装时被杀软中断检查路径是否全英文恢复被隔离文件后重启程序指令无响应但无报错配置保存后没重启或网络出口被本地代理拦截重启程序检查系统代理设置排查的时候注意一点一次只改一个变量。有人一口气把 Key、地址、模型全换一遍结果跑通了也不知道是哪一步修好的下次再出问题还是不会查。7. 通道跑通之后顺手把用量和后续工具接上链路验证通过之后建议回控制台看一眼这次调用有没有被记上。这一步很值得做因为它是你判断「到底是模型在干活还是本地程序自己在瞎转」的最直接依据。打开 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_contentopenclaw_usage 的控制台看用量记录里有没有刚才那条请求。有记录说明整条通道确实在工作没有记录那说明请求根本没发出去还得回头查 Base URL 和网络出口。如果你想先不装任何工具、单纯试试这把 Key 能不能用可以直接打开 模型对话用同一把 Key 发一条消息。对话页能正常回复就说明凭证没问题剩下的都是 OpenClaw 这边的配置问题排查范围一下子小了一半。OpenClaw 的自动化任务颗粒度比较大一次文件整理可能触发几十次模型调用用量会比写代码时高。如果你的使用频率上来了可以看一下 Coding Plan 的套餐是否更划算需要新 Key 或者给不同设备分开授权在 控制台 API Keys 里建就行。同一把 Key 之后想接别的工具比如 Claude Code环境变量怎么填可以对照 接入文档 来看。回到最开始那个弹窗。「Windows 已保护你的电脑」只是系统在提醒你确认来源点更多信息、点仍要运行是它设计好的正常路径真正需要你花心思的是后面那三个字段——Base URL、Key、模型 ID。把这三样填对一次之后不管是整理文件夹还是批量处理文档通道都不用再动。装机那几分钟的耐心换来的是后面几个月不用反复折腾。