从openclaw doctor报错说起Windows 执行策略与模型通道的两段式修复在 Windows 上跑openclaw doctor很多人第一次遇到的不是模型问题而是 PowerShell 直接拦住了脚本执行终端里甩出一段红字大意是在此系统上禁止运行脚本。这个报错跟 OpenClaw 本身没关系是 Windows 默认的脚本执行策略在起作用。把执行策略改成RemoteSigned之后openclaw doctor能跑起来了但紧接着会撞上第二个问题OpenClaw 要调用模型而模型调用需要 Token这一步得去 TaoToken 注册并创建 Key再把 Base URL 和 Key 填进 OpenClaw 的配置里。本文按先修执行策略、再补模型 Key的顺序把这两段都走一遍最后用openclaw doctor和一次真实模型请求来验证通道是否打通。一、原问题与场景openclaw doctor为什么在 Windows 上先报脚本错openclaw doctor是 OpenClaw 用来做环境自检的命令它会检查 Node 版本、依赖、配置文件、模型通道等一堆东西。在 Windows 上这个命令通常是通过 PowerShell 调起来的而 PowerShell 有一个默认的执行策略Execution Policy默认值在客户端系统上一般是Restricted意思是不允许运行任何脚本文件。OpenClaw 的 CLI 在启动时会加载.ps1脚本或类似的包装层于是就被这条策略挡在门外。报错的典型形态是无法加载文件 ...\openclaw.ps1因为在此系统上禁止运行脚本。 有关详细信息请参阅 about_Execution_Policies。 CategoryInfo : SecurityError: (:) []PSSecurityException FullyQualifiedErrorId : UnauthorizedAccess注意这里的关键词是SecurityError和UnauthorizedAccess不是网络错误也不是模型错误。很多人看到红字第一反应是去查 OpenClaw 的模型配置方向就偏了。正确的第一步是处理 PowerShell 执行策略。原文给出的解法是执行Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser当提示是否确认更改时输入Y并回车。设置成功后关闭并重新打开终端再次运行openclaw doctor即可。这里解释一下这条命令的几个部分-ExecutionPolicy RemoteSigned表示本地编写的脚本可以直接运行从网络下载的脚本需要数字签名。这是开发机上比较常用的折中策略比Unrestricted安全比Restricted可用。-Scope CurrentUser只对当前用户生效不需要管理员权限也不会影响系统上其他用户。这一点很重要很多教程让你用管理员权限改LocalMachine其实没必要CurrentUser就够了。改完之后必须关闭并重新打开终端因为执行策略是在 PowerShell 会话启动时读取的当前会话不会自动刷新。这一步做完openclaw doctor应该能正常启动自检流程了。但自检里有一项是模型通道连通性如果 Key 还没配这一项会失败或者提示未配置。这就进入第二段。二、TaoToken 前置OpenClaw 调用模型需要 Key 和 Base URLOpenClaw 本身不生产模型能力它是一个客户端/Agent 框架真正干活的是背后的模型。所以openclaw doctor检查模型通道时需要你提供一个可用的 API 端点和对应的 Key。TaoToken 在这里的角色很明确它提供统一的模型接入通道你拿到的是一个 Base URL 和一个 API Key。OpenClaw 把请求发到这个 Base URL带上 KeyTaoToken 负责把请求路由到对应的模型。你不需要在 OpenClaw 里分别配置每家模型厂商的地址和密钥换模型时也只需要在 TaoToken 控制台调整OpenClaw 侧的配置基本不动。具体要做的打开 TaoToken 官网 注册账号。进入控制台的 API Keys 页面创建一个新的 Key。创建后立刻复制保存页面通常只完整显示一次。记下 Base URLhttps://taotoken.net/api。注意这里不要带/v1也不要把官网带 UTM 的地址填进去。OpenClaw 的配置项要的是纯 API 端点。关于 Key 的管理后续你换模型、换工具、给不同项目分配不同 Key都在 TaoToken 控制台里操作。OpenClaw 这边只认你填进去的那一个值。如果你用的是 Claude Code 这类工具配置方式会落到settings.json里的ANTHROPIC_*环境变量如果是 Codex则对应config.toml。OpenClaw 有自己的配置入口下面按 OpenClaw 的方式来。三、可复制配置把 Base URL 和 Key 填进 OpenClawopenclaw doctor跑通之后接下来是让 OpenClaw 真正能调用模型。OpenClaw 的模型配置通常放在它的配置文件或环境变量里。不同版本的 OpenClaw 配置路径可能略有差异但核心就两个字段Base URL 和 API Key。一种常见做法是通过环境变量注入。在 PowerShell 里可以这样设置把YOUR_API_KEY换成你在 TaoToken 控制台创建的值$env:OPENCLAW_BASE_URL https://taotoken.net/api $env:OPENCLAW_API_KEY YOUR_API_KEY如果 OpenClaw 使用配置文件找到它的配置文件通常在用户目录下的.openclaw或项目根目录写入类似结构{ model: { baseUrl: https://taotoken.net/api, apiKey: YOUR_API_KEY } }几个容易填错的地方这里单独拎出来Base URL 不要带/v1。TaoToken 的 API 端点是https://taotoken.net/apiOpenClaw 或底层 SDK 会自己拼接路径。你手动加上/v1反而会导致 404。不要把官网地址填进去。官网是https://taotoken.net/带 UTM 参数的那串是给浏览器用的不是 API 端点。填错了请求会打到网页上返回 HTML 而不是 JSON。Key 不要有多余空格。从控制台复制时容易带上换行或空格粘贴后检查一下首尾。改完配置要重开终端。跟执行策略一样环境变量在当前会话里不会自动刷新。如果你更习惯用 CLI 方式管理TaoToken 也提供了命令行工具npm i -g taotoken/taotoken taotoken cc -k YOUR_API_KEY -u https://taotoken.net/api -m MODEL_ID这条命令适合在终端里快速切换模型和 Key-u后面跟的就是 API 端点-m是模型 ID。OpenClaw 场景下你可以用它来验证 Key 是否有效再回到 OpenClaw 配置里填同样的值。四、验证请求重开终端跑openclaw doctor并触发一次模型调用配置填完之后验证分两步。第一步重开终端再跑一次openclaw doctor。这一步是确认执行策略的修改和配置的写入都生效了。正常情况下之前那个SecurityError应该消失自检流程能走完。如果模型通道配置正确doctor 里关于模型连通性的检查项应该显示通过或可用。第二步触发一次真实的 OpenClaw 模型请求。openclaw doctor有时只做静态检查不一定真的发请求。所以最好手动触发一次模型调用比如让 OpenClaw 执行一个简单的对话或补全任务。观察终端输出如果返回了模型生成的文本说明 Base URL、Key、模型 ID 三者都对统一通道走通了。如果返回 401说明 Key 有问题回 TaoToken 控制台检查 Key 是否被禁用或复制错误。如果返回 404大概率是 Base URL 带了/v1或填成了官网地址。如果连接超时检查网络是否能访问taotoken.net。验证通过后你后续换模型或换工具仍然在 TaoToken 控制台管理 Key。OpenClaw 侧只需要在换模型时确认模型 ID 是否需要在配置里同步调整。五、本篇常见错排查围绕openclaw doctor和 TaoToken 配置下面这些错比较高频按现象对照排查。1. 改完执行策略openclaw doctor还是报脚本错。原因通常是没重开终端。执行策略在 PowerShell 会话启动时读取当前会话改了也不生效。关掉所有终端窗口重新打开一个再跑。另外确认你改的是CurrentUser作用域如果你在另一个用户下运行终端策略不共享。2.openclaw doctor能跑但模型检查项失败。先确认 Base URL 是不是https://taotoken.net/api有没有误加/v1。再确认 Key 是不是从 API Keys 页面 创建的、有没有复制完整。如果 Key 刚创建稍等几秒再试避免控制台同步延迟。3. 请求返回 401 Unauthorized。Key 无效或未带上。检查环境变量名是否和 OpenClaw 期望的一致有些版本用OPENCLAW_API_KEY有些用OPENCLAW_TOKEN以你本地版本的文档为准。另外确认 Key 没有多余空格。4. 请求返回 404 或返回 HTML。Base URL 填错了。最常见的是填了带 UTM 的官网地址或者手动加了/v1。正确值就是https://taotoken.net/api。5. 换模型后请求失败。模型 ID 不对。在 TaoToken 控制台确认你要用的模型 ID然后在 OpenClaw 配置或 CLI 的-m参数里填对应的值。换模型不需要换 Base URL 和 Key。6. 终端里Set-ExecutionPolicy提示权限不足。说明你改的不是CurrentUser作用域或者当前账户受限。加上-Scope CurrentUser重试一般不需要管理员权限。如果公司机器有组策略限制需要联系 IT。7. 配置改了但 OpenClaw 读不到。检查配置文件路径是否正确以及环境变量是否在启动 OpenClaw 的同一个终端会话里设置。用echo $env:OPENCLAW_BASE_URL确认当前会话能看到这个值。六、语义一致 CTA按你的下一步选入口如果你现在卡在openclaw doctor报错或模型通道配置上属于排障和接入场景建议直接去 API Keys 页面 创建 Key同时对照 接入文档 确认 Base URL 和参数格式。文档里有各工具的配置示例比对着填不容易错。如果你只是想先验证某个模型能不能用不想动 OpenClaw 配置可以去 模型对话 页面直接发一条消息看通道是否正常。这一步能快速区分是 Key 的问题还是 OpenClaw 配置的问题。如果你是在做长期编码或 Agent 类项目需要稳定、可切换的模型通道可以了解 Coding Plan。它适合把模型调用作为日常开发基础设施的场景Key 和通道管理都在控制台统一处理。回到本篇的主线openclaw doctor报错先修 PowerShell 执行策略Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser加确认加重开终端然后补上 TaoToken 的 Base URL 和 Key重开终端再跑 doctor并触发一次真实模型请求验证。两段都走通OpenClaw 的模型通道才算真正可用。