1. 为什么 Windows 新手装 OpenClaw 总卡在最后一步OpenClaw 是一个能在本地跑起来的开源 AI 智能体圈内人叫它“小龙虾”。它和普通聊天机器人的区别在于你给它一句自然语言指令它会自己拆任务、调工具、动键鼠把文件整理、表格生成、浏览器自动化这类活直接干完。适合谁适合不想写代码、但想让电脑替自己干重复活的 Windows 用户尤其是刚接触 AI 智能体、连 Python 环境都没配过的新手。但我在帮人远程排障时发现一个规律大部分人卡住的地方不是安装包解压也不是杀毒软件拦截而是装完之后 OpenClaw 的 Gateway 一直转圈、发指令没反应。根子往往在模型通道上——默认配置指向的 endpoint 连不通或者 auth.json 里的 Key 没填对。可视化安装只解决了“程序装进电脑”没解决“程序能连上模型”。这篇就按真实操作顺序走一遍从安装包获取、环境检查、界面化配置到把 endpoint 和 auth.json 改到 TaoToken 统一通道最后做一次连通性验证。全程 Windows 10/11 64 位不需要命令行基础配置片段可以直接复制。装完之后你会得到一个能正常收发指令的本地智能体而不是一个只会转圈的壳子。2. TaoToken 前置准备统一 Key 与 API 通道OpenClaw 本身是个执行框架它需要一个大模型来“思考”。默认它可能指向某些公共通道但那些通道要么限速、要么需要额外配置新手很容易在这里卡死。TaoToken 的作用是把模型调用统一到一个入口一个 Base URL、一个 API Key、一个 Model ID三件套填完就能跑。你可以把 TaoToken 理解成一个“模型插座”。OpenClaw 是电器TaoToken 是插线板模型是电。电器不关心电从哪个电厂来只要插线板规格对、通电就行。这样你换模型、换通道都不用改 OpenClaw 的代码只改配置里的三个值。前置准备分三步都在浏览器里完成不碰命令行。第一步打开 TaoToken 官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册并登录。这一步只是拿账号不涉及任何本地环境改动。第二步进入控制台创建 API Key。地址是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 。在 API Keys 页面点新建复制生成的 Key形如sk-开头的一长串。这个 Key 只显示一次先粘到记事本里存着。对应的文档页在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 里面有各语言的调用示例后面排障会用到。第三步确认你要用的 Model ID。在模型对话页 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite 可以先试聊一句确认账号额度正常。然后在文档里找到模型列表记下你要填进 OpenClaw 的 Model ID比如常见的对话模型标识。如果你打算长期跑编码类任务可以看 Coding Plan 页面 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite 选一个适合持续调用的方案。这里有个新手常犯的错把官网首页地址当成 API 地址填进去。官网是给人看的API 地址是给程序调的两者不一样。TaoToken 的 API 根地址是 https://taotoken.net/api 注意结尾没有斜杠填配置时也别自己加。三件套记好Base URL https://taotoken.net/apiAPI Key 你刚复制的那串Model ID 文档里确认的模型标识。下面进 OpenClaw 配置。3. 可复制配置改 endpoint 与 auth.jsonOpenClaw 装完后配置分散在两个地方一个是界面里的 endpoint 设置一个是本地 auth.json 文件。两个都要改缺一个就连不通。我按你实际会看到的界面顺序写。先找配置文件位置。OpenClaw 默认把配置放在用户目录下的.openclaw文件夹里。在文件资源管理器地址栏输入%USERPROFILE%\.openclaw回车就能看到auth.json和config.toml或settings.json取决于版本。如果没看到说明你还没首次启动过先启动一次让它生成。先改auth.json。用记事本或 VS Code 打开把内容替换成下面这段注意把sk-你的Key换成你自己的{ base_url: https://taotoken.net/api, api_key: sk-你的Key, model: 你的ModelID, provider: openai-compatible }这里provider填openai-compatible是因为 TaoToken 的 API 兼容 OpenAI 格式OpenClaw 认这个字段。model填你在文档里确认的 Model ID别填中文名。再改config.toml如果你的版本是 settings.json字段名一样只是格式换成 JSON。找到[gateway]或[model]段改成[model] base_url https://taotoken.net/api api_key sk-你的Key model_id 你的ModelID timeout 120 [gateway] host 127.0.0.1 port 18789timeout给 120 秒是因为首次调用模型时 OpenClaw 要初始化上下文给太短会误报超时。port保持默认 18789除非你本机这个端口被占。如果你用的是界面化配置新版 OpenClaw 有设置面板在“模型设置”里填三个框API Base 填https://taotoken.net/apiAPI Key 填你的 KeyModel 填 Model ID。填完点保存它底层还是会写进上面两个文件。改完记得完全退出 OpenClaw右下角托盘图标右键退出再重新启动。只关窗口不算退出配置不会重载。4. 验证请求确认 Gateway 在线且能回话配置改完怎么确认真的通了别急着发复杂指令先做最小验证。第一步看 Gateway 状态。重新启动 OpenClaw 后主界面右上角应该显示“Gateway 在线”。如果还是离线先别往下走去第 5 节排障。第二步发一句最简单的指令比如“你好回复一个字通”。这句话不触发任何工具调用纯粹测模型通道。如果 3 到 5 秒内返回“通”说明 Base URL、Key、Model ID 三件套都对。第三步做一次带工具调用的验证。发“在桌面新建一个文件夹命名为 openclaw_test”。这条会触发文件操作。成功的话你桌面会出现这个文件夹同时聊天窗口会显示执行步骤。这一步验证的是 OpenClaw 的执行链路和模型通道都正常。第四步如果你会用 curl可以在另一个窗口跑一条命令直接测 API排除 OpenClaw 本身的干扰curl https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer sk-你的Key \ -H Content-Type: application/json \ -d {model:你的ModelID,messages:[{role:user,content:ping}]}返回里有choices字段和内容就说明 Key 和通道没问题。如果这条通、OpenClaw 不通问题在 OpenClaw 配置如果这条也不通问题在 Key 或 Model ID。实测下来大部分“Gateway 离线”都是 auth.json 里 Key 带了空格或者 base_url 结尾多了斜杠。复制的时候注意别把换行带进去。5. 本篇常见错排查401、local proxy failed、reading choices这一节按真实报错来你遇到哪个对哪个。报错一401 Unauthorized。这是 Key 问题。三种可能Key 复制时少了字符、Key 已失效、auth.json 里api_key字段名写错。先回控制台 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite 重新生成一个 Key替换后重启。注意 JSON 里 Key 要用英文双引号包住别用中文引号。报错二local proxy failed 或 connection refused。这是 endpoint 地址问题。检查base_url是不是https://taotoken.net/api结尾不要加/v1也不要加斜杠。OpenClaw 会自己拼/v1/chat/completions。如果你填了https://taotoken.net/api/v1就会变成/api/v1/v1/...直接 404 或拒绝连接。报错三reading choices 时 panic 或 index out of range。这个报错看着吓人其实是返回体里没有choices字段OpenClaw 去读就崩了。原因通常是 Model ID 填错通道返回了错误信息而不是正常补全。回文档核对 Model ID注意大小写。另外确认provider填的是openai-compatible填错会导致解析格式不匹配。报错四OAuth 相关提示或反复要求登录。如果你之前配过别的通道auth.json 里可能残留了 OAuth 字段。把 auth.json 整个替换成第 3 节那段干净配置别保留旧字段。OpenClaw 看到 OAuth 字段会优先走登录流程忽略你的 API Key。报错五Gateway 在线但发指令一直转圈。先看timeout是不是太小改成 120。再确认杀毒软件没有拦截 OpenClaw 的出站请求——有些安全软件会拦本地程序访问外部 API。把 OpenClaw 主程序加入白名单。如果你用的是 CC Switch 或 Cline MCP 这类工具配合 OpenClaw记住三件套必须一致Base URL、Key、Model ID 在 OpenClaw 和这些工具里填同一套值。任何一处不一致都会导致一边通一边不通。Codex 的 auth.json 格式和 OpenClaw 不同别直接复制按各自文档填。6. 装完之后让 OpenClaw 稳定跑起来配置通了只是开始日常用还有几个点注意。第一别把 OpenClaw 装在 C 盘根目录或带中文的路径。安装时路径用D:\OpenClaw这种纯英文否则 Gateway 启动时读配置文件可能失败。已经装错的卸载重装到英文路径配置可以提前备份出来。第二auth.json 里的 Key 不要提交到 Git 或分享给别人。如果你要备份配置把 Key 那行删掉再存。TaoToken 控制台可以随时吊销旧 Key 重新生成。第三长期跑任务建议用 Coding Plan 通道普通对话用默认通道。OpenClaw 支持多模型配置你可以在 config.toml 里配多个 profile切换着用。具体方案看 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite 。第四第一次启动慢是正常的Gateway 要初始化依赖。后续启动几秒就开。如果每次都很慢检查是不是杀毒软件在每次启动时扫描 OpenClaw 目录加白名单能解决。第五验证连通性养成习惯改完配置先发“你好”再发一条文件操作指令。两步都过再跑复杂任务。这样出问题能快速定位是通道问题还是任务逻辑问题。装好之后你可以试着让它整理下载文件夹、把桌面 Word 文档汇总成表格、或者定时抓取网页信息。指令越具体执行越准。遇到报错先回第 5 节对照大部分问题都在 Key、地址、Model ID 这三个值上。
1. 为什么 Windows 新手装 OpenClaw 总卡在最后一步OpenClaw 是一个能在本地跑起来的开源 AI 智能体圈内人叫它“小龙虾”。它和普通聊天机器人的区别在于你给它一句自然语言指令它会自己拆任务、调工具、动键鼠把文件整理、表格生成、浏览器自动化这类活直接干完。适合谁适合不想写代码、但想让电脑替自己干重复活的 Windows 用户尤其是刚接触 AI 智能体、连 Python 环境都没配过的新手。但我在帮人远程排障时发现一个规律大部分人卡住的地方不是安装包解压也不是杀毒软件拦截而是装完之后 OpenClaw 的 Gateway 一直转圈、发指令没反应。根子往往在模型通道上——默认配置指向的 endpoint 连不通或者 auth.json 里的 Key 没填对。可视化安装只解决了“程序装进电脑”没解决“程序能连上模型”。这篇就按真实操作顺序走一遍从安装包获取、环境检查、界面化配置到把 endpoint 和 auth.json 改到 TaoToken 统一通道最后做一次连通性验证。全程 Windows 10/11 64 位不需要命令行基础配置片段可以直接复制。装完之后你会得到一个能正常收发指令的本地智能体而不是一个只会转圈的壳子。2. TaoToken 前置准备统一 Key 与 API 通道OpenClaw 本身是个执行框架它需要一个大模型来“思考”。默认它可能指向某些公共通道但那些通道要么限速、要么需要额外配置新手很容易在这里卡死。TaoToken 的作用是把模型调用统一到一个入口一个 Base URL、一个 API Key、一个 Model ID三件套填完就能跑。你可以把 TaoToken 理解成一个“模型插座”。OpenClaw 是电器TaoToken 是插线板模型是电。电器不关心电从哪个电厂来只要插线板规格对、通电就行。这样你换模型、换通道都不用改 OpenClaw 的代码只改配置里的三个值。前置准备分三步都在浏览器里完成不碰命令行。第一步打开 TaoToken 官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册并登录。这一步只是拿账号不涉及任何本地环境改动。第二步进入控制台创建 API Key。地址是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 。在 API Keys 页面点新建复制生成的 Key形如sk-开头的一长串。这个 Key 只显示一次先粘到记事本里存着。对应的文档页在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 里面有各语言的调用示例后面排障会用到。第三步确认你要用的 Model ID。在模型对话页 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite 可以先试聊一句确认账号额度正常。然后在文档里找到模型列表记下你要填进 OpenClaw 的 Model ID比如常见的对话模型标识。如果你打算长期跑编码类任务可以看 Coding Plan 页面 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite 选一个适合持续调用的方案。这里有个新手常犯的错把官网首页地址当成 API 地址填进去。官网是给人看的API 地址是给程序调的两者不一样。TaoToken 的 API 根地址是 https://taotoken.net/api 注意结尾没有斜杠填配置时也别自己加。三件套记好Base URL https://taotoken.net/apiAPI Key 你刚复制的那串Model ID 文档里确认的模型标识。下面进 OpenClaw 配置。3. 可复制配置改 endpoint 与 auth.jsonOpenClaw 装完后配置分散在两个地方一个是界面里的 endpoint 设置一个是本地 auth.json 文件。两个都要改缺一个就连不通。我按你实际会看到的界面顺序写。先找配置文件位置。OpenClaw 默认把配置放在用户目录下的.openclaw文件夹里。在文件资源管理器地址栏输入%USERPROFILE%\.openclaw回车就能看到auth.json和config.toml或settings.json取决于版本。如果没看到说明你还没首次启动过先启动一次让它生成。先改auth.json。用记事本或 VS Code 打开把内容替换成下面这段注意把sk-你的Key换成你自己的{ base_url: https://taotoken.net/api, api_key: sk-你的Key, model: 你的ModelID, provider: openai-compatible }这里provider填openai-compatible是因为 TaoToken 的 API 兼容 OpenAI 格式OpenClaw 认这个字段。model填你在文档里确认的 Model ID别填中文名。再改config.toml如果你的版本是 settings.json字段名一样只是格式换成 JSON。找到[gateway]或[model]段改成[model] base_url https://taotoken.net/api api_key sk-你的Key model_id 你的ModelID timeout 120 [gateway] host 127.0.0.1 port 18789timeout给 120 秒是因为首次调用模型时 OpenClaw 要初始化上下文给太短会误报超时。port保持默认 18789除非你本机这个端口被占。如果你用的是界面化配置新版 OpenClaw 有设置面板在“模型设置”里填三个框API Base 填https://taotoken.net/apiAPI Key 填你的 KeyModel 填 Model ID。填完点保存它底层还是会写进上面两个文件。改完记得完全退出 OpenClaw右下角托盘图标右键退出再重新启动。只关窗口不算退出配置不会重载。4. 验证请求确认 Gateway 在线且能回话配置改完怎么确认真的通了别急着发复杂指令先做最小验证。第一步看 Gateway 状态。重新启动 OpenClaw 后主界面右上角应该显示“Gateway 在线”。如果还是离线先别往下走去第 5 节排障。第二步发一句最简单的指令比如“你好回复一个字通”。这句话不触发任何工具调用纯粹测模型通道。如果 3 到 5 秒内返回“通”说明 Base URL、Key、Model ID 三件套都对。第三步做一次带工具调用的验证。发“在桌面新建一个文件夹命名为 openclaw_test”。这条会触发文件操作。成功的话你桌面会出现这个文件夹同时聊天窗口会显示执行步骤。这一步验证的是 OpenClaw 的执行链路和模型通道都正常。第四步如果你会用 curl可以在另一个窗口跑一条命令直接测 API排除 OpenClaw 本身的干扰curl https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer sk-你的Key \ -H Content-Type: application/json \ -d {model:你的ModelID,messages:[{role:user,content:ping}]}返回里有choices字段和内容就说明 Key 和通道没问题。如果这条通、OpenClaw 不通问题在 OpenClaw 配置如果这条也不通问题在 Key 或 Model ID。实测下来大部分“Gateway 离线”都是 auth.json 里 Key 带了空格或者 base_url 结尾多了斜杠。复制的时候注意别把换行带进去。5. 本篇常见错排查401、local proxy failed、reading choices这一节按真实报错来你遇到哪个对哪个。报错一401 Unauthorized。这是 Key 问题。三种可能Key 复制时少了字符、Key 已失效、auth.json 里api_key字段名写错。先回控制台 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite 重新生成一个 Key替换后重启。注意 JSON 里 Key 要用英文双引号包住别用中文引号。报错二local proxy failed 或 connection refused。这是 endpoint 地址问题。检查base_url是不是https://taotoken.net/api结尾不要加/v1也不要加斜杠。OpenClaw 会自己拼/v1/chat/completions。如果你填了https://taotoken.net/api/v1就会变成/api/v1/v1/...直接 404 或拒绝连接。报错三reading choices 时 panic 或 index out of range。这个报错看着吓人其实是返回体里没有choices字段OpenClaw 去读就崩了。原因通常是 Model ID 填错通道返回了错误信息而不是正常补全。回文档核对 Model ID注意大小写。另外确认provider填的是openai-compatible填错会导致解析格式不匹配。报错四OAuth 相关提示或反复要求登录。如果你之前配过别的通道auth.json 里可能残留了 OAuth 字段。把 auth.json 整个替换成第 3 节那段干净配置别保留旧字段。OpenClaw 看到 OAuth 字段会优先走登录流程忽略你的 API Key。报错五Gateway 在线但发指令一直转圈。先看timeout是不是太小改成 120。再确认杀毒软件没有拦截 OpenClaw 的出站请求——有些安全软件会拦本地程序访问外部 API。把 OpenClaw 主程序加入白名单。如果你用的是 CC Switch 或 Cline MCP 这类工具配合 OpenClaw记住三件套必须一致Base URL、Key、Model ID 在 OpenClaw 和这些工具里填同一套值。任何一处不一致都会导致一边通一边不通。Codex 的 auth.json 格式和 OpenClaw 不同别直接复制按各自文档填。6. 装完之后让 OpenClaw 稳定跑起来配置通了只是开始日常用还有几个点注意。第一别把 OpenClaw 装在 C 盘根目录或带中文的路径。安装时路径用D:\OpenClaw这种纯英文否则 Gateway 启动时读配置文件可能失败。已经装错的卸载重装到英文路径配置可以提前备份出来。第二auth.json 里的 Key 不要提交到 Git 或分享给别人。如果你要备份配置把 Key 那行删掉再存。TaoToken 控制台可以随时吊销旧 Key 重新生成。第三长期跑任务建议用 Coding Plan 通道普通对话用默认通道。OpenClaw 支持多模型配置你可以在 config.toml 里配多个 profile切换着用。具体方案看 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite 。第四第一次启动慢是正常的Gateway 要初始化依赖。后续启动几秒就开。如果每次都很慢检查是不是杀毒软件在每次启动时扫描 OpenClaw 目录加白名单能解决。第五验证连通性养成习惯改完配置先发“你好”再发一条文件操作指令。两步都过再跑复杂任务。这样出问题能快速定位是通道问题还是任务逻辑问题。装好之后你可以试着让它整理下载文件夹、把桌面 Word 文档汇总成表格、或者定时抓取网页信息。指令越具体执行越准。遇到报错先回第 5 节对照大部分问题都在 Key、地址、Model ID 这三个值上。
