1. Windows 小白装 Openclaw为什么 Key 总是配得一团乱Openclaw 个人版是一个可以跑在本地、帮你处理日常任务和自动化流程的智能助手框架适合想在 Windows 上折腾 AI Agent、又不想被复杂环境劝退的新手。它的安装本身不算难真正让人头疼的是你在 PowerShell 里装了一遍又在 WSL 的 Ubuntu 里装了一遍结果两边的 npm 全局包、API Key、环境变量各管各的改了一边另一边不生效最后连自己用的是哪个 Key 都搞不清。我自己第一次装的时候就踩过这个坑。PowerShell 里npm install -g openclaw跑通了切到 WSL 里再跑一次发现模型调用报 401查了半天才发现两套环境的配置文件根本不在一个地方。更麻烦的是Openclaw 的模型配置分散在settings.json和config.toml两个文件里一个管对话模型一个管网关和工具链新手很容易只改了一个就以为完事了。这篇就聚焦一件事用 TaoToken 的统一 Key把 WSL、Ubuntu 和 PowerShell 三个环境的 npm 配置一次性打通。装完之后你只需要维护一份 Key两边都能直接跑通首次调用。下面从环境准备开始一步步来。2. 前置准备TaoToken 统一 Key 与 WSL 环境2.1 先拿到 TaoToken 的 KeyTaoToken 的作用是给你一个统一的 API 入口不管你后面用哪个模型、在哪个环境里调用Key 都是同一把。这样你就不用为每个环境单独申请、单独记。打开官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册登录后进入控制台在 API Keys 页面创建一个新 Key。创建完先复制存好后面两个环境都要用。注意Key 只在创建时完整显示一次关掉页面就看不到了建议先粘到记事本里。2.2 安装 WSL 和 Ubuntu在 Windows 上以管理员身份打开 PowerShell直接输入wsl --install如果提示需要重启重启后再打开 PowerShell查看可用的发行版wsl.exe --list --online然后安装 Ubuntu 22.04wsl.exe --install Ubuntu-22.04安装完成后会自动弹出 Ubuntu 终端让你设置用户名和密码。设完记得cd回到默认路径。这里有个小细节如果你后面想用 root 操作apt update在 root 下可能会失败需要先切回普通用户执行或者做好软链接再切 root。2.3 更新仓库并确认网络进入 Ubuntu 后先更新一下软件源sudo apt update sudo apt upgrade -y防火墙这块现在 ufw 默认是关闭的不用额外折腾。确认一下sudo ufw status显示inactive就说明没开保持默认即可。3. 可复制配置settings.json 与 config.toml 骨架3.1 安装 Openclaw在 Ubuntu 里执行官方安装脚本curl -fsSL https://openclaw.ai/install.sh | bash如果你想先跳过引导、只装环境可以用curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard等几分钟脚本会做环境检查。完成后用 npm 再确认一遍npm install -g openclawlatest openclaw onboard --install-daemon3.2 写入统一 Key 到 settings.jsonOpenclaw 的模型配置在settings.json里。路径一般在~/.openclaw/settings.json没有就手动创建mkdir -p ~/.openclaw nano ~/.openclaw/settings.json写入下面这个骨架把YOUR_TAOTOKEN_KEY换成你刚才复制的 Key{ model: { provider: openai-compatible, base_url: https://taotoken.net/api, api_key: YOUR_TAOTOKEN_KEY, model_name: gpt-4o-mini }, gateway: { enabled: true, port: 18789 } }这里base_url填 TaoToken 的 API 地址注意不要带 UTM 参数纯净地址就是https://taotoken.net/api。model_name按你实际要用的模型填。3.3 写入 config.toml 骨架config.toml管的是网关和工具链路径在~/.openclaw/config.tomlnano ~/.openclaw/config.toml内容如下[gateway] host 127.0.0.1 port 18789 token YOUR_GATEWAY_TOKEN [tools] search_provider tavily search_api_key YOUR_TAVILY_KEY [logging] level infogateway.token是控制台 UI 的访问令牌安装引导时会生成一串你也可以自己设一个。search_api_key如果暂时没有可以先留空后面再补。3.4 让 PowerShell 也认这份配置关键一步来了。WSL 里的配置默认 PowerShell 是读不到的。解决办法是在 PowerShell 里设置环境变量指向同一份 Key[Environment]::SetEnvironmentVariable(OPENCLAW_API_KEY, YOUR_TAOTOKEN_KEY, User) [Environment]::SetEnvironmentVariable(OPENCLAW_BASE_URL, https://taotoken.net/api, User)设完关掉 PowerShell 重开验证一下echo $env:OPENCLAW_API_KEY能打印出你的 Key 就说明生效了。这样 PowerShell 和 WSL 用的就是同一把 Key不用两边各改一遍。4. 验证请求一条 curl 跑通首次调用配置写完别急着开 UI先用 curl 确认 Key 和地址是通的。在 Ubuntu 里执行curl -s https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer YOUR_TAOTOKEN_KEY \ -H Content-Type: application/json \ -d { model: gpt-4o-mini, messages: [{role: user, content: ping}] }如果返回里带choices字段和一段回复内容说明 Key、地址、模型名三者都对上了。如果返回 401检查 Key 有没有复制全返回 404检查base_url是不是写成了带路径的完整地址。PowerShell 里也可以用同样的方式验证注意 PowerShell 的 curl 是Invoke-WebRequest的别名建议直接用curl.exe -s https://taotoken.net/api/v1/chat/completions -H Authorization: Bearer $env:OPENCLAW_API_KEY -H Content-Type: application/json -d {\model\:\gpt-4o-mini\,\messages\:[{\role\:\user\,\content\:\ping\}]}两边都能返回正常结果就说明统一 Key 打通了。5. 本篇常见错排查5.1 npm 全局安装后命令找不到在 WSL 里npm install -g openclaw之后输入openclaw提示 command not found多半是 npm 全局 bin 目录没进 PATH。执行npm config get prefix把输出的路径拼上/bin加到~/.bashrcexport PATH$PATH:$(npm config get prefix)/bin source ~/.bashrc5.2 两个环境 Key 不一致导致 401最常见的就是 WSL 里改了settings.jsonPowerShell 里环境变量还是旧的。排查方法在 WSL 里cat ~/.openclaw/settings.json | grep api_key在 PowerShell 里echo $env:OPENCLAW_API_KEY两边对比一下。不一致就按第 3.4 步重新设。5.3 config.toml 改了不生效Openclaw 启动时会读一次配置改完必须重启网关openclaw gateway restart如果还是没生效检查文件路径是不是~/.openclaw/config.toml有些版本会读当前目录下的config.toml用openclaw config path确认实际读取位置。5.4 网关端口被占用默认端口 18789 如果被别的程序占了启动会报错。改config.toml里的port或者查一下谁占用了lsof -i :187895.5 引导模式里模型选择卡住openclaw onboard走到模型选择那步如果列表里没有你要的模型选 skip for now后面手动改settings.json里的model_name就行不用在引导里纠结。6. 后续怎么用把 Key 管好环境就不乱装完之后日常维护其实就三件事Key 变了改一处、模型换了改settings.json、工具链调了改config.toml。因为 PowerShell 和 WSL 共用同一把 TaoToken Key你不需要再为「这边改了那边没改」发愁。如果你后面要长期跑编码任务或者接 Agent 流程可以看看 Coding Plan 相关的配置把模型和工具链固定下来如果只是想先验证模型对话效果直接进模型对话页面试几条就行。接入文档里有更细的参数说明遇到报错先翻文档再动手改配置比盲目试错快得多。实测下来把 Key 统一到 TaoToken 之后WSL 和 PowerShell 两边切换调试的时间能省掉一大半。剩下的就是慢慢调你的 skill 和自动化流程了。 Openclaw 个人版安装小白指南：用 TaoToken 统一 Key 打通 WSL、Ubuntu 与 PowerShell 的 npm 配置
1. Windows 小白装 Openclaw为什么 Key 总是配得一团乱Openclaw 个人版是一个可以跑在本地、帮你处理日常任务和自动化流程的智能助手框架适合想在 Windows 上折腾 AI Agent、又不想被复杂环境劝退的新手。它的安装本身不算难真正让人头疼的是你在 PowerShell 里装了一遍又在 WSL 的 Ubuntu 里装了一遍结果两边的 npm 全局包、API Key、环境变量各管各的改了一边另一边不生效最后连自己用的是哪个 Key 都搞不清。我自己第一次装的时候就踩过这个坑。PowerShell 里npm install -g openclaw跑通了切到 WSL 里再跑一次发现模型调用报 401查了半天才发现两套环境的配置文件根本不在一个地方。更麻烦的是Openclaw 的模型配置分散在settings.json和config.toml两个文件里一个管对话模型一个管网关和工具链新手很容易只改了一个就以为完事了。这篇就聚焦一件事用 TaoToken 的统一 Key把 WSL、Ubuntu 和 PowerShell 三个环境的 npm 配置一次性打通。装完之后你只需要维护一份 Key两边都能直接跑通首次调用。下面从环境准备开始一步步来。2. 前置准备TaoToken 统一 Key 与 WSL 环境2.1 先拿到 TaoToken 的 KeyTaoToken 的作用是给你一个统一的 API 入口不管你后面用哪个模型、在哪个环境里调用Key 都是同一把。这样你就不用为每个环境单独申请、单独记。打开官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册登录后进入控制台在 API Keys 页面创建一个新 Key。创建完先复制存好后面两个环境都要用。注意Key 只在创建时完整显示一次关掉页面就看不到了建议先粘到记事本里。2.2 安装 WSL 和 Ubuntu在 Windows 上以管理员身份打开 PowerShell直接输入wsl --install如果提示需要重启重启后再打开 PowerShell查看可用的发行版wsl.exe --list --online然后安装 Ubuntu 22.04wsl.exe --install Ubuntu-22.04安装完成后会自动弹出 Ubuntu 终端让你设置用户名和密码。设完记得cd回到默认路径。这里有个小细节如果你后面想用 root 操作apt update在 root 下可能会失败需要先切回普通用户执行或者做好软链接再切 root。2.3 更新仓库并确认网络进入 Ubuntu 后先更新一下软件源sudo apt update sudo apt upgrade -y防火墙这块现在 ufw 默认是关闭的不用额外折腾。确认一下sudo ufw status显示inactive就说明没开保持默认即可。3. 可复制配置settings.json 与 config.toml 骨架3.1 安装 Openclaw在 Ubuntu 里执行官方安装脚本curl -fsSL https://openclaw.ai/install.sh | bash如果你想先跳过引导、只装环境可以用curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard等几分钟脚本会做环境检查。完成后用 npm 再确认一遍npm install -g openclawlatest openclaw onboard --install-daemon3.2 写入统一 Key 到 settings.jsonOpenclaw 的模型配置在settings.json里。路径一般在~/.openclaw/settings.json没有就手动创建mkdir -p ~/.openclaw nano ~/.openclaw/settings.json写入下面这个骨架把YOUR_TAOTOKEN_KEY换成你刚才复制的 Key{ model: { provider: openai-compatible, base_url: https://taotoken.net/api, api_key: YOUR_TAOTOKEN_KEY, model_name: gpt-4o-mini }, gateway: { enabled: true, port: 18789 } }这里base_url填 TaoToken 的 API 地址注意不要带 UTM 参数纯净地址就是https://taotoken.net/api。model_name按你实际要用的模型填。3.3 写入 config.toml 骨架config.toml管的是网关和工具链路径在~/.openclaw/config.tomlnano ~/.openclaw/config.toml内容如下[gateway] host 127.0.0.1 port 18789 token YOUR_GATEWAY_TOKEN [tools] search_provider tavily search_api_key YOUR_TAVILY_KEY [logging] level infogateway.token是控制台 UI 的访问令牌安装引导时会生成一串你也可以自己设一个。search_api_key如果暂时没有可以先留空后面再补。3.4 让 PowerShell 也认这份配置关键一步来了。WSL 里的配置默认 PowerShell 是读不到的。解决办法是在 PowerShell 里设置环境变量指向同一份 Key[Environment]::SetEnvironmentVariable(OPENCLAW_API_KEY, YOUR_TAOTOKEN_KEY, User) [Environment]::SetEnvironmentVariable(OPENCLAW_BASE_URL, https://taotoken.net/api, User)设完关掉 PowerShell 重开验证一下echo $env:OPENCLAW_API_KEY能打印出你的 Key 就说明生效了。这样 PowerShell 和 WSL 用的就是同一把 Key不用两边各改一遍。4. 验证请求一条 curl 跑通首次调用配置写完别急着开 UI先用 curl 确认 Key 和地址是通的。在 Ubuntu 里执行curl -s https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer YOUR_TAOTOKEN_KEY \ -H Content-Type: application/json \ -d { model: gpt-4o-mini, messages: [{role: user, content: ping}] }如果返回里带choices字段和一段回复内容说明 Key、地址、模型名三者都对上了。如果返回 401检查 Key 有没有复制全返回 404检查base_url是不是写成了带路径的完整地址。PowerShell 里也可以用同样的方式验证注意 PowerShell 的 curl 是Invoke-WebRequest的别名建议直接用curl.exe -s https://taotoken.net/api/v1/chat/completions -H Authorization: Bearer $env:OPENCLAW_API_KEY -H Content-Type: application/json -d {\model\:\gpt-4o-mini\,\messages\:[{\role\:\user\,\content\:\ping\}]}两边都能返回正常结果就说明统一 Key 打通了。5. 本篇常见错排查5.1 npm 全局安装后命令找不到在 WSL 里npm install -g openclaw之后输入openclaw提示 command not found多半是 npm 全局 bin 目录没进 PATH。执行npm config get prefix把输出的路径拼上/bin加到~/.bashrcexport PATH$PATH:$(npm config get prefix)/bin source ~/.bashrc5.2 两个环境 Key 不一致导致 401最常见的就是 WSL 里改了settings.jsonPowerShell 里环境变量还是旧的。排查方法在 WSL 里cat ~/.openclaw/settings.json | grep api_key在 PowerShell 里echo $env:OPENCLAW_API_KEY两边对比一下。不一致就按第 3.4 步重新设。5.3 config.toml 改了不生效Openclaw 启动时会读一次配置改完必须重启网关openclaw gateway restart如果还是没生效检查文件路径是不是~/.openclaw/config.toml有些版本会读当前目录下的config.toml用openclaw config path确认实际读取位置。5.4 网关端口被占用默认端口 18789 如果被别的程序占了启动会报错。改config.toml里的port或者查一下谁占用了lsof -i :187895.5 引导模式里模型选择卡住openclaw onboard走到模型选择那步如果列表里没有你要的模型选 skip for now后面手动改settings.json里的model_name就行不用在引导里纠结。6. 后续怎么用把 Key 管好环境就不乱装完之后日常维护其实就三件事Key 变了改一处、模型换了改settings.json、工具链调了改config.toml。因为 PowerShell 和 WSL 共用同一把 TaoToken Key你不需要再为「这边改了那边没改」发愁。如果你后面要长期跑编码任务或者接 Agent 流程可以看看 Coding Plan 相关的配置把模型和工具链固定下来如果只是想先验证模型对话效果直接进模型对话页面试几条就行。接入文档里有更细的参数说明遇到报错先翻文档再动手改配置比盲目试错快得多。实测下来把 Key 统一到 TaoToken 之后WSL 和 PowerShell 两边切换调试的时间能省掉一大半。剩下的就是慢慢调你的 skill 和自动化流程了。