1. 为什么要在 Windows 11 上折腾 openclaw 中文版openclaw 这个名字你可能还有点陌生但它的前身 clawdbot、moltbot 在开发者圈子里已经火了一整轮。简单说它是一个能跑在你本机的个人 AI 助手框架你给它配好模型通道它就能在终端里跟你对话、调用技能插件、通过 Web UI 聊天甚至挂上消息通道变成随叫随到的贾维斯。适合谁适合想在自己电脑上拥有一个可控、可扩展、数据不出本机的 AI 助手的开发者尤其是习惯命令行、又不想被各种云端订阅绑死的人。问题在于官方仓库在海外安装脚本拉取依赖时经常卡住模型认证又默认引导你去注册各种海外厂商账号一圈下来人还没用上耐心先耗光了。国内有热心开发者维护了中文分支终端提示、安装向导、Web UI 全部汉化安装流程也做了本地化处理体验顺滑很多。但即便如此模型通道这一环仍然是新手最容易翻车的地方——你要么去申请某个厂商的 Key要么面对一堆看不懂的认证跳转。这篇教程要解决的就是最后这一公里用 TaoToken 的统一 Key 和 API 通道把 openclaw 中文版的模型接入一次性打通。我会给出可直接复制的config.toml与settings.json配置骨架带你走完从安装、配置到验证对话连通性的完整流程。全程在 Windows 11 上操作命令都是实测可跑的。2. 前置准备Node 环境与 TaoToken 统一 Key2.1 确认 Node 版本openclaw 中文版要求 Node 24。先打开 PowerShell用管理员身份运行开始菜单搜 powershell右键以管理员身份运行然后执行node -v如果版本低于 24或者提示找不到命令去 Node 官网下载最新的 LTS 或 Current 版本装上。装完重开一个 PowerShell 窗口再验证一次这一步别偷懒版本不对后面安装脚本会直接报错退出。2.2 为什么用 TaoToken 而不是逐个厂商申请openclaw 的安装向导会问你模型/认证提供商默认推荐某个免费厂商但免费额度有限、模型选择也受限。如果你手上有多个厂商的 Key管理起来更麻烦每个 Key 的额度、限流、模型名都不一样配置里要写好几套。TaoToken 的思路是提供一个统一的 API 通道你只需要一个 Key就能在 openclaw 里调用多种模型。对 openclaw 这种需要频繁切换模型做测试的场景特别友好——改配置只改一个base_url和一个api_key不用来回换厂商。先去 TaoToken 官网注册账号https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content注册后在控制台创建 API Keyhttps://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite创建好的 Key 形如sk-xxxxxxxx先复制到记事本备用。注意这个 Key 只显示一次关掉页面就看不到了务必先存好。提示API 的基础地址是https://taotoken.net/api注意这个地址不带任何查询参数配置时直接填这个即可。3. 安装 openclaw 中文版并写入配置3.1 执行安装脚本在管理员 PowerShell 里执行中文版的安装脚本iwr -useb https://clawd.org.cn/install.ps1 | iex这一步会下载依赖、安装 CLI 工具视网络情况可能要等几分钟。安装完成后终端会自动进入入门向导如果没有自动进入手动执行openclaw-cn onboard --install-daemon向导里第一个问题是是否继续选 Yes。安装引导模式选快速开始。3.2 在向导里选择模型提供商到了模型/认证提供商这一步向导会列出几个选项。这里先随便选一个能继续往下走的比如默认推荐项因为我们要在向导结束后手动改配置文件把通道指向 TaoToken。向导里的认证跳转可以先跳过或取消不影响后续。后面的选择通道消息软件配置、配置技能、启用钩子这几步新手建议全部跳过或选 No等基础对话跑通了再回来加。最后向导会安装并启动 gateway 服务看到 TUI 或 Web 界面就说明服务起来了。3.3 找到配置文件位置openclaw 中文版的配置默认放在用户目录下的.openclaw文件夹里。在 PowerShell 里执行ls $env:USERPROFILE\.openclaw你会看到config.toml和settings.json这两个关键文件如果只有其中一个另一个可能是首次运行时生成的手动创建即可。下面给出两个文件的配置骨架。3.4 config.toml 配置骨架用记事本或 VS Code 打开config.toml把模型通道部分改成下面这样# openclaw 中文版主配置 [gateway] host 127.0.0.1 port 18789 [model] # 统一走 TaoToken 的 API 通道 provider openai-compatible base_url https://taotoken.net/api api_key sk-你的TaoToken密钥 model gpt-4o-mini temperature 0.7 max_tokens 4096 [agent] name Jarvis language zh-CN几个关键点说明provider填openai-compatible因为 TaoToken 的 API 兼容 OpenAI 的调用格式base_url就是前面说的https://taotoken.net/apimodel先填一个通用模型名跑通后再换成你想要的。api_key换成你自己的。3.5 settings.json 配置骨架settings.json主要管界面和运行时行为配置如下{ ui: { language: zh-CN, theme: dark, defaultView: web }, runtime: { autoStartGateway: true, logLevel: info }, model: { baseUrl: https://taotoken.net/api, apiKey: sk-你的TaoToken密钥, defaultModel: gpt-4o-mini }, skills: { enabled: [] } }注意settings.json里的model段和config.toml里的[model]段要保持一致避免两处配置打架。改完保存两个文件都用 UTF-8 编码别存成 GBK否则中文可能乱码。4. 启动服务并验证对话连通性4.1 重启 gateway 服务配置改完后需要重启 gateway 让新配置生效openclaw-cn gateway restart然后查看状态openclaw-cn gateway status正常的话会显示服务正在运行、监听端口 18789。如果显示 stopped执行openclaw-cn gateway start手动拉起。4.2 用 TUI 做第一次对话测试最直接的验证方式是在终端里对话openclaw-cn chat进入 TUI 后输入一句简单的话比如你好帮我用一句话介绍你自己。如果模型通道配对了几秒内就会返回中文回复。这一步能通说明 TaoToken 的 Key、base_url、模型名三者都对上了。4.3 用 Web UI 验证浏览器打开http://127.0.0.1:18789进入 Web 聊天界面。在输入框里发一条消息比如打开浏览器搜索今天的天气如果你配了相关技能或者简单问一句现在几点了。Web 端能正常收到回复说明 gateway 和模型通道都工作正常。4.4 用 curl 直接测 API 通道如果 TUI 和 Web 都没反应先用 curl 单独测一下 TaoToken 的通道是否通curl -X POST https://taotoken.net/api/v1/chat/completions -H Authorization: Bearer sk-你的TaoToken密钥 -H Content-Type: application/json -d {\model\:\gpt-4o-mini\,\messages\:[{\role\:\user\,\content\:\ping\}]}返回里如果有choices字段和一段回复内容说明 Key 和通道没问题问题出在 openclaw 的配置上如果返回 401 或 403说明 Key 填错了或没生效如果超时检查网络和 base_url 是否写对。5. 本篇常见报错排查5.1 安装脚本执行到一半卡住多半是网络问题。中文版脚本已经做了本地化但部分依赖仍从公共源拉取。可以重试一次或者换个时间段再试。如果反复卡在同一处检查 PowerShell 是否以管理员身份运行以及系统代理设置是否干扰了脚本。5.2 gateway 启动失败端口被占用报错里如果出现EADDRINUSE说明 18789 端口被别的程序占了。改config.toml里的port为其他值比如 18790然后重启 gateway。改完记得 Web UI 地址也要跟着换端口。5.3 对话返回 401 Unauthorized九成是api_key填错。检查三点Key 有没有复制完整前后不能有空格、有没有把sk-前缀漏掉、config.toml和settings.json两处的 Key 是否一致。改完重启 gateway。5.4 对话返回 model not foundmodel字段填的模型名 TaoToken 那边不认。去 TaoToken 的文档页确认当前支持的模型名列表https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite把config.toml和settings.json里的模型名都换成列表里存在的重启服务再试。5.5 中文乱码配置文件存成了 GBK 编码。用 VS Code 打开右下角编码切到 UTF-8另存一次。终端如果也乱码在 PowerShell 里执行chcp 65001切到 UTF-8 代码页。5.6 Web UI 打不开但 TUI 正常gateway 可能只监听了本地回环但端口不对或者浏览器缓存了旧页面。先openclaw-cn gateway status确认端口再用http://127.0.0.1:端口访问别用localhost有时会解析到 IPv6 导致连不上。6. 后续扩展与 Key 管理建议基础对话跑通后你可以回到向导里补配消息通道、技能插件和钩子。技能插件能让 openclaw 调用天气、搜索、文件操作等能力消息通道则能让它接入飞书等平台变成真正的随叫随到。这些扩展都建立在模型通道稳定的前提上所以先把 TaoToken 这条线跑顺后面加功能会省心很多。关于 Key 管理给你两个实用建议。第一把config.toml和settings.json里的 Key 抽出来放到环境变量里配置文件里用占位符引用这样分享配置或备份时不会泄露 Key。第二TaoToken 控制台里可以创建多个 Key 分别用于不同用途比如一个专门给 openclaw 用一个给其他项目用方便单独查看用量和随时吊销。如果你打算长期跑 openclaw 做编码辅助或 Agent 任务可以了解一下 Coding Plan它针对高频调用场景做了额度优化https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite想先体验一下模型对话效果、确认通道质量可以直接在模型对话页测试https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel-chatutm_campaignrewrite需要管理或新建更多 API Key去控制台https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite接入过程中遇到配置问题文档页有完整的参数说明和示例https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite最后提醒一句openclaw 的 gateway 默认只监听本地别为了图方便把它暴露到公网个人助手跑在本机最安全。配置改完记得重启服务很多改了没生效的问题都是忘了重启。