1. win10 手动装龙虾到底卡在哪从 winget 失踪到 PATH 不生效win10 手动安装龙虾OpenClaw这件事说难不难说简单也容易翻车。它本质上是一个跑在 Node.js 上的命令行工具理论上一条安装脚本就能搞定但我在一台只有 8G 内存的老机器上实测脚本跑一半窗口直接闪退连报错都看不到。后来才发现问题根本不在龙虾本身而是 win10 这套环境缺了三样东西Git、Node、以及一个能正常工作的 winget。这篇内容适合谁如果你手上是一台刚装好 win10 的旧电脑或者一台从没配过开发环境的办公机想从零把龙虾跑起来并且希望一次跑通不报错那下面的链路就是为你准备的。核心检索词先摆出来win10 下用 PowerShell winget Node Git 手动搭环境最后在 config.toml 里填入 TaoToken 的统一 Key 和 API 通道。为什么不用一键脚本我试过脚本依赖 NodeNode 没装它就直接退出装了 Node 之后它又要 GitGit 没有又退出等你去装 Git发现 winget 命令根本不存在。这一连串依赖像多米诺骨牌缺一张就全倒。所以更稳的做法是手动把 Git、Node、winget 这三块地基按顺序铺好再让龙虾的安装脚本去跑。这样每一步都能单独验证出错也知道是哪一层的问题。下面所有命令都在 PowerShell 里执行而且建议用管理员身份运行 PowerShell避免权限问题导致安装到一半失败。后面简称 ps。2. 前置准备TaoToken 统一 Key 与 API 通道先拿到手龙虾装好之后要接模型这一步绕不开 API Key。我用的方案是 TaoToken它把多个模型的调用通道统一成一个 Key 和一个 API 地址配置的时候不用为每个模型单独记一套地址对新手比较友好。你需要提前做两件事。第一注册并登录 TaoToken 官网地址是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 进去之后在控制台里创建一个 API Key。第二记住统一的 API 接入地址https://taotoken.net/api 注意这个地址后面不加任何 UTM 参数配置里要填的就是它。创建 Key 的入口在控制台的 API Keys 页面直接访问 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 就能到。生成出来的 Key 一般是一串以 sk- 开头的字符串复制下来先存到记事本里后面写进 config.toml 要用。注意Key 只显示一次页面关掉就看不到了。如果没存就重新生成一个别硬找。如果你后面想先验证模型通不通可以先用模型对话页面发一条测试消息地址是 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。这一步不是必须的但能帮你确认 Key 本身是有效的省得装完龙虾再回头排查是 Key 的问题还是环境的问题。3. 可复制配置winget、Git、Node 三步装齐3.1 先修 winget从 msixbundle 手动装win10 自带的 winget 经常是坏的表现就是winget --version提示「无法被识别为命令」重启 ps、重启系统都没用。我对比过一台正常的机器发现坏掉的机器在C:\Program Files\WindowsApps\Microsoft.DesktopAppInstaller_1.27.470.0_x64__8wekyb3d8bbwe目录下根本没有 winget.exe。这种情况别在商店里折腾了直接手动装。打开浏览器访问 winget-cli 的 releases 页面下载Microsoft.DesktopAppInstaller_8wekyb3d8bbwe.msixbundle这个文件。下载完成后双击安装如果提示缺少依赖就按提示把依赖包也装上。装完之后不要急着验证先把 ps 关掉重开一个管理员窗口再执行winget --version正常的话会输出类似v1.27.470的版本号。如果还是提示无法识别检查一下系统变量 PATH 里有没有%LOCALAPPDATA%\Microsoft\WindowsApps没有就手动加上然后重启 ps。3.2 用 winget 装 Gitwinget 修好之后装 Git 就是一条命令的事winget install --id Git.Git -e --source winget参数说明一下--id Git.Git指定包 ID-e表示精确匹配--source winget强制从 winget 源拉取避免走到别的源导致版本混乱。安装过程会下载几十兆的安装包耐心等它跑完。装完之后必须重启 ps因为 Git 会把路径写进环境变量当前这个 ps 窗口读不到新变量。重启后再验证git --version输出git version 2.x.x就说明 Git 到位了。3.3 装 Node.jsNode 我建议直接去官网下载 msi 安装包比用 winget 装更可控。访问 nodejs.org 的中文下载页选 LTS 版本下载.msi文件后双击运行。安装过程中会有一个「是否安装附加工具」的勾选项我勾上了它会顺带装上 Python 和一堆编译工具后面如果龙虾有原生模块要编译就不会卡住。安装完成后同样重启 ps然后验证两个命令node -v npm -v两个都有版本号输出Node 环境就算搭好了。到这里Git、Node、winget 三块地基全部就位。4. 装龙虾并验证从 install.ps1 到 config.toml 填 TaoToken4.1 跑安装脚本环境齐了之后龙虾的安装脚本就不会再因为缺依赖而闪退了。在管理员 ps 里执行iwr -useb https://openclaw.ai/install.ps1 | iex这条命令用iwrInvoke-WebRequest拉取脚本内容再用iexInvoke-Expression执行。实测下来这一步会比较慢而且没有下载进度提示看起来像卡住了其实是在下载别急着关窗口。如果等了很久实在没动静可以换国内镜像脚本iwr -useb https://open-claw.org.cn/install-cn.ps1 | iex安装完成后脚本一般会自动启动配置程序。配置流程网上教程很多这里不展开重点说 config.toml 里怎么填 TaoToken。4.2 config.toml 骨架与 TaoToken 配置片段龙虾的配置文件通常位于用户目录下的.openclaw/config.toml具体路径以安装脚本提示为准。用记事本或 VS Code 打开骨架大概长这样关键是[model]这一段# OpenClaw 配置文件 [model] provider openai api_key sk-你的TaoToken密钥 base_url https://taotoken.net/api model_name gpt-4o [agent] name my-claw workspace C:\\Users\\你的用户名\\claw-workspace几个参数对照着填参数填什么说明provideropenaiTaoToken 兼容 OpenAI 格式统一走这个api_keysk-开头的那串从 TaoToken 控制台复制base_urlhttps://taotoken.net/api统一 API 通道不加 UTMmodel_name你要用的模型名按 TaoToken 文档里支持的模型填注意base_url 结尾不要多加斜杠也不要带任何查询参数就填https://taotoken.net/api这一串。填完保存关掉配置文件。4.3 验证安装与配置回到 ps先验证龙虾本体openclaw --version有版本号输出说明安装成功。如果提示「不是可识别的命令」多半是环境变量没生效先重启 ps还不行就升级到最新版npm install -g openclawlatest然后验证配置能不能真正调通模型。在 ps 里启动龙虾的交互模式发一条测试消息比如「你好报一下你的模型名」。如果返回正常内容说明 TaoToken 的 Key 和 API 通道都通了。这一步是整个链路里最关键的验证前面所有环境准备都是为了这一刻。5. 本篇常见错排查winget 失踪、PATH 不生效、命令找不到winget 装了但命令找不到。最常见的原因是C:\Program Files\WindowsApps\Microsoft.DesktopAppInstaller_...目录下没有 winget.exe说明装的是个空壳。解决办法就是回到 3.1用 msixbundle 手动装一遍别依赖商店。git 或 node 装完当前 ps 用不了。这是环境变量没刷新当前 ps 窗口读的是启动时的旧变量。关掉窗口重开一个管理员 ps 就行不用重启系统。openclaw 提示不是可识别的命令。先重启 ps再不行就npm install -g openclawlatest升级。旧版本在 win10 上确实有环境变量注册不全的问题升级到较新版本能解决。配置填完还是调不通模型。按顺序查三样Key 是不是复制全了sk- 开头那串别漏字符、base_url 是不是https://taotoken.net/api、provider 是不是openai。这三样任意一个错都会导致请求失败。如果还不行去 TaoToken 的模型对话页面用同一个 Key 发条消息能通说明 Key 没问题问题在 config.toml 的格式上比如 TOML 的引号或缩进写错了。安装脚本跑一半窗口闪退。这基本就是缺 Node 或 Git 导致的脚本遇到缺失依赖直接退出来不及显示报错。按本文顺序先把 Git、Node、winget 装好再跑脚本就不会闪退。6. 后续怎么走长期编码与 Agent 场景的接入建议环境搭好、模型调通之后如果你只是偶尔用用那到这就够了。但如果你打算把龙虾当成长期的编码助手或者跑 Agent 任务建议把接入方式再规范一下。TaoToken 的接入文档里有针对不同客户端的配置说明地址是 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 里面把 base_url、鉴权头、模型名的对应关系讲得比较清楚照着改 config.toml 不容易出错。另外如果你后面要在 Claude Code 这类工具里接 Anthropic 通道TaoToken 也有对应的配置页地址是 https://taotoken.net/claudecode-anthropic?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 按页面给的参数填就行。长期跑编码任务的话Coding Plan 页面 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 里有套餐说明可以先看看再决定用哪种。最后说个我踩过的坑win10 和 ubuntu 上即使装同一个版本的龙虾模型配置也有细微差别。ubuntu 上如果用 DeepSeekprovider 要选openai再填 DeepSeek 的 Key因为它是兼容 OpenAI 格式的而 win10 上装的那版配置里可以直接选 DeepSeek 再填 Key。所以别把两个平台的配置文件直接互相拷贝provider 字段对不上会调不通。 win10 手动安装龙虾：用 PowerShell + winget + Node + Git 搭好环境并配 TaoToken
1. win10 手动装龙虾到底卡在哪从 winget 失踪到 PATH 不生效win10 手动安装龙虾OpenClaw这件事说难不难说简单也容易翻车。它本质上是一个跑在 Node.js 上的命令行工具理论上一条安装脚本就能搞定但我在一台只有 8G 内存的老机器上实测脚本跑一半窗口直接闪退连报错都看不到。后来才发现问题根本不在龙虾本身而是 win10 这套环境缺了三样东西Git、Node、以及一个能正常工作的 winget。这篇内容适合谁如果你手上是一台刚装好 win10 的旧电脑或者一台从没配过开发环境的办公机想从零把龙虾跑起来并且希望一次跑通不报错那下面的链路就是为你准备的。核心检索词先摆出来win10 下用 PowerShell winget Node Git 手动搭环境最后在 config.toml 里填入 TaoToken 的统一 Key 和 API 通道。为什么不用一键脚本我试过脚本依赖 NodeNode 没装它就直接退出装了 Node 之后它又要 GitGit 没有又退出等你去装 Git发现 winget 命令根本不存在。这一连串依赖像多米诺骨牌缺一张就全倒。所以更稳的做法是手动把 Git、Node、winget 这三块地基按顺序铺好再让龙虾的安装脚本去跑。这样每一步都能单独验证出错也知道是哪一层的问题。下面所有命令都在 PowerShell 里执行而且建议用管理员身份运行 PowerShell避免权限问题导致安装到一半失败。后面简称 ps。2. 前置准备TaoToken 统一 Key 与 API 通道先拿到手龙虾装好之后要接模型这一步绕不开 API Key。我用的方案是 TaoToken它把多个模型的调用通道统一成一个 Key 和一个 API 地址配置的时候不用为每个模型单独记一套地址对新手比较友好。你需要提前做两件事。第一注册并登录 TaoToken 官网地址是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 进去之后在控制台里创建一个 API Key。第二记住统一的 API 接入地址https://taotoken.net/api 注意这个地址后面不加任何 UTM 参数配置里要填的就是它。创建 Key 的入口在控制台的 API Keys 页面直接访问 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 就能到。生成出来的 Key 一般是一串以 sk- 开头的字符串复制下来先存到记事本里后面写进 config.toml 要用。注意Key 只显示一次页面关掉就看不到了。如果没存就重新生成一个别硬找。如果你后面想先验证模型通不通可以先用模型对话页面发一条测试消息地址是 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。这一步不是必须的但能帮你确认 Key 本身是有效的省得装完龙虾再回头排查是 Key 的问题还是环境的问题。3. 可复制配置winget、Git、Node 三步装齐3.1 先修 winget从 msixbundle 手动装win10 自带的 winget 经常是坏的表现就是winget --version提示「无法被识别为命令」重启 ps、重启系统都没用。我对比过一台正常的机器发现坏掉的机器在C:\Program Files\WindowsApps\Microsoft.DesktopAppInstaller_1.27.470.0_x64__8wekyb3d8bbwe目录下根本没有 winget.exe。这种情况别在商店里折腾了直接手动装。打开浏览器访问 winget-cli 的 releases 页面下载Microsoft.DesktopAppInstaller_8wekyb3d8bbwe.msixbundle这个文件。下载完成后双击安装如果提示缺少依赖就按提示把依赖包也装上。装完之后不要急着验证先把 ps 关掉重开一个管理员窗口再执行winget --version正常的话会输出类似v1.27.470的版本号。如果还是提示无法识别检查一下系统变量 PATH 里有没有%LOCALAPPDATA%\Microsoft\WindowsApps没有就手动加上然后重启 ps。3.2 用 winget 装 Gitwinget 修好之后装 Git 就是一条命令的事winget install --id Git.Git -e --source winget参数说明一下--id Git.Git指定包 ID-e表示精确匹配--source winget强制从 winget 源拉取避免走到别的源导致版本混乱。安装过程会下载几十兆的安装包耐心等它跑完。装完之后必须重启 ps因为 Git 会把路径写进环境变量当前这个 ps 窗口读不到新变量。重启后再验证git --version输出git version 2.x.x就说明 Git 到位了。3.3 装 Node.jsNode 我建议直接去官网下载 msi 安装包比用 winget 装更可控。访问 nodejs.org 的中文下载页选 LTS 版本下载.msi文件后双击运行。安装过程中会有一个「是否安装附加工具」的勾选项我勾上了它会顺带装上 Python 和一堆编译工具后面如果龙虾有原生模块要编译就不会卡住。安装完成后同样重启 ps然后验证两个命令node -v npm -v两个都有版本号输出Node 环境就算搭好了。到这里Git、Node、winget 三块地基全部就位。4. 装龙虾并验证从 install.ps1 到 config.toml 填 TaoToken4.1 跑安装脚本环境齐了之后龙虾的安装脚本就不会再因为缺依赖而闪退了。在管理员 ps 里执行iwr -useb https://openclaw.ai/install.ps1 | iex这条命令用iwrInvoke-WebRequest拉取脚本内容再用iexInvoke-Expression执行。实测下来这一步会比较慢而且没有下载进度提示看起来像卡住了其实是在下载别急着关窗口。如果等了很久实在没动静可以换国内镜像脚本iwr -useb https://open-claw.org.cn/install-cn.ps1 | iex安装完成后脚本一般会自动启动配置程序。配置流程网上教程很多这里不展开重点说 config.toml 里怎么填 TaoToken。4.2 config.toml 骨架与 TaoToken 配置片段龙虾的配置文件通常位于用户目录下的.openclaw/config.toml具体路径以安装脚本提示为准。用记事本或 VS Code 打开骨架大概长这样关键是[model]这一段# OpenClaw 配置文件 [model] provider openai api_key sk-你的TaoToken密钥 base_url https://taotoken.net/api model_name gpt-4o [agent] name my-claw workspace C:\\Users\\你的用户名\\claw-workspace几个参数对照着填参数填什么说明provideropenaiTaoToken 兼容 OpenAI 格式统一走这个api_keysk-开头的那串从 TaoToken 控制台复制base_urlhttps://taotoken.net/api统一 API 通道不加 UTMmodel_name你要用的模型名按 TaoToken 文档里支持的模型填注意base_url 结尾不要多加斜杠也不要带任何查询参数就填https://taotoken.net/api这一串。填完保存关掉配置文件。4.3 验证安装与配置回到 ps先验证龙虾本体openclaw --version有版本号输出说明安装成功。如果提示「不是可识别的命令」多半是环境变量没生效先重启 ps还不行就升级到最新版npm install -g openclawlatest然后验证配置能不能真正调通模型。在 ps 里启动龙虾的交互模式发一条测试消息比如「你好报一下你的模型名」。如果返回正常内容说明 TaoToken 的 Key 和 API 通道都通了。这一步是整个链路里最关键的验证前面所有环境准备都是为了这一刻。5. 本篇常见错排查winget 失踪、PATH 不生效、命令找不到winget 装了但命令找不到。最常见的原因是C:\Program Files\WindowsApps\Microsoft.DesktopAppInstaller_...目录下没有 winget.exe说明装的是个空壳。解决办法就是回到 3.1用 msixbundle 手动装一遍别依赖商店。git 或 node 装完当前 ps 用不了。这是环境变量没刷新当前 ps 窗口读的是启动时的旧变量。关掉窗口重开一个管理员 ps 就行不用重启系统。openclaw 提示不是可识别的命令。先重启 ps再不行就npm install -g openclawlatest升级。旧版本在 win10 上确实有环境变量注册不全的问题升级到较新版本能解决。配置填完还是调不通模型。按顺序查三样Key 是不是复制全了sk- 开头那串别漏字符、base_url 是不是https://taotoken.net/api、provider 是不是openai。这三样任意一个错都会导致请求失败。如果还不行去 TaoToken 的模型对话页面用同一个 Key 发条消息能通说明 Key 没问题问题在 config.toml 的格式上比如 TOML 的引号或缩进写错了。安装脚本跑一半窗口闪退。这基本就是缺 Node 或 Git 导致的脚本遇到缺失依赖直接退出来不及显示报错。按本文顺序先把 Git、Node、winget 装好再跑脚本就不会闪退。6. 后续怎么走长期编码与 Agent 场景的接入建议环境搭好、模型调通之后如果你只是偶尔用用那到这就够了。但如果你打算把龙虾当成长期的编码助手或者跑 Agent 任务建议把接入方式再规范一下。TaoToken 的接入文档里有针对不同客户端的配置说明地址是 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 里面把 base_url、鉴权头、模型名的对应关系讲得比较清楚照着改 config.toml 不容易出错。另外如果你后面要在 Claude Code 这类工具里接 Anthropic 通道TaoToken 也有对应的配置页地址是 https://taotoken.net/claudecode-anthropic?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 按页面给的参数填就行。长期跑编码任务的话Coding Plan 页面 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 里有套餐说明可以先看看再决定用哪种。最后说个我踩过的坑win10 和 ubuntu 上即使装同一个版本的龙虾模型配置也有细微差别。ubuntu 上如果用 DeepSeekprovider 要选openai再填 DeepSeek 的 Key因为它是兼容 OpenAI 格式的而 win10 上装的那版配置里可以直接选 DeepSeek 再填 Key。所以别把两个平台的配置文件直接互相拷贝provider 字段对不上会调不通。