Windows 下 openclaw-cn 一键启动脚本：gateway 后台常驻 + TUI 界面配置 TaoToken

1. Windows 下 openclaw-cn 启动的痛点与场景如果你在 Windows 上跑 openclaw-cn大概率遇到过这种尴尬双击一个 bat 脚本黑框一闪而过gateway 到底起没起完全不知道或者 gateway 窗口和 TUI 窗口挤在一起关掉一个另一个也跟着没了。更麻烦的是bat 脚本在不同电脑上编码不一致UTF-8 和 GBK 混着来中文路径直接乱码报错。openclaw-cn 本身是一个带 gateway 网关和 TUI 交互界面的工具gateway 负责后台常驻处理请求TUI 负责给你一个可视化的操作入口。理想状态是gateway 在后台安静跑着TUI 正常弹出来收发消息关掉 TUI 之后 gateway 依然存活下次想用再开 TUI 就行。但 Windows 默认的 cmd 窗口机制很难做到这一点因为start命令拉起的进程和父窗口有绑定关系父窗口一关子进程容易被带走。我试过用 bat 写start /b来隐藏窗口结果发现不同 Windows 版本行为不一致有的机器上 gateway 确实隐藏了有的机器上还是弹窗而且 bat 文件保存成 UTF-8 带 BOM 之后某些老版本 cmd 解析中文路径直接失败。后来换成 VBS 脚本问题一次性解决VBS 由 Windows Script Host 执行不依赖 cmd 的编码环境WshShell.Run的第二个参数可以精确控制窗口显示模式0 是隐藏1 是正常显示而且脚本执行完自己退出不留任何残留窗口。这篇内容适合三类人一是刚接触 openclaw-cn、想在 Windows 上快速跑起来的开发者二是已经被 bat 脚本编码问题折磨过、想找个稳定方案的人三是需要把 gateway 做成后台服务、TUI 作为日常入口的长期使用者。下面我会给出完整的 VBS 脚本、gateway 常驻参数、TUI 配置以及把 TaoToken 统一 Key 写进配置文件的步骤最后附上重启后的验证方法。2. TaoToken 前置准备统一 Key 与 API 通道openclaw-cn 的 gateway 需要对接模型服务TaoToken 在这里扮演的是统一 Key 和 API 通道的角色。你不需要在 openclaw-cn 里分别配置多个厂商的 Key而是把 TaoToken 的 API 地址和 Key 写进配置文件gateway 启动后所有模型请求都走这个通道。先拿到 Key。打开 TaoToken 官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册登录后进入控制台在 API Keys 页面创建一个新 Key。建议给这个 Key 起个能识别的名字比如openclaw-win-gateway方便后面排查问题时区分。创建完成后复制 Key格式通常是一串以sk-开头的字符串。这个 Key 只显示一次先粘贴到记事本里备用。接下来确认 API 通道地址。TaoToken 的 API 入口是 https://taotoken.net/api 这个地址不加任何 UTM 参数直接作为 base_url 使用。openclaw-cn 的配置文件里需要填两个东西api_base填https://taotoken.net/apiapi_key填你刚才复制的 Key。如果你还没装 openclaw-cn先通过 npm 全局安装npm install -g openclaw-cn安装完成后执行openclaw-cn --version确认版本。然后找到配置文件目录Windows 下通常在%USERPROFILE%\.openclaw-cn\config.json。如果文件不存在手动创建{ gateway: { port: 18789, host: 127.0.0.1 }, model: { api_base: https://taotoken.net/api, api_key: sk-你的Key粘贴在这里, default_model: claude-sonnet-4-20250514 } }注意api_base末尾不要加/v1或其他路径TaoToken 的 API 入口已经包含了正确的路由前缀。多写一层会导致 404。保存文件后可以先手动跑一次 gateway 确认配置生效openclaw-cn gateway --port 18789 --verbose如果终端输出里出现gateway listening on 127.0.0.1:18789并且没有报鉴权错误说明 Key 和通道都通了。按 CtrlC 停掉接下来用 VBS 脚本把它做成后台常驻。3. 可复制的 VBS 启动脚本与 gateway 常驻参数VBS 脚本的核心思路很简单用WScript.Shell的Run方法启动 gateway窗口模式设为 0隐藏然后等几秒让 gateway 完成初始化再以窗口模式 1正常显示启动 TUI最后脚本自己退出。这样 gateway 在后台独立运行TUI 作为前台交互界面两者互不干扰。新建一个文本文件把下面内容完整粘贴进去然后重命名为直接启动.vbs。注意扩展名必须是.vbs不是.vbs.txt。 直接启动脚本 - VBScript版本无弹框 Set WshShell CreateObject(WScript.Shell) 启动网关隐藏窗口后台常驻 WshShell.Run openclaw-cn gateway --port 18789 --verbose, 0, False 等待3秒让gateway完成端口绑定和初始化 WScript.Sleep 3000 启动TUI正常窗口显示 WshShell.Run openclaw-cn tui, 1, False 静默退出不残留脚本进程 WScript.Quit这段脚本里几个关键点值得展开说。Run方法的第一个参数是命令行字符串第二个参数是窗口模式第三个参数是是否等待命令执行完成。gateway 那行用0, False意思是隐藏窗口且不等待这样 gateway 在后台跑起来后脚本继续往下走。TUI 那行用1, False正常显示窗口且不等待TUI 弹出来后脚本就执行到WScript.Quit退出了。WScript.Sleep 3000这个等待时间不是随便写的。gateway 启动需要加载配置、绑定端口、初始化模型通道实测在普通 Windows 机器上大约 1.5 到 2 秒完成。给 3 秒是留了余量避免 TUI 启动时 gateway 还没就绪导致连接失败。如果你的机器比较慢可以改成 5000。gateway 的常驻参数里--port 18789指定监听端口这个端口要和配置文件里的gateway.port一致。--verbose开启详细日志方便排查问题。如果你不想每次启动都输出日志可以把--verbose去掉但建议第一次配置时保留确认没问题后再关。双击直接启动.vbs之后你应该看到 TUI 窗口弹出来而 gateway 没有任何窗口。打开任务管理器在“详细信息”标签页里能看到openclaw-cn.exe或node.exe进程在跑这就是后台的 gateway。停止 gateway 用openclaw-cn gateway stop检查状态用openclaw-cn gateway status如果status返回running并且端口是 18789说明常驻成功。4. 验证请求重启后检查 gateway 存活与 TUI 收发配置写完不算完得验证重启之后 gateway 还能不能自动存活。这里有个细节VBS 脚本本身不会开机自启你需要把直接启动.vbs的快捷方式放到 Windows 启动目录里路径是%APPDATA%\Microsoft\Windows\Start Menu\Programs\Startup。放进去之后每次登录系统会自动执行脚本gateway 在后台起来TUI 窗口弹出。验证步骤分三步。第一步重启电脑登录后等 10 秒打开任务管理器确认 gateway 进程存在。第二步在 TUI 里发一条测试消息比如输入你好请回复当前使用的模型名称看是否能正常收到响应。第三步关掉 TUI 窗口再次打开任务管理器确认 gateway 进程依然在跑然后重新双击直接启动.vbsTUI 能重新连上 gateway 并继续收发消息。如果 TUI 里发消息报连接错误先用openclaw-cn gateway status看 gateway 状态。如果显示not running说明 gateway 没起来检查 VBS 脚本里的命令行路径是否正确。有时候openclaw-cn不在系统 PATH 里VBS 找不到命令需要在脚本里写完整路径比如WshShell.Run C:\Users\你的用户名\AppData\Roaming\npm\openclaw-cn.cmd gateway --port 18789 --verbose, 0, False注意路径里有空格时要用双引号包起来VBS 里双引号需要转义成两个双引号。验证模型通道是否走 TaoToken可以在 TUI 里发一条消息后去 TaoToken 控制台的用量页面看请求记录。如果能看到对应的请求时间和模型名称说明通道配置正确。这一步很关键因为有时候 gateway 起来了但 Key 没生效TUI 会报鉴权失败而控制台的请求记录能帮你快速定位是 Key 问题还是网络问题。5. 本篇常见错排查错误一双击 VBS 没反应TUI 不弹窗。最常见的原因是openclaw-cn不在 PATH 里。VBS 的Run方法执行命令时用的是系统环境变量如果你是在某个终端里临时加的 PATHVBS 读不到。解决办法是在脚本里写完整路径或者把 openclaw-cn 的安装目录加到系统环境变量里重启后再试。错误二gateway 起来了但 TUI 连不上报ECONNREFUSED 127.0.0.1:18789。这说明 gateway 没在监听 18789 端口。先检查配置文件里的gateway.port和 VBS 脚本里的--port是否一致。然后检查是否有其他程序占用了 18789 端口用netstat -ano | findstr 18789查看。如果端口被占用换一个端口比如 18790同时改配置文件和脚本。错误三TUI 发消息报 401 或鉴权失败。这是 TaoToken Key 的问题。检查配置文件里的api_key是否完整复制有没有多余空格。然后确认api_base是https://taotoken.net/api没有多写/v1。如果 Key 没问题去 TaoToken 控制台看 Key 是否被禁用或额度用完。错误四重启后 gateway 没自动起来。检查启动目录里的快捷方式是否指向正确的 VBS 文件。有时候快捷方式的目标路径会变尤其是你把 VBS 文件移动过位置。另外Windows 的启动目录执行时机是在用户登录后如果你用的是自动登录可能需要等几秒脚本才执行。错误五VBS 脚本报“没有权限”或“找不到文件”。这通常是编码问题。VBS 文件保存时要用 ANSI 编码不要用 UTF-8 带 BOM。用记事本另存为时编码选“ANSI”。如果路径里有中文确保系统区域设置支持中文否则把 VBS 文件和 openclaw-cn 都放到纯英文路径下。错误六gateway 进程过一段时间自己消失了。检查是否开了 Windows 的“节能模式”或“快速启动”这些设置可能会在系统空闲时挂起后台进程。另外如果 gateway 崩溃--verbose日志会记录原因可以在%USERPROFILE%\.openclaw-cn\logs下找日志文件。常见崩溃原因是模型请求超时或内存不足可以适当调大 gateway 的超时参数。6. 长期使用建议与 CTA如果你只是偶尔用一下VBS 脚本加启动目录就够了。但如果你打算把 openclaw-cn 作为日常编码或 Agent 任务的常驻工具建议把 gateway 注册成 Windows 服务这样不依赖用户登录开机就能跑。不过服务方式配置起来更复杂涉及nssm或sc命令新手先用 VBS 方案跑通再说。TaoToken 的 Key 建议定期轮换尤其是在多人共用一台机器的情况下。控制台里可以给 Key 设置额度上限避免意外超额。如果你需要长期跑编码任务或 Agent 工作流可以看看 TaoToken 的 Coding Plan它针对高频调用场景做了优化比按量计费更划算。入口在 https://taotoken.net/api 对应的控制台里能找到。日常排查问题时记住两个命令openclaw-cn gateway status看 gateway 活没活openclaw-cn gateway stop停掉后台进程。TUI 里如果遇到模型响应慢先确认 TaoToken 控制台的请求记录看是通道问题还是模型本身的问题。配置文件和 VBS 脚本建议备份一份换机器时直接复制过去改一下路径就能用。