OpenClaw（小龙虾）快速部署指南｜Windows 下 Gateway 配置与 TaoToken 接入-北京尧图网络

1. 为什么 Windows 新手也需要一个本地 GatewayOpenClaw小龙虾是一个能在 Windows 上跑起来的开源 AI 智能体框架核心能力是让模型直接操作你的电脑整理文件、批量处理表格、自动开浏览器抓数据、定时推送消息。它和普通聊天机器人的区别在于聊天机器人只给你文字OpenClaw 会真的动手干活。而 Gateway 就是它的“神经中枢”——所有模型请求、工具调用、会话状态都从这里进出。很多人第一次装 OpenClaw 会卡在同一个地方智能体界面能打开但一发指令就报错或者干脆连不上模型。原因通常不是 OpenClaw 本身有问题而是 Gateway 没有正确配置模型通道。默认配置里 Gateway 指向的是本地模型或空地址你需要把它接到一个稳定、兼容 OpenAI 协议的统一 API 通道上才能让“小龙虾”真正动起来。这篇面向 Windows 10/11 新手从零走一遍 Gateway 的本地部署和 TaoToken 接入。你会拿到可复制的配置文件、环境变量模板以及启动后验证连通性的具体命令和预期返回。全程不需要编程基础但需要你愿意打开一次 PowerShell 粘贴几行命令。适合谁想在 Windows 上跑本地智能体、又不想折腾复杂模型部署的办公自动化用户、独立开发者、以及被各种 API 配置搞烦的人。我试过在纯净 Win11 和装了全家桶的 Win10 上各跑一遍下面这套流程两边都通。踩过的坑集中在路径、环境变量和防火墙三处后面会逐个拆开讲。2. TaoToken 前置准备拿到统一 API 通道OpenClaw 的 Gateway 本身不生产模型能力它只是一个调度层。你要给它一个“上游”也就是真正提供模型推理的 API 地址。TaoToken 在这里扮演的角色就是统一 API 通道它兼容 OpenAI 的接口格式OpenClaw 的 Gateway 配置里填上 Base URL 和 Key 就能直接对接不需要改 OpenClaw 源码也不需要额外装适配插件。为什么不用本地模型本地模型当然可以但对 Windows 新手来说显存、量化、推理框架每一步都是坑。统一 API 通道的好处是你只管发请求模型版本、并发、稳定性由通道侧处理。对于“养虾”这种需要频繁调用模型的场景通道的稳定性比本地跑一个 7B 模型更省心。前置准备分三步。第一步打开 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 。创建时给 Key 起个名字比如 openclaw-gateway方便后面排查。第三步记下两个值Base URL 固定为 https://taotoken.net/api 以及你刚生成的 Key形如 sk- 开头的一长串。这里有个细节OpenClaw 的 Gateway 在拼接请求时会在 Base URL 后面自动加上 /v1/chat/completions。所以你在配置里填的 Base URL 应该是 https://taotoken.net/api 不要自己再加 /v1否则会变成 /api/v1/v1/chat/completions直接 404。这个坑我在第一次配置时踩过报错信息是 “404 page not found”排查了半小时才发现是路径重复。模型 ID 怎么选OpenClaw 的 Gateway 配置里需要指定一个默认模型。TaoToken 支持的模型列表可以在模型对话页面查看入口是 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 。新手建议先用一个通用对话模型跑通流程比如 gpt-4o-mini 或 claude-3-5-sonnet 这类等连通性验证通过后再换成你实际需要的模型。记住这个 Model ID下一步配置文件里要用。如果你打算长期跑编码类智能体任务可以顺带了解一下 Coding Plan入口在 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 。它针对高频编码场景做了通道优化和 OpenClaw 的 Gateway 配合时延迟更稳。不过这一步不是必须的先把基础连通性跑通再说。3. 可复制配置Gateway 配置文件与环境变量OpenClaw 在 Windows 上的 Gateway 配置主要靠两个东西一个 JSON 配置文件一个环境变量文件。配置文件决定 Gateway 监听哪个端口、用哪个模型、上游地址是什么环境变量文件存放 API Key避免把密钥硬编码进配置文件。先找到 OpenClaw 的配置目录。如果你用的是官方一键包默认路径在D:\OpenClaw\config或你安装时选的目录下的config文件夹。如果目录不存在手动创建。Gateway 的主配置文件叫gateway.json完整内容如下你可以直接复制{ gateway: { host: 127.0.0.1, port: 18789, logLevel: info }, model: { provider: openai-compatible, baseUrl: https://taotoken.net/api, modelId: gpt-4o-mini, apiKeyEnv: TAOTOKEN_API_KEY, timeoutMs: 60000, maxRetries: 2 }, agent: { name: openclaw-local, workspace: D:\\OpenClaw\\workspace, autoApprove: false } }逐字段说明。gateway.host填 127.0.0.1 表示只允许本机访问如果你想让局域网内其他设备连进来改成 0.0.0.0但要注意防火墙放行。gateway.port默认 18789如果被占用可以改成 18790 或别的。model.provider固定写 openai-compatible因为 TaoToken 兼容 OpenAI 协议。model.baseUrl就是上一步记下的 https://taotoken.net/api 注意结尾没有斜杠。model.modelId填你在模型列表里选的那个 ID。model.apiKeyEnv写 TAOTOKEN_API_KEY意思是 Gateway 启动时会去读同名环境变量而不是从配置文件里读密钥。agent.workspace是智能体干活的工作目录建议设成纯英文路径比如 D:\OpenClaw\workspace。接下来配置环境变量。在 OpenClaw 安装目录下新建一个文件叫.env内容一行TAOTOKEN_API_KEYsk-你的实际Key粘贴在这里注意等号两边不要有空格Key 不要加引号。这个.env文件需要和gateway.json放在同一个 config 目录下OpenClaw 启动时会自动加载。如果你不想用.env也可以在 Windows 系统环境变量里手动添加 TAOTOKEN_API_KEY效果一样但.env更方便迁移和备份。还有一个可选配置如果你用的是 Claude Code 或类似工具做辅助开发可能会遇到需要配置settings.json的情况。OpenClaw 的 Gateway 本身不依赖这个但如果你在同一个环境里混用注意不要互相覆盖。Claude Code 的配置入口在 https://taotoken.net/claude-code?utm_sourcetaotoken_aicg_blog_endutm_contentclaude-codeutm_campaignrewrite 里面有独立的 Base URL 和 Key 配置说明和 OpenClaw 的 Gateway 配置是两套东西分开管理。配置写完后检查三件事gateway.json是合法 JSON可以用在线 JSON 校验工具过一遍.env文件没有 BOM 头用 VS Code 保存时选 UTF-8 无 BOM路径里没有中文和空格。这三条任意一条出问题Gateway 启动都会失败而且报错信息不一定直观。4. 启动 Gateway 并验证智能体连通性配置就绪后打开 PowerShell。不需要管理员权限普通窗口即可。先切换到 OpenClaw 安装目录比如cd D:\OpenClaw然后启动 Gateway。如果你用的是一键包通常有一个start-gateway.bat或openclaw.exe直接运行.\start-gateway.bat如果没找到启动脚本可以用 Node 直接跑前提是安装包自带了 Node 运行时.\runtime\node.exe .\gateway\server.js --config .\config\gateway.json启动成功的标志是控制台输出类似下面的内容[Gateway] loading config from .\config\gateway.json [Gateway] model provider: openai-compatible [Gateway] baseUrl: https://taotoken.net/api [Gateway] listening on 127.0.0.1:18789 [Gateway] ready看到ready就说明 Gateway 进程起来了。但进程起来不等于模型通道通接下来要做一次真实的连通性验证。新开一个 PowerShell 窗口用 curl 发一条最小请求curl -X POST http://127.0.0.1:18789/v1/chat/completions -H Content-Type: application/json -d {\model\:\gpt-4o-mini\,\messages\:[{\role\:\user\,\content\:\ping\}]}注意 PowerShell 里 curl 是 Invoke-WebRequest 的别名上面的写法在 PowerShell 7 里可以直接用。如果你用的是 Windows 自带的 PowerShell 5.1建议改用curl.exe显式调用或者用Invoke-RestMethod。预期返回是一段 JSON包含choices数组里面有你发的 “ping” 对应的回复内容。只要看到choices里有内容就说明 Gateway 到 TaoToken 的通道完全打通了。如果返回的是{error:{message:...}}先看错误类型。401 通常是 Key 不对或没加载到环境变量404 通常是 Base URL 路径重复timeout 通常是网络或防火墙拦截。下一节会逐个拆。验证通过后你可以回到 OpenClaw 的图形界面在指令输入框里发一条真实任务比如“在 D:\OpenClaw\workspace 下创建一个 test.txt 文件内容写 hello”。如果智能体执行成功说明整条链路——界面 → Gateway → TaoToken → 模型 → 工具调用——全部跑通。这时候你的“小龙虾”才算真正养活了。5. 常见报错排查401、local proxy failed、reading choices这一节按真实报错来。你在 Windows 上配 OpenClaw Gateway 接 TaoToken大概率会碰到下面几类问题。每个我都给出报错原文、原因和修复步骤。第一类401 Unauthorized。报错原文通常是{error:{message:Invalid API key provided,type:invalid_request_error}}原因有三个可能。一是.env文件里的 Key 写错了比如多了空格、少了字符、或者把 sk- 前缀漏了。二是.env文件没有被 Gateway 加载检查它是否和gateway.json在同一目录文件名是否是.env而不是env.txt。三是系统环境变量里有一个同名的旧 Key 覆盖了.env。修复方法在 PowerShell 里执行echo $env:TAOTOKEN_API_KEY看输出的值是否和你预期一致。如果为空说明环境变量没生效如果值不对去系统环境变量里删掉旧的重启 PowerShell 再试。第二类local proxy failed。报错原文类似Error: local proxy failed: connect ECONNREFUSED 127.0.0.1:18789这个不是模型通道的问题是 Gateway 本身没起来或者端口不对。先确认 Gateway 进程还在运行控制台有没有报错退出。如果进程在检查gateway.json里的 port 是不是 18789以及你 curl 的地址是不是同一个端口。还有一种情况是 Windows 防火墙拦截了本地回环以外的连接如果你把 host 改成了 0.0.0.0需要在防火墙里放行 18789 端口。修复把 host 改回 127.0.0.1 先跑通本机再考虑局域网访问。第三类reading choices 相关报错。报错原文通常是TypeError: Cannot read properties of undefined (reading choices)这个错误说明 Gateway 收到了上游返回但返回结构里没有choices字段。原因通常是 Base URL 配错了比如填成了 https://taotoken.net/api/v1 导致实际请求路径变成 /api/v1/v1/chat/completions上游返回的是 404 页面而不是模型响应。修复把gateway.json里的 baseUrl 改回 https://taotoken.net/api 不要带 /v1。另一个可能是 modelId 填了一个不存在的模型上游返回错误结构。去模型列表页面核对 Model ID 拼写。第四类OAuth 相关报错。如果你在配置过程中看到OAuth token expired或invalid_grant这通常不是 OpenClaw Gateway 的问题而是你同时在使用 Claude Code 或其他需要 OAuth 的工具它们的凭证和 TaoToken 的 API Key 是两套体系。检查你的 Claude Code 配置入口 https://taotoken.net/claude-code?utm_sourcetaotoken_aicg_blog_endutm_contentclaude-codeutm_campaignrewrite 确认它的 Base URL 和 Key 与 OpenClaw 的分开配置。不要混用同一个 Key 到不同工具的不同认证方式里。第五类Gateway 启动后界面显示离线。这种情况先看 Gateway 控制台有没有ready如果有检查 OpenClaw 图形界面里的 Gateway 地址是不是 127.0.0.1:18789。有时候一键包会默认填一个别的端口需要手动改。如果控制台没有ready往上翻报错通常是配置文件 JSON 格式错误或路径不存在。排查顺序建议先确认 Gateway 进程活着再确认端口对再确认 Base URL 和 Key最后确认 Model ID。这四步覆盖了 90% 的连通性问题。6. 长期使用建议与接入文档入口跑通之后有几件事值得做。第一把gateway.json和.env备份一份到别的目录OpenClaw 升级时配置文件可能被覆盖有备份能快速恢复。第二如果你经常换模型可以把 modelId 做成环境变量比如TAOTOKEN_MODEL_ID这样改模型不用动 JSON 文件。第三Gateway 的日志默认输出到控制台长期跑建议重定向到文件方便回溯报错。关于 API Key 的管理建议在 TaoToken 控制台里为 OpenClaw 单独创建一个 Key不要和其他工具共用。这样如果某个 Key 出问题可以单独禁用而不影响其他服务。控制台入口再放一次https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。创建时可以设置额度上限避免意外超额。如果你在配置过程中遇到本文没覆盖的报错最直接的办法是查接入文档。TaoToken 的文档里有完整的 Base URL 说明、模型列表和错误码对照入口是 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。文档里的接口示例可以直接复制到 curl 里测试比在 OpenClaw 里反复重启 Gateway 快得多。最后说一个实际经验OpenClaw 的 Gateway 在 Windows 上对路径非常敏感。工作目录、配置文件路径、日志路径只要有一个带中文或空格就可能出现莫名其妙的启动失败。我建议所有和 OpenClaw 相关的目录都用纯英文短路径比如D:\OpenClaw不要放在C:\Users\你的名字\Desktop\新建文件夹这种地方。这个习惯能帮你省掉大量排查时间。现在你的 Gateway 应该已经在 127.0.0.1:18789 上跑着了模型通道也通了。接下来就是给“小龙虾”派活。从简单的文件整理开始逐步加复杂度观察 Gateway 日志里的请求和响应你会慢慢摸清它的脾气。养虾这件事跑通只是第一步后面怎么喂指令、怎么控制权限才是真正拉开效率差距的地方。

