1. Windows 10 装 OpenClaw 龙虾到底卡在哪从零跑通本地 AI 网关OpenClaw 龙虾是一个跑在本地的 AI 网关服务它把飞书、企业微信这类聊天入口和你自己的大模型通道接在一起让你在聊天窗口里就能调用模型。它本身不训练模型只负责转发和编排所以真正决定能不能用起来的是后面接的那个模型通道。这篇教程聚焦 Windows 10 环境从下载安装到首次访问http://127.0.0.1:18789全部走一遍重点解决两个最容易翻车的地方一是安装命令必须管理员权限二是模型通道的 Key 和 Base URL 怎么填。适合谁看手上只有一台普通 Windows 10 电脑、没折腾过 Node 环境、想用统一 Key 接入多家模型的新手。我实测下来整个流程大概 20 分钟其中一半时间花在等安装和初始化上。你不需要提前装 Node安装脚本会自己处理依赖但需要保证网络能正常访问 npm 源。先说清楚 OpenClaw 龙虾和模型通道的关系。龙虾本体是开源网关它支持多种模型供应商但每个供应商都要单独配 Key。如果你同时用 Claude、GPT、国产模型就得维护好几套 Key 和地址切换起来很烦。TaoToken 的作用是提供一个统一的 API 通道一个 Key 走所有模型Base URL 固定模型 ID 按需切换。这样你在龙虾里只需要填一次认证信息后面换模型只改模型名就行。安装前确认三件事系统是 Windows 10 64 位、当前账号有管理员权限、磁盘留出至少 2GB。另外把杀毒软件的实时防护暂时关掉安装脚本会写系统服务部分安全软件会拦截。这些准备好之后下面按步骤走。2. TaoToken 统一 Key 前置准备注册、拿 Key、认清 Base URL在装龙虾之前先把模型通道准备好否则初始化到选模型那一步会卡住。TaoToken 的定位是统一 API 通道你注册后拿到一个 Key所有支持的模型都通过这个 Key 调用不用一家家去申请。官网入口是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册流程就是常规的邮箱加密码这里不展开。注册完进控制台找到 API Keys 页面新建一个 Key。这个 Key 只显示一次复制下来存好。控制台地址是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content Key 管理在左侧菜单里。如果你后面要长期跑编码类任务可以顺便看下 Coding Plan它适合高频调用场景地址是 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。关键信息有三个后面配置龙虾时要用配置项值说明Base URLhttps://taotoken.net/api固定不变注意结尾没有斜杠API Key你新建的那串只显示一次丢了就重建Model ID按需选比如 claude-sonnet-4-5、gpt-4o 等这里要提醒一个坑Base URL 是https://taotoken.net/api不是官网首页也不是控制台地址。很多人把官网地址填进去结果请求 404。API 地址不带任何查询参数就是纯路径。模型 ID 的写法要和你选的供应商一致龙虾初始化时会让你选模型选完它会自动填一个默认 ID你可以改成 TaoToken 支持的任意模型名。如果你不确定某个模型 ID 怎么写可以先用模型对话页面测一下。地址是 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 在里面选模型发一句话能通就说明这个 ID 可用。这一步花两分钟能省掉后面反复改配置的时间。Key 拿到后先别急着关页面把 Base URL、Key、Model ID 三个值记在记事本里。龙虾的初始化向导是交互式的中途没法退出去查提前准备好能一次过。3. 可复制配置OpenClaw 龙虾安装命令与 settings 片段这一节是核心操作命令和配置都能直接复制。先装龙虾本体再配模型通道。第一步以管理员身份打开 cmd。按 Win 键搜「cmd」右键选「以管理员身份运行」。这一步不能省普通权限装服务会失败报错通常是Access is denied或者服务注册失败。打开后执行安装命令npm install -g openclaw如果提示npm 不是内部或外部命令说明系统没装 Node。去 Node 官网下 LTS 版本装上装完重开 cmd 再执行。安装过程会拉依赖等进度条走完。完成后验证openclaw --version能打印版本号就说明装好了。接下来跑初始化向导openclaw onboard --install-daemon这个命令会做三件事初始化配置目录、注册后台服务、启动交互式向导。向导第一步问你是否快速启动选是。然后问是否使用默认配置选是。接着进入模型配置环节这里选「自定义 OpenAI 兼容通道」因为 TaoToken 提供的是标准 OpenAI 格式接口。选完之后它会依次问 Base URL、API Key、Model ID把上一节记的三个值填进去。Base URL 填https://taotoken.net/apiKey 粘贴你新建的那串Model ID 填你要用的模型名。填完向导会做一次连通性测试通了就继续不通会提示你检查。如果你不想走交互向导也可以直接改配置文件。龙虾的配置目录在C:\Users\你的用户名\.openclaw\里面有个settings.json。用记事本打开找到模型配置段改成这样{ models: { default: { provider: openai-compatible, baseUrl: https://taotoken.net/api, apiKey: 你的Key, model: claude-sonnet-4-5 } }, gateway: { port: 18789 } }注意 JSON 里不能有多余逗号Key 要用英文引号包起来。改完保存重启服务生效。如果你用的是 Codex 那套配置体系认证信息在auth.json里格式类似把 Base URL 和 Key 对应填进去即可。Cline MCP 场景下也是同样的三件套Base URL、Key、Model ID缺一不可。向导后面会问要不要接飞书、企业微信这些应用。第一次跑通建议全部跳过先把网关本身跑起来应用接入后面单独配。搜索功能也跳过不影响核心流程。全部选跳过后向导结束服务会自动启动。4. 验证请求访问 127.0.0.1:18789 与状态检查服务起来后先查状态openclaw gateway status正常输出会显示 running以及监听的端口 18789。如果显示 stopped手动启动openclaw gateway --port 18789这个命令是前台运行窗口不能关。想后台跑就用--install-daemon注册的服务用net start openclaw启动。启动后打开浏览器访问http://127.0.0.1:18789能看到龙虾的管理界面就说明网关通了。界面里会显示当前模型通道、已接入的应用、请求日志。第一次访问可能要点一下初始化按提示走就行。接下来验证模型通道是否真的通。在管理界面找「测试对话」或者「Playground」发一句「你好」看有没有回复。如果回复正常说明 Base URL、Key、Model ID 三件套都对了。如果报错看日志里的具体信息下一节对照排查。也可以用命令行直接测 API绕过界面curl https://taotoken.net/api/v1/chat/completions ^ -H Authorization: Bearer 你的Key ^ -H Content-Type: application/json ^ -d {\model\:\claude-sonnet-4-5\,\messages\:[{\role\:\user\,\content\:\hi\}]}Windows 的 cmd 里换行用^引号要转义。这条命令能返回 JSON 就说明通道没问题问题在龙虾配置如果这条也报错那就是 Key 或模型 ID 的问题。实测下来大部分失败都是 Base URL 填错或者 Key 复制时带了空格。验证清单网关状态 running、浏览器能打开 18789、测试对话有回复、日志无报错。四项都过就算跑通了。这时候你可以回到向导里补配飞书等应用或者直接开始用。5. 常见报错排查401、local proxy failed、reading choices、OAuth这一节列几个真实会遇到的报错对照处理。401 UnauthorizedKey 不对。检查三处Key 有没有复制完整、有没有多余空格、Base URL 是不是https://taotoken.net/api。如果 Key 是在控制台新建的确认没有删掉。401 也可能是 Key 权限不足去控制台看下这个 Key 绑定的模型范围。local proxy failed本地代理启动失败。常见原因是端口 18789 被占用。查占用netstat -ano | findstr 18789找到 PID 后去任务管理器结束那个进程或者换个端口启动openclaw gateway --port 18790。另一个原因是防火墙拦截去 Windows 防火墙里给 openclaw 放行。reading choices 报错这个通常出现在模型返回格式不对时。龙虾期望标准 OpenAI 格式的choices数组如果通道返回了别的结构就会报这个。检查 Base URL 是不是漏了/v1TaoToken 的完整路径是https://taotoken.net/api/v1/chat/completions但配置里一般只填到/api龙虾会自己补/v1。如果你填成了/api/v1就会变成/api/v1/v1导致格式错乱。OAuth 相关报错如果你在向导里选了 OAuth 登录方式而不是 API Key会走到浏览器授权流程。TaoToken 走的是 Key 认证不需要 OAuth。遇到 OAuth 报错就回向导重选「使用密钥」方式把 Key 填进去。Codex 的auth.json里如果残留了 OAuth 字段删掉只留 API Key 配置。服务启动后访问不了先openclaw gateway status看状态再net start openclaw手动起。如果提示服务已存在但起不来用sc delete openclaw删掉再重新--install-daemon。这个坑我踩过是之前装过旧版本残留了服务注册。模型 ID 不存在报错里会写 model not found。去模型对话页面确认这个 ID 可用注意大小写和连字符。不同供应商的 ID 格式不一样别混用。排查顺序建议先命令行 curl 测通道通了再查龙虾配置最后查服务和端口。这样能快速定位是通道问题还是本地问题。6. 跑通之后把统一 Key 用在长期编码与 Agent 场景网关跑通只是开始真正省事的是后面所有模型调用都走这一个 Key。你可以在龙虾里配多个模型切换时只改 Model IDBase URL 和 Key 不动。对于长期跑编码任务或者 Agent 自动化的场景这种统一通道能省掉大量管理成本。如果你打算高频调用比如让 Agent 持续跑任务可以看下 Coding Plan它针对这种场景做了额度优化地址是 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 里面有各语言的调用示例和参数说明。Key 管理还是去 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。Claude Code 这类工具接入时同样是三件套Base URL 填https://taotoken.net/apiKey 填你的Model ID 按工具要求填。有些工具配置文件在~/.claude/settings.json或者项目根目录的.claude/settings.json格式和前面龙虾的 settings 片段类似把对应字段替换掉就行。CC Switch 切换配置时也是改这三个值别改错位置。最后给个实用技巧把 Base URL、Key、常用 Model ID 存成一个环境变量文件比如setx TAOTOKEN_KEY 你的Key配置里用%TAOTOKEN_KEY%引用。这样换 Key 只改一处不用翻遍所有配置文件。Windows 10 下setx设置的是用户级环境变量重开 cmd 生效。跑通之后你会发现本地网关加统一 Key 的组合比每个工具单独配 Key 清爽得多。后面接飞书、接企业微信、接各种 Agent 框架都复用这一套认证不用重复折腾。