1. 纯净 Win 环境手动部署 OpenClaw 小龙虾汉化版到底难在哪OpenClaw 小龙虾汉化版是一个跑在本地、能接管终端与文件系统的智能体框架适合想在 Windows 上做本地 Agent 实验、又不想被各种环境变量和编译错误劝退的人。它本身是 Node 生态的 CLI 工具但汉化版在安装脚本里会调用本地编译链去构建部分原生依赖所以纯净 Windows 上第一次跑最容易卡在三个地方Visual Studio C 构建工具没装全、PowerShell 执行策略拦脚本、以及模型通道的 Key 没接对导致openclaw doctor一直报认证失败。我这篇按“从零到一次跑通”的顺序写覆盖 Visual Studio Build Tools 的组件勾选、PowerShell 环境准备、OpenClaw 汉化版安装、TaoToken 统一 Key 接入、config.toml与settings.json骨架、CC Switch / Cline 配置片段最后给一套 PowerShell 逐条验证动作和报错排查路径。目标很明确你照着敲完openclaw --version有输出、openclaw status --all全绿、openclaw dashboard能打开。先说清楚适用人群如果你只是想在 Windows 上体验一下本地 Agent不想碰编译那这篇的 Visual Studio 部分你可以先跳过等真报node-gyp错误再回来补如果你是要长期跑编码任务、接自己的模型通道那这套流程值得完整走一遍因为后面接 TaoToken 统一 Key 的时候通道配置和网关模式是绑在一起的一次配好省得反复折腾。2. 前置准备Visual Studio C 构建依赖与 PowerShell 环境2.1 装 Visual Studio 2022 Build Tools纯净 Windows 上没装过任何编译环境的话直接跑 OpenClaw 安装脚本大概率会在原生模块编译阶段报gyp ERR! find VS或者MSBuild not found。解决办法是装 Visual Studio 2022 Build Tools不用装完整的 IDE。访问 Visual Studio 官方下载页往下滚到“Visual Studio 2022 工具”区域点“Visual Studio 2022 Build Tools”旁边的免费下载。下载完以管理员身份运行安装程序在“工作负载”选项卡里勾选“使用 C 的桌面开发”。这个选项会自动带上 MSVC 编译器、Windows SDK、CMake 这些 OpenClaw 编译原生依赖需要的东西。安装完建议重启一次 PowerShell让环境变量生效。验证方式很简单开一个新的 PowerShell 窗口敲where.exe cl如果输出类似C:\Program Files (x86)\Microsoft Visual Studio\2022\BuildTools\VC\Tools\MSVC\...\bin\Hostx64\x64\cl.exe说明编译器路径已经进环境变量了。没有输出的话去“开始菜单”搜 “Developer PowerShell for VS 2022”在那个窗口里操作它自带环境初始化。2.2 PowerShell 执行策略与管理员模式OpenClaw 汉化版的安装脚本是.ps1纯净 Windows 默认执行策略是Restricted直接跑会被拦。用管理员模式打开 PowerShellWin X 然后选“终端(管理员)”或“Windows PowerShell(管理员)”先临时放开当前进程的策略Set-ExecutionPolicy Bypass -Scope Process -Force这里用-Scope Process只影响当前这个 PowerShell 会话关掉窗口就恢复比全局改策略安全。如果你后面要反复装可以把它写进一个init.ps1里每次先执行。注意不要用Set-ExecutionPolicy Unrestricted全局放开纯净环境里没必要而且会留下安全隐患。2.3 确认 Node 与 npm 版本OpenClaw 依赖 Node 运行时建议 Node 18 LTS 以上。纯净 Windows 上如果没装去 Node 官网下 LTS 的 msi 安装包装完新开 PowerShell 验证node -v npm -v两个都有版本号输出就行。如果node能跑但npm报找不到多半是安装时没勾“Add to PATH”重装一次勾上即可。3. TaoToken 统一 Key 前置拿 Key、选通道、定模型OpenClaw 本身不带模型它通过配置里的 provider 去调外部通道。TaoToken 在这里的角色是统一 Key 网关你只需要一个 Key就能在 OpenClaw、CC Switch、Cline 这些工具里共用同一套模型通道不用每个工具单独配一遍。先去官网注册并进控制台在 API Keys 页面创建一个 Key。创建时注意两点一是给它起个能认出来的名字比如openclaw-local方便后面在多个工具里区分二是创建后立刻复制保存页面刷新后就看不到完整 Key 了。拿到 Key 之后通道地址用https://taotoken.net/api这个是不带任何追踪参数的 API 入口配置里填这个。模型名按你控制台里开通的填常见的是claude-sonnet-4-5、gpt-4o这类具体以你账号里可用的为准。如果你后面要长期跑编码任务、接 Agent 工作流建议顺手看一下 Coding Plan 页面它把常用编码模型的通道和额度打包好了比单次调用省心。只是临时验证模型通不通用模型对话页面直接测就行不用先配 OpenClaw。4. 安装 OpenClaw 小龙虾汉化版并接入 TaoToken4.1 执行汉化版安装脚本在管理员 PowerShell 里先执行 2.2 里的执行策略命令然后跑汉化版安装脚本iwr -useb https://clawd.org.cn/install.ps1 | iex这个脚本会拉取汉化版包并做本地构建。如果前面 Visual Studio Build Tools 装好了这一步应该能顺利过编译阶段。装完验证openclaw --version有版本号输出就说明 CLI 装上了。如果报openclaw 不是内部或外部命令说明 npm 全局 bin 目录没进 PATH执行npm config get prefix看路径把它加到系统 PATH 里再新开窗口。4.2 初始化运行模式与网关先让 OpenClaw 自检并修复常见配置问题openclaw doctor --fix然后看所有组件状态openclaw status --all接着把网关设成本地模式这样模型请求走本机网关转发方便统一管理 Keyopenclaw config set gateway.mode local再跑一次引导把模型认证、通道、工作区这些一次性配好openclaw onboard引导过程里会让你填 provider、base URL、API Key、模型名。provider 选兼容 OpenAI 协议的那类base URL 填https://taotoken.net/apiAPI Key 填你在 TaoToken 控制台创建的那个模型名填你账号里可用的。4.3 config.toml 骨架OpenClaw 的主配置在用户目录下的.openclaw/config.toml。如果你不想在引导里一条条填可以直接改这个文件。下面是一个可复制的骨架[gateway] mode local port 8787 [provider.taotoken] type openai-compatible base_url https://taotoken.net/api api_key sk-你的TaoTokenKey default_model claude-sonnet-4-5 [workspace] path C:\\Users\\你的用户名\\.openclaw\\workspace [logging] level info改完保存跑openclaw gateway restart让配置生效。注意api_key这里填明文只是本地开发方便如果你要把配置同步到别的机器建议用环境变量引用OpenClaw 支持${TAOTOKEN_API_KEY}这种写法。4.4 settings.json 骨架有些组件比如 Cline 插件、CC Switch读的是settings.json。在.openclaw/settings.json里放一份统一配置{ provider: taotoken, baseUrl: https://taotoken.net/api, apiKey: sk-你的TaoTokenKey, model: claude-sonnet-4-5, gateway: { mode: local, port: 8787 }, workspace: C:\\Users\\你的用户名\\.openclaw\\workspace }4.5 CC Switch 与 Cline 配置片段CC Switch 用来在多个模型通道之间切换配置里加一段{ providers: [ { name: taotoken, baseUrl: https://taotoken.net/api, apiKey: sk-你的TaoTokenKey, models: [claude-sonnet-4-5, gpt-4o] } ], active: taotoken }Cline 插件在 VS Code 里的配置打开设置搜 Cline把 API Provider 选成 OpenAI CompatibleBase URL 填https://taotoken.net/apiAPI Key 填同一个Model ID 填claude-sonnet-4-5。这样 Cline 和 OpenClaw 共用同一个 Key额度统一在 TaoToken 控制台看。5. PowerShell 逐条验证与成功结果配置完别急着跑任务按下面顺序逐条验证每步都有明确预期输出。第一步确认 CLI 可用openclaw --version预期输出类似openclaw/0.x.x win32-x64 node-v20.x.x。第二步确认网关配置生效openclaw config get gateway.mode预期输出local。第三步确认组件状态openclaw status --all预期provider、gateway、workspace 三项都是ok或ready没有error。第四步装并启动网关服务openclaw gateway install openclaw gateway start预期gateway install输出服务注册成功gateway start输出监听端口 8787。第五步发一条真实请求验证通道openclaw run 用一句话说明你现在用的是哪个模型预期返回一句模型自述说明 TaoToken 通道已经通了。如果这一步报 401回去检查 Key 有没有复制全报 404检查 base URL 是不是https://taotoken.net/api别多加斜杠或路径。第六步打开面板确认整体状态openclaw dashboard预期浏览器打开本地面板能看到网关运行中、provider 已连接、最近请求记录。6. 本篇常见报错排查路径报错一gyp ERR! find VS或MSBuild not found原因Visual Studio Build Tools 没装或组件没勾全。排查跑where.exe cl看有没有输出没有就回 2.1 重装确认勾了“使用 C 的桌面开发”。装完新开 PowerShell 再试。报错二无法加载文件 ... install.ps1因为在此系统上禁止运行脚本原因执行策略没放开。排查确认是在管理员 PowerShell 里跑的且先执行了Set-ExecutionPolicy Bypass -Scope Process -Force。如果还报检查是不是在 32 位 PowerShell 里跑的换成 64 位。报错三openclaw 不是内部或外部命令原因npm 全局 bin 没进 PATH。排查npm config get prefix拿到路径把它加到系统环境变量 Path 里新开窗口验证。报错四openclaw doctor报 provider 认证失败原因Key 填错、base URL 填错、或模型名不在账号可用列表里。排查先用模型对话页面单独测一下 Key 通不通通了再回 OpenClaw 配置。base URL 确认是https://taotoken.net/api不要带尾斜杠。报错五gateway start报端口占用原因8787 被别的进程占了。排查netstat -ano | findstr 8787找到 PID任务管理器结束或者改config.toml里的gateway.port换个端口再gateway restart。报错六openclaw run一直转圈不返回原因网关没起来或者本地防火墙拦了回环请求。排查先openclaw status --all确认 gateway 是 running再检查 Windows 防火墙有没有拦 8787 端口的本地回环。7. 后续接入与长期使用建议一次跑通之后如果你只是偶尔验证模型用模型对话页面就够了不用每次都开 OpenClaw。如果你要长期跑编码任务、接 Agent 工作流建议把 Key 管理集中到 TaoToken 控制台OpenClaw、CC Switch、Cline 共用同一个 Key额度消耗一目了然。接入文档里有各工具的详细配置说明遇到新工具接入时对着看比翻博客快。长期跑的话还有两个小习惯值得养成一是把config.toml里的api_key换成环境变量引用避免配置文件同步时泄露二是定期跑openclaw doctor --fix汉化版更新后有些配置项会变自检能提前发现不兼容。网关模式保持local模型请求走本机转发排查问题时看日志也方便。
纯净Win环境手动部署OpenClaw小龙虾（汉化版）：TaoToken统一Key接入与PowerShell验证
1. 纯净 Win 环境手动部署 OpenClaw 小龙虾汉化版到底难在哪OpenClaw 小龙虾汉化版是一个跑在本地、能接管终端与文件系统的智能体框架适合想在 Windows 上做本地 Agent 实验、又不想被各种环境变量和编译错误劝退的人。它本身是 Node 生态的 CLI 工具但汉化版在安装脚本里会调用本地编译链去构建部分原生依赖所以纯净 Windows 上第一次跑最容易卡在三个地方Visual Studio C 构建工具没装全、PowerShell 执行策略拦脚本、以及模型通道的 Key 没接对导致openclaw doctor一直报认证失败。我这篇按“从零到一次跑通”的顺序写覆盖 Visual Studio Build Tools 的组件勾选、PowerShell 环境准备、OpenClaw 汉化版安装、TaoToken 统一 Key 接入、config.toml与settings.json骨架、CC Switch / Cline 配置片段最后给一套 PowerShell 逐条验证动作和报错排查路径。目标很明确你照着敲完openclaw --version有输出、openclaw status --all全绿、openclaw dashboard能打开。先说清楚适用人群如果你只是想在 Windows 上体验一下本地 Agent不想碰编译那这篇的 Visual Studio 部分你可以先跳过等真报node-gyp错误再回来补如果你是要长期跑编码任务、接自己的模型通道那这套流程值得完整走一遍因为后面接 TaoToken 统一 Key 的时候通道配置和网关模式是绑在一起的一次配好省得反复折腾。2. 前置准备Visual Studio C 构建依赖与 PowerShell 环境2.1 装 Visual Studio 2022 Build Tools纯净 Windows 上没装过任何编译环境的话直接跑 OpenClaw 安装脚本大概率会在原生模块编译阶段报gyp ERR! find VS或者MSBuild not found。解决办法是装 Visual Studio 2022 Build Tools不用装完整的 IDE。访问 Visual Studio 官方下载页往下滚到“Visual Studio 2022 工具”区域点“Visual Studio 2022 Build Tools”旁边的免费下载。下载完以管理员身份运行安装程序在“工作负载”选项卡里勾选“使用 C 的桌面开发”。这个选项会自动带上 MSVC 编译器、Windows SDK、CMake 这些 OpenClaw 编译原生依赖需要的东西。安装完建议重启一次 PowerShell让环境变量生效。验证方式很简单开一个新的 PowerShell 窗口敲where.exe cl如果输出类似C:\Program Files (x86)\Microsoft Visual Studio\2022\BuildTools\VC\Tools\MSVC\...\bin\Hostx64\x64\cl.exe说明编译器路径已经进环境变量了。没有输出的话去“开始菜单”搜 “Developer PowerShell for VS 2022”在那个窗口里操作它自带环境初始化。2.2 PowerShell 执行策略与管理员模式OpenClaw 汉化版的安装脚本是.ps1纯净 Windows 默认执行策略是Restricted直接跑会被拦。用管理员模式打开 PowerShellWin X 然后选“终端(管理员)”或“Windows PowerShell(管理员)”先临时放开当前进程的策略Set-ExecutionPolicy Bypass -Scope Process -Force这里用-Scope Process只影响当前这个 PowerShell 会话关掉窗口就恢复比全局改策略安全。如果你后面要反复装可以把它写进一个init.ps1里每次先执行。注意不要用Set-ExecutionPolicy Unrestricted全局放开纯净环境里没必要而且会留下安全隐患。2.3 确认 Node 与 npm 版本OpenClaw 依赖 Node 运行时建议 Node 18 LTS 以上。纯净 Windows 上如果没装去 Node 官网下 LTS 的 msi 安装包装完新开 PowerShell 验证node -v npm -v两个都有版本号输出就行。如果node能跑但npm报找不到多半是安装时没勾“Add to PATH”重装一次勾上即可。3. TaoToken 统一 Key 前置拿 Key、选通道、定模型OpenClaw 本身不带模型它通过配置里的 provider 去调外部通道。TaoToken 在这里的角色是统一 Key 网关你只需要一个 Key就能在 OpenClaw、CC Switch、Cline 这些工具里共用同一套模型通道不用每个工具单独配一遍。先去官网注册并进控制台在 API Keys 页面创建一个 Key。创建时注意两点一是给它起个能认出来的名字比如openclaw-local方便后面在多个工具里区分二是创建后立刻复制保存页面刷新后就看不到完整 Key 了。拿到 Key 之后通道地址用https://taotoken.net/api这个是不带任何追踪参数的 API 入口配置里填这个。模型名按你控制台里开通的填常见的是claude-sonnet-4-5、gpt-4o这类具体以你账号里可用的为准。如果你后面要长期跑编码任务、接 Agent 工作流建议顺手看一下 Coding Plan 页面它把常用编码模型的通道和额度打包好了比单次调用省心。只是临时验证模型通不通用模型对话页面直接测就行不用先配 OpenClaw。4. 安装 OpenClaw 小龙虾汉化版并接入 TaoToken4.1 执行汉化版安装脚本在管理员 PowerShell 里先执行 2.2 里的执行策略命令然后跑汉化版安装脚本iwr -useb https://clawd.org.cn/install.ps1 | iex这个脚本会拉取汉化版包并做本地构建。如果前面 Visual Studio Build Tools 装好了这一步应该能顺利过编译阶段。装完验证openclaw --version有版本号输出就说明 CLI 装上了。如果报openclaw 不是内部或外部命令说明 npm 全局 bin 目录没进 PATH执行npm config get prefix看路径把它加到系统 PATH 里再新开窗口。4.2 初始化运行模式与网关先让 OpenClaw 自检并修复常见配置问题openclaw doctor --fix然后看所有组件状态openclaw status --all接着把网关设成本地模式这样模型请求走本机网关转发方便统一管理 Keyopenclaw config set gateway.mode local再跑一次引导把模型认证、通道、工作区这些一次性配好openclaw onboard引导过程里会让你填 provider、base URL、API Key、模型名。provider 选兼容 OpenAI 协议的那类base URL 填https://taotoken.net/apiAPI Key 填你在 TaoToken 控制台创建的那个模型名填你账号里可用的。4.3 config.toml 骨架OpenClaw 的主配置在用户目录下的.openclaw/config.toml。如果你不想在引导里一条条填可以直接改这个文件。下面是一个可复制的骨架[gateway] mode local port 8787 [provider.taotoken] type openai-compatible base_url https://taotoken.net/api api_key sk-你的TaoTokenKey default_model claude-sonnet-4-5 [workspace] path C:\\Users\\你的用户名\\.openclaw\\workspace [logging] level info改完保存跑openclaw gateway restart让配置生效。注意api_key这里填明文只是本地开发方便如果你要把配置同步到别的机器建议用环境变量引用OpenClaw 支持${TAOTOKEN_API_KEY}这种写法。4.4 settings.json 骨架有些组件比如 Cline 插件、CC Switch读的是settings.json。在.openclaw/settings.json里放一份统一配置{ provider: taotoken, baseUrl: https://taotoken.net/api, apiKey: sk-你的TaoTokenKey, model: claude-sonnet-4-5, gateway: { mode: local, port: 8787 }, workspace: C:\\Users\\你的用户名\\.openclaw\\workspace }4.5 CC Switch 与 Cline 配置片段CC Switch 用来在多个模型通道之间切换配置里加一段{ providers: [ { name: taotoken, baseUrl: https://taotoken.net/api, apiKey: sk-你的TaoTokenKey, models: [claude-sonnet-4-5, gpt-4o] } ], active: taotoken }Cline 插件在 VS Code 里的配置打开设置搜 Cline把 API Provider 选成 OpenAI CompatibleBase URL 填https://taotoken.net/apiAPI Key 填同一个Model ID 填claude-sonnet-4-5。这样 Cline 和 OpenClaw 共用同一个 Key额度统一在 TaoToken 控制台看。5. PowerShell 逐条验证与成功结果配置完别急着跑任务按下面顺序逐条验证每步都有明确预期输出。第一步确认 CLI 可用openclaw --version预期输出类似openclaw/0.x.x win32-x64 node-v20.x.x。第二步确认网关配置生效openclaw config get gateway.mode预期输出local。第三步确认组件状态openclaw status --all预期provider、gateway、workspace 三项都是ok或ready没有error。第四步装并启动网关服务openclaw gateway install openclaw gateway start预期gateway install输出服务注册成功gateway start输出监听端口 8787。第五步发一条真实请求验证通道openclaw run 用一句话说明你现在用的是哪个模型预期返回一句模型自述说明 TaoToken 通道已经通了。如果这一步报 401回去检查 Key 有没有复制全报 404检查 base URL 是不是https://taotoken.net/api别多加斜杠或路径。第六步打开面板确认整体状态openclaw dashboard预期浏览器打开本地面板能看到网关运行中、provider 已连接、最近请求记录。6. 本篇常见报错排查路径报错一gyp ERR! find VS或MSBuild not found原因Visual Studio Build Tools 没装或组件没勾全。排查跑where.exe cl看有没有输出没有就回 2.1 重装确认勾了“使用 C 的桌面开发”。装完新开 PowerShell 再试。报错二无法加载文件 ... install.ps1因为在此系统上禁止运行脚本原因执行策略没放开。排查确认是在管理员 PowerShell 里跑的且先执行了Set-ExecutionPolicy Bypass -Scope Process -Force。如果还报检查是不是在 32 位 PowerShell 里跑的换成 64 位。报错三openclaw 不是内部或外部命令原因npm 全局 bin 没进 PATH。排查npm config get prefix拿到路径把它加到系统环境变量 Path 里新开窗口验证。报错四openclaw doctor报 provider 认证失败原因Key 填错、base URL 填错、或模型名不在账号可用列表里。排查先用模型对话页面单独测一下 Key 通不通通了再回 OpenClaw 配置。base URL 确认是https://taotoken.net/api不要带尾斜杠。报错五gateway start报端口占用原因8787 被别的进程占了。排查netstat -ano | findstr 8787找到 PID任务管理器结束或者改config.toml里的gateway.port换个端口再gateway restart。报错六openclaw run一直转圈不返回原因网关没起来或者本地防火墙拦了回环请求。排查先openclaw status --all确认 gateway 是 running再检查 Windows 防火墙有没有拦 8787 端口的本地回环。7. 后续接入与长期使用建议一次跑通之后如果你只是偶尔验证模型用模型对话页面就够了不用每次都开 OpenClaw。如果你要长期跑编码任务、接 Agent 工作流建议把 Key 管理集中到 TaoToken 控制台OpenClaw、CC Switch、Cline 共用同一个 Key额度消耗一目了然。接入文档里有各工具的详细配置说明遇到新工具接入时对着看比翻博客快。长期跑的话还有两个小习惯值得养成一是把config.toml里的api_key换成环境变量引用避免配置文件同步时泄露二是定期跑openclaw doctor --fix汉化版更新后有些配置项会变自检能提前发现不兼容。网关模式保持local模型请求走本机转发排查问题时看日志也方便。
