1. 为什么要在 Windows PowerShell 里折腾 OpenClaw
OpenClaw 是一个开源的 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_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_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 环境 # 模型通道统一走 TaoToken，base_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。查谁占了 18789：
netstat -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确认配置能解析，再起网关。这一步能挡掉大部分「改了没生效」的困惑。
