OpenClaw Windows 部署 onboard 跳过 API Key?TaoToken 这样补模型通道

发布时间:2026/9/18 10:59:14
OpenClaw Windows 部署 onboard 跳过 API Key?TaoToken 这样补模型通道 OpenClaw 的 onboard 向导跳过 API Key 后Skill 没法用。去 TaoToken 官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 拿 KeyBase URL 填 https://taotoken.net/api 就能补上模型通道。这篇按原教程的 Windows 部署路径把「onboard 里选了 Skip for now 之后怎么救」聊透原生 PowerShell 方案和 WSL2Docker 方案分别改哪个配置文件怎么配合openclaw gateway start和 18789 端口验证遇到 401、404、端口占用分别怎么处理。1. openclaw onboard 里跳过模型提供商之后Skill 为什么用不了1.1 从 PowerShell 一键安装到 Onboarding 向导的路径回顾如果你走的是方案一前面几步应该是这样以管理员身份打开 PowerShell把执行策略改成 RemoteSigned然后跑iwr -useb https://openclaw.ai/install.ps1 | iex。脚本会自动检测 Node.js 版本低于 v22 会帮你下载安装还会配环境变量、装全局依赖。装完用openclaw --version确认版本号出来接着就是openclaw onboard新手一般加--flow quickstart跳过高级配置。向导会依次问运行模式、模型提供商、默认模型、渠道对接、技能配置。问题就出在「模型提供商」这一问教程里通常写着「没有 API Key 就选 Skip for now后续再补」。1.2 模型通道空缺对文件管理和联网搜索技能的影响OpenClaw 本身是个本地 AI 智能体平台它的文件管理、联网搜索、自动化办公这些 Skill并不是写死的脚本。你给一句「把 D 盘那个日志文件夹里昨天的文件按日期归类」它得先让模型理解你的意图再规划出「列出文件 → 读取时间 → 创建文件夹 → 移动文件」这一串动作最后才调用对应的工具去执行。如果模型通道是空的Skill 没有「大脑」来解析指令表现就是点了没反应、转圈、或者直接报一个跟模型连接相关的错。所以 Skip for now 只能当作临时跳过不能当成部署完成。1.3 补通道的两种时机向导里直接配 vs 事后改配置文件补通道有两个时间点。一是在第一次跑openclaw onboard时就不要选 Skip直接选自定义提供商把 Base URL 和 Key 填进去。二是已经跳过了那就重新跑一次openclaw onboard或者直接改配置文件。两种方式都需要你先有一把可用的 API Key。这把 Key 从哪来打开 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 注册账号进控制台创建即可。下面第 2 节讲向导里怎么填第 3 节讲配置文件怎么改。2. 在 TaoToken 拿 Key把 Base URL 指向 https://taotoken.net/api2.1 去官网创建 API Key 并查看模型广场先打开 TaoToken 完成注册和登录。进控制台后找「API Keys」或「密钥管理」点创建复制生成的 Key。这个 Key 只显示一次丢进记事本或者密码管理器里备用。接着去模型广场看一眼当前支持的模型 ID因为不同工具对模型名的写法要求不一样。记住两个东西Key 是YOUR_API_KEY这个占位符要替换的内容Base URL 是https://taotoken.net/api。2.2 重新跑 openclaw onboard 时选 Custom / OpenAI Compatible 提供商如果你打算在向导里直接配就在 PowerShell 里再执行一次openclaw onboard。走到「模型提供商」这一步不要选 Skip for now找类似「Custom」「OpenAI Compatible」或者「自定义 / 兼容模式」的选项。选中之后向导通常会依次让你填三项Base URL、API Key、Model ID。Base URL 填https://taotoken.net/api注意末尾不要加/v1。API Key 填你刚才创建的那串字符。Model ID 按模型广场里列出的写不要自己编一个带日期后缀的名字。2.3 填 Base URL 与 Key 的注意点这里最容易混的是两个地址。官网落地页是给你注册、创建 Key、看用量用的地址是https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end。填进工具的 Base URL 是https://taotoken.net/api它后面不跟/v1也不加任何 UTM 参数。如果你把带?utm_source的地址填进 Base URL模型通道肯定连不通。下面这张表可以对照用途地址注册、登录、创建 Key、看用量https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end填进 OpenClaw 的 Base URLhttps://taotoken.net/api需要替换的 Key 占位符YOUR_API_KEY向导走完后终端会提示 Onboarding completed。这时候别急着高兴先往下走启动网关验证模型通道是否真的通了。3. 跳过向导后改配置文件clawdbot.json 与 openclaw.json 两条路径3.1 方案一原生 PowerShellclawdbot.json 里的模型通道字段方案一的配置文件在C:\Users\你的Windows用户名\.clawdbot\clawdbot.json。用记事本打开你会看到里面已经有一个token字段那是网页端授权用的。模型通道的配置也在同一个文件里字段名可能是model、provider或者base_url这一类具体以你装的那个版本为准。你要做的是把base_url的值改成https://taotoken.net/api把api_key的值改成你从 TaoToken 控制台复制的那串 Keymodel填模型广场里对应的 ID。改完保存关掉记事本。3.2 方案二 WSL2Dockeropenclaw.json 与容器内配置如果你走的是 WSL2 Docker 方案配置文件在 Ubuntu 里的~/openclaw/.openclaw/openclaw.json。这个文件通过volumes挂载进了容器所以你在 Ubuntu 里改完容器里也能读到。路径是~/openclaw/.openclaw/openclaw.json打开方式可以用nano或者vim。同样找到模型提供商相关的字段把 Base URL 写成https://taotoken.net/apiKey 换成你自己的。如果你不想手动改文件也可以在 Ubuntu 终端里执行docker exec -it openclaw-container openclaw configure重新走一遍配置向导在模型提供商那一步填刚才的地址和 Key。3.3 改完配置后的重启顺序不管是方案一还是方案二改完配置都要让网关重新加载。方案一在 PowerShell 里执行openclaw gateway restart方案二在 Ubuntu 终端里执行docker-compose restart或者docker exec -it openclaw-container openclaw gateway restart。重启之后再用openclaw logs --follow看一眼日志确认没有报「invalid api key」或者「connection refused」这类错。4. 启动 openclaw gateway start用 18789 端口验证模型通道是否通4.1 网关启动与网页端授权令牌在 PowerShell 里执行openclaw gateway start等终端出现Gateway started successfully。然后打开浏览器访问http://127.0.0.1:18789。第一次访问会提示「未授权令牌缺失」。令牌在C:\Users\你的Windows用户名\.clawdbot\clawdbot.json里找token字段把引号里面的那串长字符复制出来粘贴到网页端点授权。WSL2 方案对应的令牌在~/openclaw/.openclaw/openclaw.json操作一样。4.2 在网页端发一条测试消息确认模型能应答授权通过后网页端会进入主界面。先别急着测文件管理先在对话窗口里发一句最简单的「你好请回复一个数字」。如果模型通道配通了你会看到它正常回复。这一步只验证模型连通性不涉及 Skill。如果这一步就报 401 或者一直转圈直接跳到第 5 节看排错。4.3 如果技能仍然无响应检查日志模型能回复之后再试一个基础技能比如让它在当前目录列个文件或者搜一条简单的网络信息。如果技能还是没反应在 PowerShell 里执行openclaw logs --follow看实时日志里有没有跟模型调用相关的错误。常见的有「model not found」说明 Model ID 写错了去模型广场核对还有「timeout」可能是网络或者 Base URL 写成了带/v1的地址。5. 排查401、404、端口 18789 占用与令牌缺失5.1 401 Unauthorized 与 Key / Base URL 写法401 基本就是 Key 的问题。先检查配置文件里api_key是不是还留着YOUR_API_KEY没换或者复制的时候多带了空格。再检查 Base URL 是不是https://taotoken.net/api末尾没有斜杠也没有/v1。如果你不小心把落地页的地址https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end填进了 Base URL那也会 401因为那个地址是给人看的不是 API 入口。5.2 404 与多余的 /v1 路径404 通常出现在 Base URL 多写了/v1的情况下。有些客户端会在你填的 Base URL 后面自动补/chat/completions如果你填的是https://taotoken.net/api/v1最终请求就变成了/api/v1/chat/completions路径对不上就 404。把 Base URL 改成https://taotoken.net/api就能解决。5.3 端口占用与 WSL2 网络隔离端口 18789 被占用时PowerShell 里执行netstat -ano | findstr :18789找到 PID在任务管理器里结束那个进程再启动网关。或者换一个端口openclaw gateway --port 8888访问地址也跟着改成http://127.0.0.1:8888。WSL2 方案如果 Windows 浏览器打不开网关先在容器里执行docker exec -it openclaw-container openclaw config set gateway.host 0.0.0.0重启容器然后在 Windows 防火墙里放行 18789 端口用http://localhost:18789访问不要用 WSL2 的 IP。6. 后续维护与用量核对6.1 openclaw update 与配置备份OpenClaw 更新比较频繁隔一段时间在 PowerShell 里跑一次openclaw update。更新前把clawdbot.json或者openclaw.json复制一份到别的目录免得新版本改了字段格式。另外 OpenClaw 权限比较高不建议在主力工作环境里裸奔最好在虚拟机或者独立的 Windows 账号里测试。数据目录也记得定期备份。6.2 在 TaoToken 控制台看这次调用的用量模型通道跑通、也发了测试消息之后回到 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 的控制台进「用量」或者「日志」页面看看刚才那几次调用有没有被记上。如果有记录说明从 OpenClaw 到 TaoToken 的整条链路是通的。如果一条记录都没有那说明请求根本没发出来回头检查 Base URL 是不是写错了。6.3 下一步模型对话、Coding Plan 与 Claude Code 接入想单独测试某个模型的回复质量可以直接用 TaoToken 模型对话。如果你打算长期用 AI 写代码可以看看 Coding Plan。需要再创建几把 Key 给不同工具用去 控制台 API Keys 新建。如果你同时在用 Claude Code环境变量的对照写法可以参考 Claude Code 接入文档里面写清楚了ANTHROPIC_BASE_URL该填什么。