1. 为什么要在 Windows PowerShell 里折腾 OpenClawOpenClaw 是一个开源的 AI 智能体运行框架你可以把它理解成一个「本地大脑调度台」它本身不产出模型能力但负责把模型、工具、技能、网关串起来让 AI 能真正在你电脑上干活。适合谁适合手上有三四个 AI 工具、Key 散落在各种配置文件里、每次换模型都要翻半天文档的人。我自己的痛点很典型Claude 一个 Key、通义一个 Key、本地 Ollama 又是另一套地址写代码时切来切去配置改错一次就要重来。OpenClaw 的价值在于把这些统一到一个config.toml里而 TaoToken 的价值在于把「模型调用通道」这件事收敛成一个统一 Key——你不用再为每个模型单独申请、单独记地址。这篇聚焦 Windows PowerShell 环境从安装到config.toml骨架再到用 PowerShell 命令验证通道是否打通全程可复制。装完之后你会得到一个能跑起来的 OpenClaw 网关以及一个干净的配置结构后面加模型只需要改几行。需要提前说明OpenClaw 的安装脚本会从网络拉取PowerShell 的执行策略、路径权限、端口占用是三个最容易卡住的地方我会在排障章节逐个拆。2. TaoToken 前置统一 Key 与接入地址在动 OpenClaw 之前先把「模型通道」这件事定下来。TaoToken 提供的是统一的模型调用入口你只需要一个 Key就能在 OpenClaw 里通过 OpenAI 兼容协议访问多个模型省掉每个厂商单独配置的麻烦。第一步打开官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册并登录。登录后进入控制台找到 API Keys 页面创建一个新 Key。创建时建议命名成openclaw-win这种能一眼看出用途的名字方便以后轮换。第二步记下两个关键信息Key 本身形如sk-开头的一串字符以及接入地址https://taotoken.net/api。注意这个 API 地址后面不加任何 UTM 参数直接用它作为base_url即可。OpenClaw 走的是 OpenAI 兼容格式所以base_url填https://taotoken.net/api/v1这种带版本号的写法也能被识别具体看你用的客户端约定我在配置骨架里会写清楚。第三步确认你要用的模型名。TaoToken 控制台里能看到可用模型列表把你想在 OpenClaw 里默认使用的模型 ID 记下来比如某个通用对话模型或代码模型。这个 ID 会直接写进config.toml的model字段。注意Key 只显示一次的情况很常见创建后立刻复制到安全的地方。不要把它提交到 Git 仓库也不要在截图里露出完整 Key。如果你后面打算长期跑编码类任务或 Agent 工作流可以顺带看一下 Coding Plan 相关入口它更适合高频调用场景只是临时验证通道的话普通 API Key 就够了。3. 可复制配置OpenClaw 安装与 config.toml 骨架3.1 PowerShell 安装 OpenClaw以管理员身份打开 PowerShell。为什么要管理员因为安装脚本可能要写入系统级路径和注册环境变量。右键开始菜单选择「终端(管理员)」或「Windows PowerShell(管理员)」。先确认执行策略不会拦你。查看当前策略Get-ExecutionPolicy -List如果CurrentUser或LocalMachine显示Restricted安装脚本会被直接拒绝。改成允许本地脚本运行Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -ForceRemoteSigned的含义是本地写的脚本可以直接跑从网络下载的脚本需要有签名。这是相对安全的折中比Unrestricted稳妥。然后执行官方安装脚本iwr -useb https://openclaw.ai/install.ps1 | iexiwr是Invoke-WebRequest的别名-useb表示用基本解析模式拿内容iex是Invoke-Expression把下载到的脚本直接执行。这一步会拉取安装包并配置环境变量。安装完成后关掉当前 PowerShell 再重新开一个让环境变量生效验证命令是否可用openclaw --version能打印版本号就说明二进制已经进 PATH 了。如果提示「无法将 openclaw 项识别为 cmdlet」说明 PATH 没刷新重开终端或手动把安装目录加进 PATH。3.2 初始化工作空间OpenClaw 需要一个本地工作空间存放配置、日志和技能数据。建议单独建目录别放在中文路径或带空格的路径下减少踩坑mkdir $env:USERPROFILE\openclaw-workspace cd $env:USERPROFILE\openclaw-workspace然后让 OpenClaw 在这个目录下初始化配置。不同版本命令略有差异常见的是openclaw init如果init子命令不存在直接手动创建配置文件即可路径通常是$env:USERPROFILE\.openclaw\config.toml。下面给出完整骨架。3.3 config.toml 配置骨架这是本篇的核心交付物。把下面内容保存为config.toml放在 OpenClaw 读取的配置目录下一般是$env:USERPROFILE\.openclaw\config.toml# OpenClaw 主配置骨架 - Windows PowerShell 环境 # 模型通道统一走 TaoTokenbase_url 不带 UTM 参数 [gateway] # 网关监听端口默认 18789被占用时改这里 port 18789 host 127.0.0.1 [workspace] # 本地工作空间路径用正斜杠或双反斜杠避免转义问题 path C:/Users/YourName/openclaw-workspace [model] # 统一走 TaoToken 的 OpenAI 兼容入口 provider openai-compatible base_url https://taotoken.net/api/v1 api_key sk-你的TaoToken密钥 model 你的模型ID temperature 0.7 max_tokens 2048 [model.request_options] # 超时设置网络波动时适当调大 timeout_seconds 60 max_retries 2 [search] # 默认搜索提供商可后续在 web 控制台改 provider ollama [skills] # 技能默认关闭在 web 控制台按需开启 enabled false [logging] level info file C:/Users/YourName/openclaw-workspace/openclaw.log几个关键点解释一下。base_url用https://taotoken.net/api/v1这是 OpenAI 兼容协议的标准写法OpenClaw 会往这个地址拼/chat/completions。api_key填你在 TaoToken 控制台创建的 Key。model填控制台里确认过的模型 ID。路径统一用正斜杠/TOML 里反斜杠是转义字符写C:\Users容易出问题写成C:/Users最省心。port默认 18789如果这个端口被别的程序占了网关起不来改成 18790 之类即可。注意config.toml里含明文 Key建议给这个文件设置仅当前用户可读或者用环境变量注入的方式替代硬编码。生产环境更推荐后者。4. 验证请求PowerShell 确认通道正常配置写完先别急着开 web 控制台用命令行把通道验证一遍出问题好定位。4.1 启动网关openclaw gateway --port 18789前台运行会持续输出日志。看到类似gateway listening on 127.0.0.1:18789就说明起来了。另开一个 PowerShell 窗口做后续验证。查看网关状态openclaw gateway status查看整体运行状态openclaw status4.2 直接验证 TaoToken 通道在确认 OpenClaw 之前先用 PowerShell 直接打一次 TaoToken 的接口排除 Key 或地址问题$headers { Content-Type application/json Authorization Bearer sk-你的TaoToken密钥 } $body { model 你的模型ID messages ( { role system; content You are a helpful assistant. }, { role user; content 用一句话说明什么是向量数据库。 } ) temperature 0.7 max_tokens 256 } | ConvertTo-Json -Depth 5 Invoke-RestMethod -Uri https://taotoken.net/api/v1/chat/completions -Method Post -Headers $headers -Body $body如果返回里能看到choices字段和模型生成的文本说明 Key、地址、模型 ID 三者都对。这一步过了OpenClaw 那边基本不会因为通道问题失败。4.3 通过 OpenClaw 验证再让 OpenClaw 自己发一次请求确认它读取配置无误openclaw chat --message 你好确认通道是否正常或者用网关的 HTTP 接口验证Invoke-RestMethod -Uri http://127.0.0.1:18789/v1/chat/completions -Method Post -ContentType application/json -Body {model:你的模型ID,messages:[{role:user,content:ping}]}返回正常内容就说明 OpenClaw → TaoToken → 模型这条链路完整打通。此时浏览器访问http://127.0.0.1:18789应该能看到 web 管理控制台可以在里面继续配置搜索、技能等。5. 本篇常见错排查5.1 安装脚本被策略拦截报错关键词无法加载文件 ... 因为在此系统上禁止运行脚本。原因就是执行策略太严。回到 3.1 节执行Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force然后重开终端。如果公司组策略锁死了LocalMachine-Scope CurrentUser通常仍能生效。5.2 openclaw 命令找不到装完提示命令不存在八成是 PATH 没刷新。先重开 PowerShell还不行就手动查安装目录把它加到用户 PATH$env:Path ;C:\你的安装目录要永久生效用[Environment]::SetEnvironmentVariable写入用户级 PATH别改系统级。5.3 网关端口被占用报错关键词address already in use或bind failed。查谁占了 18789netstat -ano | findstr :18789拿到 PID 后用tasklist | findstr PID看是哪个进程。要么关掉它要么在config.toml里把port改成别的值重启网关。5.4 401 / 403 鉴权失败先检查config.toml里api_key有没有多余空格或换行TOML 字符串里换行会出问题。再确认base_url是https://taotoken.net/api/v1别把 UTM 参数拼进去。最后用 4.2 节的 PowerShell 直连脚本单独测一次能区分是 Key 问题还是 OpenClaw 读取配置的问题。5.5 模型 ID 不存在报错关键词model not found。回 TaoToken 控制台核对模型列表config.toml里的model必须和控制台里的 ID 完全一致大小写敏感。改完配置记得重启网关OpenClaw 不会热加载。5.6 TOML 解析报错报错关键词failed to parse config。最常见原因是路径里的反斜杠。把C:\Users\...全部改成C:/Users/...。其次是字符串没加引号或者数组、表结构缩进错乱。改完用openclaw status验证配置能否被读取。6. 后续怎么用把统一 Key 的价值放大配置跑通之后你手上其实有了一个可复用的结构config.toml里的[model]段就是模型通道的唯一入口。以后想换模型只改model字段想换通道只改base_url和api_key。这就是统一 Key 的意义——配置收敛到一处切换成本从「翻五个文档」降到「改一行」。如果你只是偶尔验证模型效果直接在模型对话入口里试就行不用每次都起网关。如果打算长期跑编码任务或 Agent 工作流建议把 Coding Plan 用起来高频调用下更划算。日常排查接入问题API Keys 页面和接入文档是两个最该收藏的入口Key 管理、地址确认、协议格式都在那里。最后留一个实用习惯每次改完config.toml先跑openclaw status确认配置能解析再起网关。这一步能挡掉大部分「改了没生效」的困惑。