OpenClaw（小龙虾）快速部署指南｜Windows 下 Gateway 配置与 TaoToken 接入

相关推荐

人机协作新范式：2026年真正好用的专业AI论文写作工具

别再用AI生成屎山代码了！Anthropic最新SDLC实战指南：用TaoToken统一Key跑通CLAUDE.md规范

css禁止点击事件：pointer-events 从踩坑到落地的完整配置指南

更多资讯

Windows Codex Computer Use 电脑操控问题修复

OpenShell 深度解析：Windows 开始菜单与任务栏定制框架的部署与实战

Superpowers安装指南：用可视化IDE快速构建Chrome扩展

智能体skills工程化实践：GKE部署、Workload Identity权限与OpenAPI契约

STM32控制板结构解析：从最小系统到外设引脚映射

day45复盘：业余时间从零开发并上线每日计划复盘Web工具

今日更新

基于sEMG与IMU的手语手势识别：从数据采集到实时部署避坑指南

装配车间MES落地指南：SimpleMES工单流转、BOM与齐套检查实战

AI获客怎样减少重复线索？意客AI的原文复用与版本筛选

本周精选

CMOS设计三大物理效应：体效应、沟道长度调制与亚阈值导电

微信小程序在线阅读毕设全解析：Java后端+MySQL+避坑实战

Android音频问题五层分析法：从App到Codec的系统化诊断

本月热门

我发现了一个新思路：用 Remotion + Claude Code 像写代码一样自动化生成短视频

Windows下 Codex 中 Chrome 和 Computer Use 插件不可用问题排查及解决参考方式：TaoToken 统一 Key 配置与验证

2026 大模型集体涨价：用 Python 做企业 Token 成本测算与选型避坑（附配置）

读完文章，想聊聊您的网站？