1. 为什么 Windows 上跑 OpenClaw 小龙虾卡住的多半是配置而不是安装OpenClaw 小龙虾是一个能在本地操控电脑的开源 AI 智能体说人话就是你用自然语言下指令它自己拆任务、调工具、动手干活。适合谁适合不想写代码、又想在自己 Windows 电脑上养一个“数字员工”的人。但我在 Windows 上帮人排障时发现真正让人卡住的往往不是解压和启动而是启动之后那一步——模型通道没接上Gateway 显示在线发指令却一直转圈或者报错。原因很简单一键包把运行环境、依赖、浏览器控制工具都打包好了解压即用没问题但它默认的模型通道要么是空的要么指向一个你根本没配好的地址。OpenClaw 本身只是个“调度大脑”真正干活的是背后的大模型。你不给它一个能用的 API 通道它就是个空壳。所以这篇教程的重点不是重复“双击 exe、点下一步”而是把 settings 配置文件改到 TaoToken让请求链路真正跑通。我会从解压讲到首次启动再重点交付可复制的 settings 片段和验证步骤。全程 Windows 10/11 64 位纯英文路径不需要命令行基础。先明确一个概念OpenClaw 的 settings 文件是它的“总控台”里面写着用哪个模型、走哪个 API 地址、用哪把 Key。你把它改对了小龙虾才真正活过来。下面按顺序来每一步都能跟做。2. TaoToken 前置准备拿到 Base URL、API Key 和 Model ID 三件套在改 settings 之前你得先有三样东西Base URL、API Key、Model ID。这三件套缺一不可后面配置里会一一对应。TaoToken 的官网入口是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 地址是 https://taotoken.net/api 这个不加 UTM直接用于配置。第一步打开官网注册并登录。登录后进控制台地址是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 。控制台里能看到你的账户信息和用量。第二步创建 API Key。进 API Keys 页面https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。点“创建新 Key”复制出来。注意Key 只在创建时完整显示一次关掉就看不到了所以先粘到记事本里存好。格式一般是一长串字符别弄丢。第三步确认 Model ID。TaoToken 支持多种模型你在模型对话页面能看到可用列表https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite 。选一个你打算用的比如常见的对话模型把它的 Model ID 记下来。这个 ID 要原样填进 settings大小写和连字符都不能错。三件套汇总一下项目值用途Base URLhttps://taotoken.net/api请求发往哪里API Key控制台创建的那串字符身份验证Model ID模型对话页看到的标识指定用哪个模型如果你后面打算长期跑编码类或 Agent 类任务可以了解下 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 。不过本篇先聚焦把基础通道跑通。注意API Key 属于敏感凭证不要截图发群、不要提交到公开仓库。settings 文件里填了 Key 之后也别把这个文件随手分享出去。拿到三件套后先别急着关浏览器后面验证请求时还要回来对照。接下来进入解压和启动环节。3. 解压即用 settings 配置把通道指向 TaoToken 的完整片段先说解压。下载完 OpenClaw Windows 一键部署包约 361MB后得到一个 zip。这里有个坑别用 Windows 自带的解压容易损坏文件。用 7-Zip 或 WinRAR右键选“解压到当前文件夹”等 1-2 分钟生成 Openclaw-win 文件夹。解压前务必彻底关闭 360、腾讯电脑管家、火绒等杀毒软件。OpenClaw 要模拟键鼠、读写文件会被误报拦截导致核心文件被删。关掉后再解压、再运行这是前提。进入 Openclaw-win 文件夹找到红色龙虾图标的“Openclaw Windows一键启动.exe”双击。如果弹出“Windows 已保护你的电脑”点“更多信息”→“仍要运行”。然后点欢迎界面的“开始使用”。安装路径必须是纯英文不能有中文、空格、特殊字符。推荐 D:\OpenClaw别用 D:\软件\OpenClaw 或 D:\小龙虾。勾选协议点“开始安装”等 3-5 分钟自动部署。首次启动 Gateway 初始化要等 1-3 分钟正常现象。重点来了部署完成后找到 settings 配置文件。它一般在安装目录下的 config 文件夹里文件名可能是 settings.json 或 settings.toml。用记事本或 VS Code 打开。下面给你一份可复制的 JSON 片段路径和字段名按你实际文件为准把三件套填进去{ gateway: { host: 127.0.0.1, port: 18789, autoStart: true }, model: { provider: openai-compatible, baseUrl: https://taotoken.net/api, apiKey: sk-你的TaoToken密钥, modelId: 你的Model ID, timeout: 60000 }, agent: { maxSteps: 20, language: zh-CN } }如果你拿到的是 TOML 格式等价写法如下[gateway] host 127.0.0.1 port 18789 autoStart true [model] provider openai-compatible baseUrl https://taotoken.net/api apiKey sk-你的TaoToken密钥 modelId 你的Model ID timeout 60000 [agent] maxSteps 20 language zh-CN三个关键字段对照baseUrl 填 https://taotoken.net/api apiKey 填你创建的那串modelId 填模型对话页看到的标识。provider 保持 openai-compatible 即可TaoToken 走的是兼容协议。改完保存关掉文件。回到 OpenClaw 主界面点右上角“重启”让配置生效。这一步不做改了也白改。提示如果你用的是 Cline MCP 或 Claude Code 这类工具接 OpenClaw同样要保证 Base URL、Key、Model ID 三件套齐全缺一个就连不上。CC Switch 切换配置时也检查这三项。配置写好后别急着发复杂指令先做一次最小验证。4. 验证请求链路从 Gateway 在线到第一条指令跑通配置改完重启后看主界面右上角是否显示“Gateway在线”。在线只代表本地服务起来了不代表模型通道通了。真正的验证是发一条指令看它能不能拿到模型返回。先做最简单的验证在底部输入框发一句“你好请回复你的模型名称”。如果几秒内返回内容说明请求链路通了。如果一直转圈或报错往下看第 5 节的排障。更严谨的验证方式是用 curl 直接打 TaoToken 的接口确认 Key 和 Model ID 本身没问题。打开 PowerShell执行curl -X POST https://taotoken.net/api/v1/chat/completions ^ -H Content-Type: application/json ^ -H Authorization: Bearer sk-你的TaoToken密钥 ^ -d {\model\:\你的Model ID\,\messages\:[{\role\:\user\,\content\:\ping\}]}注意 Windows PowerShell 里换行符是 ^如果你用 Git Bash 就换成 \。返回里如果有 choices 字段和内容说明三件套正确。这一步能排除是 OpenClaw 配置问题还是 Key 本身问题。回到 OpenClaw发一条实际任务指令测试比如“帮我在桌面新建一个 test 文件夹”。观察它是否拆解步骤、调用工具、执行完成。成功的话你会看到它一步步操作最后桌面出现文件夹。如果返回内容里出现“reading choices”相关报错通常是返回结构解析问题检查 modelId 是否写错或者 baseUrl 末尾多了斜杠。正确写法是 https://taotoken.net/api 不要写成 https://taotoken.net/api/ 。验证通过后你就可以正常用了。内置的免费额度可以先体验基础功能。下面把常见报错集中排一遍。5. 常见报错排查401、local proxy failed、reading choices、OAuth这一节按真实报错来遇到哪个查哪个。401 UnauthorizedKey 错了或没生效。检查三件事apiKey 是否完整复制有没有漏字符、Key 是否已过期或被删、Authorization 头格式是否是 Bearer 加空格加 Key。改完 settings 记得重启 Gateway。local proxy failed本地代理失败。多半是端口被占用或 Gateway 没起来。检查 settings 里 port 18789 是否被别的程序占用换个端口试试。也可能是杀毒软件还在后台拦截彻底关掉再重启 OpenClaw。reading choices 报错返回结构解析失败。常见原因是 modelId 写错或者 baseUrl 指向了错误的路径。确认 baseUrl 是 https://taotoken.net/api modelId 和模型对话页完全一致。如果用的是 TOML检查引号有没有漏。OAuth 相关报错如果你在配置里误开了 OAuth 模式而 TaoToken 走的是 API Key 模式就会冲突。把 provider 改成 openai-compatible认证方式改成 apiKey不要用 OAuth。Gateway 一直离线先确认杀毒软件彻底关闭、安装路径纯英文。然后点右上角“重启”。还不行就关掉 OpenClaw重新运行一键启动.exe 再部署一次。首次启动特别慢正常。首次要初始化依赖等 1-3 分钟后续秒开。排障时有个通用思路先用第 4 节的 curl 确认三件套本身没问题再回头查 OpenClaw 的 settings。这样能快速定位是凭证问题还是配置问题。6. 跑通之后把小龙虾用起来的几个实用方向链路通了接下来就是怎么用。给你几个直接能复制的指令方向整理下载文件夹图片按日期分类、打开浏览器搜索并整理成表格、遍历桌面 Word 提取标题生成汇总。指令越具体执行越准。如果你要长期跑编码或 Agent 任务可以看 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 遇到配置细节可以对照。模型对话页 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite 可以随时验证模型是否正常。API Keys 管理在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。最后提醒一句settings 文件改完后备份一份下次换机器直接复制省得重新配。Key 泄露了就立刻去控制台删掉重建。把这三件套管好你的小龙虾就能稳定干活了。
1. 为什么 Windows 上跑 OpenClaw 小龙虾卡住的多半是配置而不是安装OpenClaw 小龙虾是一个能在本地操控电脑的开源 AI 智能体说人话就是你用自然语言下指令它自己拆任务、调工具、动手干活。适合谁适合不想写代码、又想在自己 Windows 电脑上养一个“数字员工”的人。但我在 Windows 上帮人排障时发现真正让人卡住的往往不是解压和启动而是启动之后那一步——模型通道没接上Gateway 显示在线发指令却一直转圈或者报错。原因很简单一键包把运行环境、依赖、浏览器控制工具都打包好了解压即用没问题但它默认的模型通道要么是空的要么指向一个你根本没配好的地址。OpenClaw 本身只是个“调度大脑”真正干活的是背后的大模型。你不给它一个能用的 API 通道它就是个空壳。所以这篇教程的重点不是重复“双击 exe、点下一步”而是把 settings 配置文件改到 TaoToken让请求链路真正跑通。我会从解压讲到首次启动再重点交付可复制的 settings 片段和验证步骤。全程 Windows 10/11 64 位纯英文路径不需要命令行基础。先明确一个概念OpenClaw 的 settings 文件是它的“总控台”里面写着用哪个模型、走哪个 API 地址、用哪把 Key。你把它改对了小龙虾才真正活过来。下面按顺序来每一步都能跟做。2. TaoToken 前置准备拿到 Base URL、API Key 和 Model ID 三件套在改 settings 之前你得先有三样东西Base URL、API Key、Model ID。这三件套缺一不可后面配置里会一一对应。TaoToken 的官网入口是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 地址是 https://taotoken.net/api 这个不加 UTM直接用于配置。第一步打开官网注册并登录。登录后进控制台地址是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 。控制台里能看到你的账户信息和用量。第二步创建 API Key。进 API Keys 页面https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。点“创建新 Key”复制出来。注意Key 只在创建时完整显示一次关掉就看不到了所以先粘到记事本里存好。格式一般是一长串字符别弄丢。第三步确认 Model ID。TaoToken 支持多种模型你在模型对话页面能看到可用列表https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite 。选一个你打算用的比如常见的对话模型把它的 Model ID 记下来。这个 ID 要原样填进 settings大小写和连字符都不能错。三件套汇总一下项目值用途Base URLhttps://taotoken.net/api请求发往哪里API Key控制台创建的那串字符身份验证Model ID模型对话页看到的标识指定用哪个模型如果你后面打算长期跑编码类或 Agent 类任务可以了解下 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 。不过本篇先聚焦把基础通道跑通。注意API Key 属于敏感凭证不要截图发群、不要提交到公开仓库。settings 文件里填了 Key 之后也别把这个文件随手分享出去。拿到三件套后先别急着关浏览器后面验证请求时还要回来对照。接下来进入解压和启动环节。3. 解压即用 settings 配置把通道指向 TaoToken 的完整片段先说解压。下载完 OpenClaw Windows 一键部署包约 361MB后得到一个 zip。这里有个坑别用 Windows 自带的解压容易损坏文件。用 7-Zip 或 WinRAR右键选“解压到当前文件夹”等 1-2 分钟生成 Openclaw-win 文件夹。解压前务必彻底关闭 360、腾讯电脑管家、火绒等杀毒软件。OpenClaw 要模拟键鼠、读写文件会被误报拦截导致核心文件被删。关掉后再解压、再运行这是前提。进入 Openclaw-win 文件夹找到红色龙虾图标的“Openclaw Windows一键启动.exe”双击。如果弹出“Windows 已保护你的电脑”点“更多信息”→“仍要运行”。然后点欢迎界面的“开始使用”。安装路径必须是纯英文不能有中文、空格、特殊字符。推荐 D:\OpenClaw别用 D:\软件\OpenClaw 或 D:\小龙虾。勾选协议点“开始安装”等 3-5 分钟自动部署。首次启动 Gateway 初始化要等 1-3 分钟正常现象。重点来了部署完成后找到 settings 配置文件。它一般在安装目录下的 config 文件夹里文件名可能是 settings.json 或 settings.toml。用记事本或 VS Code 打开。下面给你一份可复制的 JSON 片段路径和字段名按你实际文件为准把三件套填进去{ gateway: { host: 127.0.0.1, port: 18789, autoStart: true }, model: { provider: openai-compatible, baseUrl: https://taotoken.net/api, apiKey: sk-你的TaoToken密钥, modelId: 你的Model ID, timeout: 60000 }, agent: { maxSteps: 20, language: zh-CN } }如果你拿到的是 TOML 格式等价写法如下[gateway] host 127.0.0.1 port 18789 autoStart true [model] provider openai-compatible baseUrl https://taotoken.net/api apiKey sk-你的TaoToken密钥 modelId 你的Model ID timeout 60000 [agent] maxSteps 20 language zh-CN三个关键字段对照baseUrl 填 https://taotoken.net/api apiKey 填你创建的那串modelId 填模型对话页看到的标识。provider 保持 openai-compatible 即可TaoToken 走的是兼容协议。改完保存关掉文件。回到 OpenClaw 主界面点右上角“重启”让配置生效。这一步不做改了也白改。提示如果你用的是 Cline MCP 或 Claude Code 这类工具接 OpenClaw同样要保证 Base URL、Key、Model ID 三件套齐全缺一个就连不上。CC Switch 切换配置时也检查这三项。配置写好后别急着发复杂指令先做一次最小验证。4. 验证请求链路从 Gateway 在线到第一条指令跑通配置改完重启后看主界面右上角是否显示“Gateway在线”。在线只代表本地服务起来了不代表模型通道通了。真正的验证是发一条指令看它能不能拿到模型返回。先做最简单的验证在底部输入框发一句“你好请回复你的模型名称”。如果几秒内返回内容说明请求链路通了。如果一直转圈或报错往下看第 5 节的排障。更严谨的验证方式是用 curl 直接打 TaoToken 的接口确认 Key 和 Model ID 本身没问题。打开 PowerShell执行curl -X POST https://taotoken.net/api/v1/chat/completions ^ -H Content-Type: application/json ^ -H Authorization: Bearer sk-你的TaoToken密钥 ^ -d {\model\:\你的Model ID\,\messages\:[{\role\:\user\,\content\:\ping\}]}注意 Windows PowerShell 里换行符是 ^如果你用 Git Bash 就换成 \。返回里如果有 choices 字段和内容说明三件套正确。这一步能排除是 OpenClaw 配置问题还是 Key 本身问题。回到 OpenClaw发一条实际任务指令测试比如“帮我在桌面新建一个 test 文件夹”。观察它是否拆解步骤、调用工具、执行完成。成功的话你会看到它一步步操作最后桌面出现文件夹。如果返回内容里出现“reading choices”相关报错通常是返回结构解析问题检查 modelId 是否写错或者 baseUrl 末尾多了斜杠。正确写法是 https://taotoken.net/api 不要写成 https://taotoken.net/api/ 。验证通过后你就可以正常用了。内置的免费额度可以先体验基础功能。下面把常见报错集中排一遍。5. 常见报错排查401、local proxy failed、reading choices、OAuth这一节按真实报错来遇到哪个查哪个。401 UnauthorizedKey 错了或没生效。检查三件事apiKey 是否完整复制有没有漏字符、Key 是否已过期或被删、Authorization 头格式是否是 Bearer 加空格加 Key。改完 settings 记得重启 Gateway。local proxy failed本地代理失败。多半是端口被占用或 Gateway 没起来。检查 settings 里 port 18789 是否被别的程序占用换个端口试试。也可能是杀毒软件还在后台拦截彻底关掉再重启 OpenClaw。reading choices 报错返回结构解析失败。常见原因是 modelId 写错或者 baseUrl 指向了错误的路径。确认 baseUrl 是 https://taotoken.net/api modelId 和模型对话页完全一致。如果用的是 TOML检查引号有没有漏。OAuth 相关报错如果你在配置里误开了 OAuth 模式而 TaoToken 走的是 API Key 模式就会冲突。把 provider 改成 openai-compatible认证方式改成 apiKey不要用 OAuth。Gateway 一直离线先确认杀毒软件彻底关闭、安装路径纯英文。然后点右上角“重启”。还不行就关掉 OpenClaw重新运行一键启动.exe 再部署一次。首次启动特别慢正常。首次要初始化依赖等 1-3 分钟后续秒开。排障时有个通用思路先用第 4 节的 curl 确认三件套本身没问题再回头查 OpenClaw 的 settings。这样能快速定位是凭证问题还是配置问题。6. 跑通之后把小龙虾用起来的几个实用方向链路通了接下来就是怎么用。给你几个直接能复制的指令方向整理下载文件夹图片按日期分类、打开浏览器搜索并整理成表格、遍历桌面 Word 提取标题生成汇总。指令越具体执行越准。如果你要长期跑编码或 Agent 任务可以看 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 遇到配置细节可以对照。模型对话页 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite 可以随时验证模型是否正常。API Keys 管理在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。最后提醒一句settings 文件改完后备份一份下次换机器直接复制省得重新配。Key 泄露了就立刻去控制台删掉重建。把这三件套管好你的小龙虾就能稳定干活了。
