1. 为什么 Win10 装 OpenClaw 小龙虾总卡在第一步OpenClaw 小龙虾是一个跑在本地、能直接操控你 Win10 电脑的 AI 智能体。它和网页版聊天 AI 最大的区别在于它能跨软件动手干活——整理文件夹、批量处理 Excel、给企业微信群发通知、批量重命名文件而且所有数据都在你本机运行不上传公司文件。适合每天被重复性办公任务占满时间的 Win10 用户尤其是公司电脑有权限管控、又不想把工作文件传到云端的职场人。但我在帮同事装的过程中发现Win10 一键安装这件事真正卡人的从来不是「点下一步」而是三个地方安装包解压方式不对导致文件缺失、公司安全机制拦截未签名程序、以及装完之后模型通道没配好导致 Gateway 一直离线。前两个是系统层面的坑第三个是接入层面的坑而第三个恰恰是很多人忽略的——OpenClaw 本身只是个执行框架它需要一个大模型 API 通道才能真正「思考」这一步没配好装得再顺也只是一个空壳。这篇教程按「拿安装包 → 解压 → 绕过拦截 → 配置模型通道 → 验证 Gateway 在线」的完整链路走一遍每一步都给可复制的命令和配置片段。模型接入部分我用 TaoToken 统一 Key/API 通道来打通这样你不需要在多个平台之间来回切换一个 Key 就能覆盖 OpenClaw 需要的模型调用。下面直接开始。2. 安装前的环境准备与 TaoToken 通道前置在动手装 OpenClaw 之前有两件事必须先确认否则后面大概率会返工。第一件事是 Win10 环境本身。OpenClaw v2.7.9 对系统版本有最低要求建议 Win10 1809 及以上。你可以按Win R输入winver回车弹窗里会显示当前版本号。如果低于 1809先去 Windows 更新里升级。另外确认安装盘预留 4GB 以上空间安装包本身只有 45.8MB但解压后加上运行依赖会膨胀到 1GB 左右初始化时还会写缓存。第二件事是模型通道。OpenClaw 启动后需要调用大模型来完成指令理解如果你不提前准备好 API 通道第一次启动就会卡在「Gateway 离线」。这里我用 TaoToken 来做统一接入原因是它把模型调用收敛成一个 Base URL 一个 Key 的形式OpenClaw 的配置文件里只需要填这两项加一个 Model ID不用管底层是哪家模型。先去 TaoToken 控制台创建一个 API Key。打开 https://taotoken.net/api-keys 登录后点「创建密钥」复制生成的 Key形如sk-xxxxxxxx。这个 Key 只显示一次先粘到记事本里存着。然后确认你要用的模型 ID。OpenClaw 默认走对话补全接口常用的模型 ID 可以在 https://taotoken.net/doc 的模型列表里查。记下你选的那个 ID比如gpt-4o或claude-3-5-sonnet这类后面写配置文件要用。注意TaoToken 的 API 基础地址是https://taotoken.net/api这个地址不带任何查询参数直接填到配置里即可。控制台和文档地址是分开的别混用。到这里前置准备就完成了一个 Key、一个 Base URL、一个 Model ID。这三样东西就是后面配置 OpenClaw 的全部输入。如果你还没注册可以先到 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 了解一下整体能力再回来继续。3. 可复制的 OpenClaw 安装与模型配置片段这一步是整篇的核心我会把安装动作和配置片段拆开写你可以直接复制。3.1 下载与解压安装包OpenClaw v2.7.9 的 Win10 安装包下载后是一个 zip 文件。下载完成后不要用 Win10 自带的解压工具它处理大文件时容易丢文件。用 7-Zip 或 WinRAR右键压缩包选「解压到当前文件夹」。解压完成后进入Openclaw-win文件夹你应该能看到一个红色龙虾图标的启动程序。如果没看到说明解压不完整重新解压一次。切记绝对不要在压缩包内直接双击启动程序100% 会触发权限报错。必须先完整解压。3.2 绕过 Win10 安全拦截双击红色龙虾图标如果弹出「Windows 已保护你的电脑」点左下角「更多信息」再点「仍要运行」。这是 Win10 对未签名程序的正常防护不是病毒。如果不想每次都弹右键程序 →「属性」→「常规」→ 勾选「解除锁定」→ 确定。这样后续启动就不会再拦。3.3 写入模型通道配置OpenClaw 的模型配置放在安装目录下的config文件夹里文件名是settings.json。如果你在安装引导里选了D:\Tools\OpenClaw那完整路径就是D:\Tools\OpenClaw\config\settings.json。用记事本或 VS Code 打开这个文件把下面这段 JSON 粘进去替换掉里面的占位值{ gateway: { host: 127.0.0.1, port: 8765 }, model: { provider: openai-compatible, base_url: https://taotoken.net/api, api_key: sk-你的TaoToken密钥, model_id: gpt-4o, timeout: 60 }, workspace: D:\\OpenClawWorkspace, log_level: info }几个关键点说明一下。base_url填https://taotoken.net/api注意结尾没有斜杠。api_key换成你刚才在控制台创建的那串sk-开头的密钥。model_id换成你在文档里查到的模型 ID。workspace是 OpenClaw 的工作目录建议单独建一个纯英文路径的文件夹不要放在 C 盘或公司加密盘。如果你更习惯用 TOML 格式OpenClaw 也支持settings.toml等价写法如下[gateway] host 127.0.0.1 port 8765 [model] provider openai-compatible base_url https://taotoken.net/api api_key sk-你的TaoToken密钥 model_id gpt-4o timeout 60 workspace D:\\OpenClawWorkspace log_level info两种格式选一种即可不要同时存在否则 OpenClaw 会优先读 JSON 而忽略 TOML。3.4 环境变量补充配置有些情况下 OpenClaw 会从环境变量读取 Key尤其是你后续要用命令行方式调用时。按Win R输入sysdm.cpl进「高级」→「环境变量」在用户变量里新建一条变量名TAOTOKEN_API_KEY变量值填你的sk-密钥。再新建一条TAOTOKEN_BASE_URL值填https://taotoken.net/api。保存后重启一次命令行窗口让变量生效。这样即使配置文件里的 Key 被误改环境变量还能兜底。4. 启动验证与首次调用成功结果配置写完后回到Openclaw-win文件夹右键红色龙虾图标选「以管理员身份运行」。第一次启动会初始化服务等待 1 到 3 分钟右上角状态从「初始化中」变成「Gateway 在线」就说明部署成功了。如果 Gateway 一直显示离线先别急着重装按下面的顺序排查。4.1 用 curl 验证模型通道是否通在启动 OpenClaw 之前你可以先用命令行单独验证 TaoToken 通道是否可用。打开 PowerShell执行curl -X POST https://taotoken.net/api/v1/chat/completions ^ -H Authorization: Bearer sk-你的TaoToken密钥 ^ -H Content-Type: application/json ^ -d {\model\:\gpt-4o\,\messages\:[{\role\:\user\,\content\:\ping\}]}如果返回里包含choices字段和一段回复内容说明 Key、Base URL、Model ID 三件套都是对的。如果返回 401说明 Key 错了或没生效如果返回model not found说明 Model ID 写错了。4.2 在 OpenClaw 里发第一条指令Gateway 在线后直接在 OpenClaw 的对话框里输入一条测试指令比如「帮我在 D:\OpenClawWorkspace 下新建一个 test 文件夹然后在里面创建一个 hello.txt内容写 OpenClaw 安装成功」如果 OpenClaw 回复执行成功并且你去文件夹里能看到hello.txt说明整条链路——从指令理解到模型调用再到本地文件操作——全部打通了。4.3 验证结果对照表检查项期望结果异常表现Gateway 状态右上角显示「Gateway 在线」一直「初始化中」或「离线」curl 测试返回含 choices 的 JSON401 或 model not found文件操作test 文件夹和 hello.txt 存在指令无响应或报权限错误日志文件logs/app.log无 ERROR出现 connection refused5. 常见报错排查401、local proxy failed 与 OAuth这一节把我在 Win10 上实际遇到过的报错整理出来每条都给对应的解决动作。5.1 401 Unauthorized这是最常见的报错出现在 curl 测试或 OpenClaw 启动日志里。原因有三个Key 复制时带了空格、Key 已过期或被删除、配置文件里的api_key字段名写错。解决动作回到 https://taotoken.net/api-keys 重新创建一个 Key复制时注意不要带首尾空格。然后检查settings.json里字段名是不是api_key不是apikey也不是api-key。改完保存重启 OpenClaw。5.2 local proxy failed这个报错通常出现在 OpenClaw 启动日志里意思是本地代理端口被占用。OpenClaw 默认用 8765 端口做本地 Gateway如果这个端口被其他程序占了就会报local proxy failed。解决动作打开 PowerShell执行netstat -ano | findstr 8765看有没有进程占用。如果有记下 PID用taskkill /PID 进程号 /F结束它。或者直接改settings.json里的gateway.port换成 8766 或 8767重启即可。5.3 reading choices 报错这个报错说明模型返回的 JSON 结构里没有choices字段通常是 Base URL 写错了。比如你把https://taotoken.net/api写成了https://taotoken.net/api/v1多了一层路径导致请求打到了错误的端点。解决动作确认base_url就是https://taotoken.net/api不要加/v1OpenClaw 内部会自动拼接完整路径。改完重启。5.4 OAuth 相关报错如果你在配置里误开了 OAuth 模式OpenClaw 会尝试走浏览器授权流程但 Win10 办公环境往往弹不出浏览器或回调失败报OAuth callback failed。解决动作OpenClaw 走 TaoToken 通道时不需要 OAuth用的是 API Key 模式。检查settings.json里provider是不是openai-compatible如果是oauth就改回来。同时确认没有多余的oauth_token字段。5.5 三件套检查清单任何模型调用类报错先按这个清单过一遍Base URLhttps://taotoken.net/api无尾斜杠、无/v1API Keysk-开头无空格未过期Model ID与文档列表一致大小写敏感这三项任意一项错了都会表现为「连不上」或「返回异常」。排查时优先用 4.1 的 curl 命令单独验证能快速定位是通道问题还是 OpenClaw 配置问题。6. 装完之后把 OpenClaw 用起来的接入建议安装和验证都通过后OpenClaw 就算真正跑起来了。但要让它在日常办公里持续发挥作用还有几个接入层面的建议。第一把 TaoToken 的 Key 当成统一入口来管理。OpenClaw 只是你本地的一个执行端后续如果你还接了其他工具——比如用 Cline 做代码辅助、用 Claude Code 做终端操作——都可以复用同一个 Base URL 和 Key。这样你只需要在 TaoToken 控制台维护一份密钥不用每个工具单独配一遍。控制台地址是 https://taotoken.net/console 密钥管理在 https://taotoken.net/api-keys 。第二如果你打算长期用 OpenClaw 跑自动化任务比如每天定时整理文件夹、汇总数据建议了解一下 Coding Plan 这类长期方案地址是 https://taotoken.net/coding-plan 。它比按次调用更适合高频场景成本也更可控。第三模型 ID 不要写死一个。OpenClaw 的settings.json里model_id可以随时改你可以根据任务类型切换——简单整理用轻量模型复杂数据分析用能力更强的模型。切换时只改这一个字段重启 OpenClaw 即可生效不用动其他配置。第四遇到接入类问题优先查文档而不是重装。OpenClaw 的安装本身是一次性的装好之后 90% 的问题都出在模型通道配置上。文档地址 https://taotoken.net/doc 里有完整的接口说明和模型列表比在群里问快得多。最后说一个我踩过的坑公司电脑的杀毒软件会在 OpenClaw 启动时扫描它的运行文件偶尔会误删gateway.exe。解决办法是把 OpenClaw 安装目录加到杀毒软件的白名单里而不是每次被删了重装。加白名单的位置一般在杀毒软件的「设置」→「信任区」或「排除项」里把整个Openclaw-win文件夹加进去就行。这样后续启动就不会再被拦Gateway 也能稳定在线。
【亲测无坑】OpenClaw 小龙虾 Win10 一键安装教程（包含安装包）
1. 为什么 Win10 装 OpenClaw 小龙虾总卡在第一步OpenClaw 小龙虾是一个跑在本地、能直接操控你 Win10 电脑的 AI 智能体。它和网页版聊天 AI 最大的区别在于它能跨软件动手干活——整理文件夹、批量处理 Excel、给企业微信群发通知、批量重命名文件而且所有数据都在你本机运行不上传公司文件。适合每天被重复性办公任务占满时间的 Win10 用户尤其是公司电脑有权限管控、又不想把工作文件传到云端的职场人。但我在帮同事装的过程中发现Win10 一键安装这件事真正卡人的从来不是「点下一步」而是三个地方安装包解压方式不对导致文件缺失、公司安全机制拦截未签名程序、以及装完之后模型通道没配好导致 Gateway 一直离线。前两个是系统层面的坑第三个是接入层面的坑而第三个恰恰是很多人忽略的——OpenClaw 本身只是个执行框架它需要一个大模型 API 通道才能真正「思考」这一步没配好装得再顺也只是一个空壳。这篇教程按「拿安装包 → 解压 → 绕过拦截 → 配置模型通道 → 验证 Gateway 在线」的完整链路走一遍每一步都给可复制的命令和配置片段。模型接入部分我用 TaoToken 统一 Key/API 通道来打通这样你不需要在多个平台之间来回切换一个 Key 就能覆盖 OpenClaw 需要的模型调用。下面直接开始。2. 安装前的环境准备与 TaoToken 通道前置在动手装 OpenClaw 之前有两件事必须先确认否则后面大概率会返工。第一件事是 Win10 环境本身。OpenClaw v2.7.9 对系统版本有最低要求建议 Win10 1809 及以上。你可以按Win R输入winver回车弹窗里会显示当前版本号。如果低于 1809先去 Windows 更新里升级。另外确认安装盘预留 4GB 以上空间安装包本身只有 45.8MB但解压后加上运行依赖会膨胀到 1GB 左右初始化时还会写缓存。第二件事是模型通道。OpenClaw 启动后需要调用大模型来完成指令理解如果你不提前准备好 API 通道第一次启动就会卡在「Gateway 离线」。这里我用 TaoToken 来做统一接入原因是它把模型调用收敛成一个 Base URL 一个 Key 的形式OpenClaw 的配置文件里只需要填这两项加一个 Model ID不用管底层是哪家模型。先去 TaoToken 控制台创建一个 API Key。打开 https://taotoken.net/api-keys 登录后点「创建密钥」复制生成的 Key形如sk-xxxxxxxx。这个 Key 只显示一次先粘到记事本里存着。然后确认你要用的模型 ID。OpenClaw 默认走对话补全接口常用的模型 ID 可以在 https://taotoken.net/doc 的模型列表里查。记下你选的那个 ID比如gpt-4o或claude-3-5-sonnet这类后面写配置文件要用。注意TaoToken 的 API 基础地址是https://taotoken.net/api这个地址不带任何查询参数直接填到配置里即可。控制台和文档地址是分开的别混用。到这里前置准备就完成了一个 Key、一个 Base URL、一个 Model ID。这三样东西就是后面配置 OpenClaw 的全部输入。如果你还没注册可以先到 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 了解一下整体能力再回来继续。3. 可复制的 OpenClaw 安装与模型配置片段这一步是整篇的核心我会把安装动作和配置片段拆开写你可以直接复制。3.1 下载与解压安装包OpenClaw v2.7.9 的 Win10 安装包下载后是一个 zip 文件。下载完成后不要用 Win10 自带的解压工具它处理大文件时容易丢文件。用 7-Zip 或 WinRAR右键压缩包选「解压到当前文件夹」。解压完成后进入Openclaw-win文件夹你应该能看到一个红色龙虾图标的启动程序。如果没看到说明解压不完整重新解压一次。切记绝对不要在压缩包内直接双击启动程序100% 会触发权限报错。必须先完整解压。3.2 绕过 Win10 安全拦截双击红色龙虾图标如果弹出「Windows 已保护你的电脑」点左下角「更多信息」再点「仍要运行」。这是 Win10 对未签名程序的正常防护不是病毒。如果不想每次都弹右键程序 →「属性」→「常规」→ 勾选「解除锁定」→ 确定。这样后续启动就不会再拦。3.3 写入模型通道配置OpenClaw 的模型配置放在安装目录下的config文件夹里文件名是settings.json。如果你在安装引导里选了D:\Tools\OpenClaw那完整路径就是D:\Tools\OpenClaw\config\settings.json。用记事本或 VS Code 打开这个文件把下面这段 JSON 粘进去替换掉里面的占位值{ gateway: { host: 127.0.0.1, port: 8765 }, model: { provider: openai-compatible, base_url: https://taotoken.net/api, api_key: sk-你的TaoToken密钥, model_id: gpt-4o, timeout: 60 }, workspace: D:\\OpenClawWorkspace, log_level: info }几个关键点说明一下。base_url填https://taotoken.net/api注意结尾没有斜杠。api_key换成你刚才在控制台创建的那串sk-开头的密钥。model_id换成你在文档里查到的模型 ID。workspace是 OpenClaw 的工作目录建议单独建一个纯英文路径的文件夹不要放在 C 盘或公司加密盘。如果你更习惯用 TOML 格式OpenClaw 也支持settings.toml等价写法如下[gateway] host 127.0.0.1 port 8765 [model] provider openai-compatible base_url https://taotoken.net/api api_key sk-你的TaoToken密钥 model_id gpt-4o timeout 60 workspace D:\\OpenClawWorkspace log_level info两种格式选一种即可不要同时存在否则 OpenClaw 会优先读 JSON 而忽略 TOML。3.4 环境变量补充配置有些情况下 OpenClaw 会从环境变量读取 Key尤其是你后续要用命令行方式调用时。按Win R输入sysdm.cpl进「高级」→「环境变量」在用户变量里新建一条变量名TAOTOKEN_API_KEY变量值填你的sk-密钥。再新建一条TAOTOKEN_BASE_URL值填https://taotoken.net/api。保存后重启一次命令行窗口让变量生效。这样即使配置文件里的 Key 被误改环境变量还能兜底。4. 启动验证与首次调用成功结果配置写完后回到Openclaw-win文件夹右键红色龙虾图标选「以管理员身份运行」。第一次启动会初始化服务等待 1 到 3 分钟右上角状态从「初始化中」变成「Gateway 在线」就说明部署成功了。如果 Gateway 一直显示离线先别急着重装按下面的顺序排查。4.1 用 curl 验证模型通道是否通在启动 OpenClaw 之前你可以先用命令行单独验证 TaoToken 通道是否可用。打开 PowerShell执行curl -X POST https://taotoken.net/api/v1/chat/completions ^ -H Authorization: Bearer sk-你的TaoToken密钥 ^ -H Content-Type: application/json ^ -d {\model\:\gpt-4o\,\messages\:[{\role\:\user\,\content\:\ping\}]}如果返回里包含choices字段和一段回复内容说明 Key、Base URL、Model ID 三件套都是对的。如果返回 401说明 Key 错了或没生效如果返回model not found说明 Model ID 写错了。4.2 在 OpenClaw 里发第一条指令Gateway 在线后直接在 OpenClaw 的对话框里输入一条测试指令比如「帮我在 D:\OpenClawWorkspace 下新建一个 test 文件夹然后在里面创建一个 hello.txt内容写 OpenClaw 安装成功」如果 OpenClaw 回复执行成功并且你去文件夹里能看到hello.txt说明整条链路——从指令理解到模型调用再到本地文件操作——全部打通了。4.3 验证结果对照表检查项期望结果异常表现Gateway 状态右上角显示「Gateway 在线」一直「初始化中」或「离线」curl 测试返回含 choices 的 JSON401 或 model not found文件操作test 文件夹和 hello.txt 存在指令无响应或报权限错误日志文件logs/app.log无 ERROR出现 connection refused5. 常见报错排查401、local proxy failed 与 OAuth这一节把我在 Win10 上实际遇到过的报错整理出来每条都给对应的解决动作。5.1 401 Unauthorized这是最常见的报错出现在 curl 测试或 OpenClaw 启动日志里。原因有三个Key 复制时带了空格、Key 已过期或被删除、配置文件里的api_key字段名写错。解决动作回到 https://taotoken.net/api-keys 重新创建一个 Key复制时注意不要带首尾空格。然后检查settings.json里字段名是不是api_key不是apikey也不是api-key。改完保存重启 OpenClaw。5.2 local proxy failed这个报错通常出现在 OpenClaw 启动日志里意思是本地代理端口被占用。OpenClaw 默认用 8765 端口做本地 Gateway如果这个端口被其他程序占了就会报local proxy failed。解决动作打开 PowerShell执行netstat -ano | findstr 8765看有没有进程占用。如果有记下 PID用taskkill /PID 进程号 /F结束它。或者直接改settings.json里的gateway.port换成 8766 或 8767重启即可。5.3 reading choices 报错这个报错说明模型返回的 JSON 结构里没有choices字段通常是 Base URL 写错了。比如你把https://taotoken.net/api写成了https://taotoken.net/api/v1多了一层路径导致请求打到了错误的端点。解决动作确认base_url就是https://taotoken.net/api不要加/v1OpenClaw 内部会自动拼接完整路径。改完重启。5.4 OAuth 相关报错如果你在配置里误开了 OAuth 模式OpenClaw 会尝试走浏览器授权流程但 Win10 办公环境往往弹不出浏览器或回调失败报OAuth callback failed。解决动作OpenClaw 走 TaoToken 通道时不需要 OAuth用的是 API Key 模式。检查settings.json里provider是不是openai-compatible如果是oauth就改回来。同时确认没有多余的oauth_token字段。5.5 三件套检查清单任何模型调用类报错先按这个清单过一遍Base URLhttps://taotoken.net/api无尾斜杠、无/v1API Keysk-开头无空格未过期Model ID与文档列表一致大小写敏感这三项任意一项错了都会表现为「连不上」或「返回异常」。排查时优先用 4.1 的 curl 命令单独验证能快速定位是通道问题还是 OpenClaw 配置问题。6. 装完之后把 OpenClaw 用起来的接入建议安装和验证都通过后OpenClaw 就算真正跑起来了。但要让它在日常办公里持续发挥作用还有几个接入层面的建议。第一把 TaoToken 的 Key 当成统一入口来管理。OpenClaw 只是你本地的一个执行端后续如果你还接了其他工具——比如用 Cline 做代码辅助、用 Claude Code 做终端操作——都可以复用同一个 Base URL 和 Key。这样你只需要在 TaoToken 控制台维护一份密钥不用每个工具单独配一遍。控制台地址是 https://taotoken.net/console 密钥管理在 https://taotoken.net/api-keys 。第二如果你打算长期用 OpenClaw 跑自动化任务比如每天定时整理文件夹、汇总数据建议了解一下 Coding Plan 这类长期方案地址是 https://taotoken.net/coding-plan 。它比按次调用更适合高频场景成本也更可控。第三模型 ID 不要写死一个。OpenClaw 的settings.json里model_id可以随时改你可以根据任务类型切换——简单整理用轻量模型复杂数据分析用能力更强的模型。切换时只改这一个字段重启 OpenClaw 即可生效不用动其他配置。第四遇到接入类问题优先查文档而不是重装。OpenClaw 的安装本身是一次性的装好之后 90% 的问题都出在模型通道配置上。文档地址 https://taotoken.net/doc 里有完整的接口说明和模型列表比在群里问快得多。最后说一个我踩过的坑公司电脑的杀毒软件会在 OpenClaw 启动时扫描它的运行文件偶尔会误删gateway.exe。解决办法是把 OpenClaw 安装目录加到杀毒软件的白名单里而不是每次被删了重装。加白名单的位置一般在杀毒软件的「设置」→「信任区」或「排除项」里把整个Openclaw-win文件夹加进去就行。这样后续启动就不会再被拦Gateway 也能稳定在线。
