1. 先别急着改策略openclaw 报错到底卡在哪一层在 Windows 的 PowerShell 里敲下openclaw回车后蹦出一行红字无法加载文件C:\Users\xxx\AppData\Roaming\npm\openclaw.ps1因为在此系统上禁止运行脚本。这个场景我见过太多次尤其是刚用 npm 全局装完 openclaw、准备跑openclaw gateway start的时候。很多人第一反应是「命令没装好」于是反复npm install -g结果报错一模一样。其实这条报错信息已经把答案写得很清楚了PowerShell 找到了openclaw.ps1这个脚本文件但系统的执行策略Execution Policy不允许运行.ps1。也就是说命令本身是装好的PATH 也大概率没问题卡住的是「脚本能不能被执行」这一层。openclaw 通过 npm 全局安装后会在 npm 的全局目录里生成三个入口openclaw给类 Unix shell 用、openclaw.cmd给 cmd 用、openclaw.ps1给 PowerShell 用。PowerShell 默认优先调用.ps1而 Windows 默认执行策略是Restricted于是直接拒绝。所以排查路径应该按「执行策略 → PATH → 配置文件」三层往下走而不是一上来就重装。这篇就按这个顺序把每一步的可复制命令、预期结果和常见坑都写清楚最后给出一份可以直接用的config.toml骨架让 openclaw 从「报错」走到「命令可用」。2. 动手前先备好 TaoToken模型接入的 Key 与地址openclaw 这类工具跑起来之后通常要接一个大模型来做对话或编码任务。如果你还没准备好可用的 API Key 和接入地址可以先在 TaoToken 上把这一步做掉省得命令修好了却卡在模型调用上。注册和拿 Key 的入口在这里https://taotoken.net/api 。登录后进控制台创建 API Key地址是 https://taotoken.net/console 。创建完记得把 Key 复制保存它只在创建时完整显示一次。如果你后面要接 Claude Code 这类编码工具可以看 https://taotoken.net/claude-code 想先验证模型通不通用 https://taotoken.net/chat 直接对话测试最省事长期跑编码或 Agent 任务建议了解 https://taotoken.net/coding-plan 。拿到 Key 之后你会在 openclaw 的配置里填两样东西base_url和api_key。base_url 用https://taotoken.net/api这个形式即可注意 API 地址不要带多余的路径后缀具体以文档为准https://taotoken.net/doc 。这一步做完再回到 PowerShell 去修命令整条链路就完整了。3. 可复制配置执行策略、PATH 与 config.toml 骨架3.1 先确认 openclaw 到底装在哪在动手改策略之前先确认 npm 全局目录和 openclaw 的真实位置避免改了半天发现命令根本没装上。# 查看 npm 全局安装目录 npm config get prefix # 查看 openclaw 相关入口文件是否存在 Get-ChildItem $(npm config get prefix) -Filter openclaw*正常应该看到openclaw、openclaw.cmd、openclaw.ps1三个文件。如果只有.cmd没有.ps1那报错原因就不同了属于安装不完整需要重新npm install -g openclaw。如果三个都在继续往下。3.2 临时绕过用 openclaw.cmd 先跑起来不想改系统设置的话最省事的办法是显式调用.cmd版本。PowerShell 里直接敲openclaw.cmd gateway start.cmd走的是 cmd 解释器不受 PowerShell 执行策略限制所以能立刻跑起来。这个方案适合临时验证但每次都要多打.cmd长期用不顺手。3.3 永久方案调整当前用户的执行策略推荐用RemoteSigned它允许本地脚本运行但从网络下载的脚本仍需签名比Unrestricted安全。以当前用户身份执行即可不需要管理员权限Set-ExecutionPolicy RemoteSigned -Scope CurrentUser执行后会提示确认输入Y回车。然后验证Get-ExecutionPolicy -Scope CurrentUser预期输出RemoteSigned。这时候再敲openclaw.ps1就能正常加载了。注意-Scope CurrentUser只影响当前用户不会动系统全局策略风险可控。3.4 检查 PATH 是否包含 npm 全局目录如果执行策略改完还是提示「无法将 openclaw 识别为 cmdlet」那就是 PATH 的问题。查看当前 PATH$env:Path -split ; | Select-String npm如果没看到 npm 全局目录把它加进当前会话$npmPrefix npm config get prefix $env:Path ;$npmPrefix要永久生效用系统环境变量界面或这条命令写入用户级 PATH[Environment]::SetEnvironmentVariable( Path, [Environment]::GetEnvironmentVariable(Path, User) ;$npmPrefix, User )改完 PATH 需要重开一个 PowerShell 窗口才会生效。3.5 config.toml 骨架openclaw 的配置文件一般放在用户目录下的.openclaw/config.toml具体路径以你安装版本的文档为准。下面是一份可直接改用的骨架把api_key换成你自己的即可# ~/.openclaw/config.toml [gateway] # 网关监听地址与端口 host 127.0.0.1 port 8787 [model] # 模型接入地址使用 TaoToken 的 API 入口 base_url https://taotoken.net/api # 替换为你自己的 API Key api_key sk-你的Key # 默认使用的模型名称按需修改 default_model claude-sonnet [logging] level info # 日志文件路径Windows 下注意用正斜杠或双反斜杠 file C:/Users/你的用户名/.openclaw/openclaw.log [workspace] # 工作目录编码类任务会在这里读写文件 root C:/Users/你的用户名/openclaw-workspace几个容易踩的点Windows 路径在 TOML 里建议用正斜杠/或者用双反斜杠\\单反斜杠会被当成转义符api_key不要带引号以外的空格base_url末尾不要多加/v1之类的后缀除非文档明确要求。4. 验证请求从命令可用到模型连通配置写好后分两步验证。第一步确认命令本身可用openclaw --version能打印版本号说明执行策略和 PATH 都通了。第二步验证配置和模型连通openclaw gateway start如果网关正常启动会看到监听127.0.0.1:8787的日志。再开一个 PowerShell 窗口发一个测试请求curl.exe http://127.0.0.1:8787/health预期返回类似{status:ok}的 JSON。如果这一步返回连接被拒绝说明网关没起来回去看日志文件里的报错。想直接验证模型是否通可以在 https://taotoken.net/chat 里用同一个 Key 发一条消息能正常回复就说明 Key 和地址没问题问题只在本机配置。5. 本篇常见错排查报错一无法加载 openclaw.ps1禁止运行脚本。执行策略没改按 3.3 执行Set-ExecutionPolicy RemoteSigned -Scope CurrentUser。改完仍报错检查是不是在管理员窗口改的、当前用户窗口没生效重开窗口再试。报错二无法将 openclaw 识别为 cmdlet。PATH 里没有 npm 全局目录按 3.4 添加。注意npm config get prefix的输出可能带尾部反斜杠拼接时别重复。报错三gateway 启动后立刻退出。多半是 config.toml 解析失败。TOML 对格式敏感检查路径里的反斜杠、字符串引号是否配对。可以先用最小配置只留[gateway]段测试跑通后再逐段加回。报错四health 返回 401 或 403。API Key 无效或没填对。确认 Key 是从 https://taotoken.net/api-keys 创建的且没有多余空格。base_url 用https://taotoken.net/api不要自己拼路径。报错五改了 PATH 但新窗口还是找不到。用户级环境变量写入后已打开的窗口不会刷新。彻底关掉所有 PowerShell 窗口再开或者注销重登。6. 把命令修通之后下一步接什么命令能跑、网关能起、模型能通这三步闭环做完openclaw 才算真正可用。如果你只是想让命令别报错到第 4 节验证通过就可以停了。接下来要接模型做对话或编码按你的场景选入口单纯验证模型效果用 https://taotoken.net/chat 要接 Claude Code 这类编码工具看 https://taotoken.net/claude-code 准备长期跑编码或 Agent 任务建议从 https://taotoken.net/coding-plan 了解套餐Key 管理和创建都在 https://taotoken.net/api-keys 接入细节查 https://taotoken.net/doc 。我自己的习惯是config.toml 改完先跑一次openclaw gateway start看日志确认没有解析错误再发 health 请求最后才去测模型。这样出问题时能立刻定位是配置层还是网络层比一股脑重装省时间。