1. Windows 装 ClawCode 到底卡在哪ClawCode 是开源工具 OpenClaw 在社区里的通俗叫法本质是一个跑在本机的 AI 编码助手网关它把模型请求、工具调用、会话管理收拢到一个本地服务里再通过浏览器后台或命令行客户端对外提供能力。适合谁适合不想折腾 Node、Git、Python 环境又想在自己 Windows 电脑上跑一套可控 AI 编码工作流的零代码用户。Win10 和 Win11 都能装建议预留 10GB 以上磁盘、内存 8GB 起步全程联网。但真正让人卡住的往往不是安装脚本本身而是三件事PowerShell 权限没开、脚本执行策略被拦、以及装完之后模型 Key 不知道往哪填。前两个是 Windows 环境问题第三个才是决定这套工具能不能真正干活的关键。我见过太多人装完 ClawCode后台能打开但一发请求就报鉴权失败最后发现是 Key 配置散落在好几个文件里改了一个忘了另一个。这篇就按「先装起来、再接通模型、最后逐项验证」的顺序走。安装部分给你可复制的 PowerShell 命令配置部分给你 settings.json 和 config.toml 的完整骨架Key 统一走 TaoToken 的接入方式避免你在多个供应商之间来回切换。全程管理员权限操作遇到报错直接对照第 5 节的排查表。2. 装之前先把 TaoToken 的 Key 准备好ClawCode 本身只是壳真正让它跑起来的是背后的模型服务。这里用 TaoToken 做统一接入层好处是一个 Key 能覆盖多种模型配置只写一份后面换模型不用动 ClawCode 的安装。先到官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册并登录进入控制台。控制台地址是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 在里面找到 API Keys 页面https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。点新建 Key复制出来的一长串就是你的统一凭证先存到记事本里后面配置要用。这里有个细节TaoToken 的 API 基址是 https://taotoken.net/api 注意它不带任何查询参数配置里填这个就行。很多人把带 UTM 的官网地址误填进 base_url结果请求 404这是高频坑先记住。注意Key 只在创建时完整显示一次关掉页面就看不到了。如果没存直接删掉重建一个别硬找。如果你后面打算长期跑编码任务或者接 Agent 工作流可以顺手看下 Coding Plan 页面https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 它针对高频编码场景做了额度规划比单次调用更划算。现在先不展开把安装跑通再说。3. 可复制的安装与配置片段3.1 管理员 PowerShell 与执行策略按 WinXWin11 选「终端(管理员)」Win10 选「Windows PowerShell(管理员)」弹 UAC 点「是」。确认窗口标题带「管理员」三个字再往下走没有就关掉重开。Windows 默认禁止跑外部脚本先解除限制。PowerShell 里不能 CtrlV直接鼠标右键点窗口空白处就是粘贴Set-ExecutionPolicy RemoteSigned -Scope CurrentUser回车后提示确认输入 Y 再回车。这条只影响当前用户不动系统全局策略安全。3.2 一键安装 ClawCode标准版命令绝大多数人用这个irm https://openclaw.ai/install.ps1 | iex如果出现中文乱码或下载中断换防乱码版 {$wNew-Object Net.WebClient;$w.Encoding[Text.Encoding]::UTF8;iex $w.DownloadString(https://openclaw.ai/install.ps1)}安装过程 3 到 5 分钟期间别关窗口、别断网、别切网络。看到「安装成功服务已启动」就完成了浏览器一般会自动弹出 http://localhost:18789 没弹就手动开。3.3 生成访问令牌并登录回到管理员 PowerShell执行openclaw token generate复制生成的令牌粘到后台登录框。登录成功后服务就在后台跑了关掉 PowerShell 也不影响下次直接开 http://localhost:18789 用旧令牌登录。3.4 settings.json 配置骨架ClawCode 的模型接入配置放在用户目录下的配置文件夹里。Windows 路径通常是C:\Users\你的用户名\.openclaw\settings.json。用记事本或 VS Code 打开没有就新建写入下面这份骨架{ provider: openai-compatible, base_url: https://taotoken.net/api, api_key: sk-你从TaoToken复制的Key, model: claude-sonnet-4-20250514, timeout: 120, max_retries: 3 }几个参数说明base_url必须是 https://taotoken.net/api 不带斜杠结尾也行但别加 UTM 参数api_key填你刚才存的 Keymodel按你实际要用的模型名填TaoToken 控制台里有可用模型列表timeout单位是秒编码任务建议 120 以上不然长响应会被截断。3.5 config.toml 配置骨架有些版本的 ClawCode 或 OpenClaw 用 TOML 格式路径在C:\Users\你的用户名\.openclaw\config.toml。内容如下[provider] type openai-compatible base_url https://taotoken.net/api api_key sk-你从TaoToken复制的Key [model] name claude-sonnet-4-20250514 timeout 120 max_retries 3 [gateway] port 18789 auto_start trueauto_start true对应开机自启等价于命令行执行openclaw gateway install。两个配置文件如果同时存在以你实际启动时加载的那个为准建议只保留一份避免改错文件。3.6 环境变量方式可选不想写配置文件也可以用环境变量。管理员 PowerShell 里执行[Environment]::SetEnvironmentVariable(OPENCLAW_API_KEY, sk-你从TaoToken复制的Key, User) [Environment]::SetEnvironmentVariable(OPENCLAW_BASE_URL, https://taotoken.net/api, User)设完要重开一个 PowerShell 窗口才生效。环境变量优先级一般高于配置文件两个都设了以环境变量为准。4. 验证请求是否真的通了配置写完不算完得逐项验证。先确认服务在跑openclaw gateway status返回 running 就对了。然后测模型连通性用 curl 直接打 TaoToken 的接口curl https://taotoken.net/api/v1/chat/completions -H Authorization: Bearer sk-你从TaoToken复制的Key -H Content-Type: application/json -d {\model\:\claude-sonnet-4-20250514\,\messages\:[{\role\:\user\,\content\:\ping\}]}返回里带choices字段和一段回复内容说明 Key 和 base_url 都对。如果返回 401是 Key 错了返回 404多半是 base_url 填成了带 UTM 的官网地址返回超时检查网络或把 timeout 调大。再回到 ClawCode 后台 http://localhost:18789 在对话窗口发一句「你好」能正常回复就说明整条链路通了。这一步过了才算真正装完。想单独验证某个模型的表现可以直接用模型对话页面https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentchatutm_campaignrewrite 在里面切换模型发同样的 prompt对比响应速度和输出质量比在 ClawCode 里反复试更快。5. 本篇常见报错排查报错一无法加载文件禁止运行脚本。执行策略没解除。重跑Set-ExecutionPolicy RemoteSigned -Scope CurrentUser输入 Y 确认。如果还报检查是不是在非管理员窗口执行的。报错二安装脚本下载超时。先确认网络稳定关掉可能拦截的防火墙或杀软实时防护换手机热点重试。等 10 分钟再试也行有时是临时波动。报错三端口 18789 被占用。管理员 PowerShell 执行net stop winnat net start winnat然后openclaw gateway start重启服务。报错四令牌过期或登录失败。重新生成openclaw token generate用新令牌登录旧令牌作废。报错五请求返回 401。Key 错了或没填对。检查 settings.json 或 config.toml 里的api_key确认没有多余空格确认用的是 TaoToken 控制台里新建的 Key。报错六请求返回 404。base_url 填错。必须是 https://taotoken.net/api 不能带 UTM 参数不能带/v1后缀除非你的客户端要求。报错七服务意外关闭。手动拉起openclaw gateway start想彻底卸载先openclaw gateway stop再openclaw gateway uninstall。报错八中文乱码。用 3.2 节的防乱码版安装命令重装或在 PowerShell 里先执行chcp 65001切 UTF-8 编码。6. 装完之后怎么用得更顺安装只是起点。真正影响体验的是 Key 管理和模型选择这两件事。统一走 TaoToken 的好处是你后面不管换 Claude 还是别的模型只改 settings.json 里的model字段就行base_url 和 api_key 都不用动。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 里面有各语言的调用示例和参数说明配置卡住时对着查比瞎试快。如果你主要用 ClawCode 做编码建议把 timeout 设到 180 以上编码任务的响应普遍偏长120 秒有时不够。另外max_retries设 3 比较稳网络抖动时能自动重试不用手动重发。长期跑 Agent 或高频编码的话Coding Plan 比按次调用省心额度规划在 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 里看。Claude Code 相关的接入配置可以参考 https://taotoken.net/claude-code-anthropic?utm_sourcetaotoken_aicg_blog_endutm_contentclaudecodeutm_campaignrewrite 思路和 ClawCode 一致都是把 base_url 指向 https://taotoken.net/api 。最后提醒一句配置文件改完一定要重启服务才生效openclaw gateway stop再openclaw gateway start别改完直接测那样测的还是旧配置。