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_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，注册流程就是常规的邮箱加密码，这里不展开。

注册完进控制台，找到 API Keys 页面，新建一个 Key。这个 Key 只显示一次，复制下来存好。控制台地址是 https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，Key 管理在左侧菜单里。如果你后面要长期跑编码类任务，可以顺便看下 Coding Plan，它适合高频调用场景，地址是 https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 。

关键信息有三个，后面配置龙虾时要用：

这里要提醒一个坑：Base URL 是https://taotoken.net/api，不是官网首页，也不是控制台地址。很多人把官网地址填进去，结果请求 404。API 地址不带任何查询参数，就是纯路径。模型 ID 的写法要和你选的供应商一致，龙虾初始化时会让你选模型，选完它会自动填一个默认 ID，你可以改成 TaoToken 支持的任意模型名。

如果你不确定某个模型 ID 怎么写，可以先用模型对话页面测一下。地址是 https://taotoken.net/chat?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_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/api，Key 粘贴你新建的那串，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 Unauthorized：Key 不对。检查三处：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 是不是漏了/v1，TaoToken 的完整路径是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 ID，Base URL 和 Key 不动。对于长期跑编码任务或者 Agent 自动化的场景，这种统一通道能省掉大量管理成本。

如果你打算高频调用，比如让 Agent 持续跑任务，可以看下 Coding Plan，它针对这种场景做了额度优化，地址是 https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 。接入文档在 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，里面有各语言的调用示例和参数说明。Key 管理还是去 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 。

Claude Code 这类工具接入时，同样是三件套：Base URL 填https://taotoken.net/api，Key 填你的，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 框架，都复用这一套认证，不用重复折腾。