1. Windows 上装 OpenClaw,为什么总卡在 GitHub 和 Node.js
如果你最近在 Windows 上折腾 OpenClaw,大概率遇到过这两种情况:一是安装脚本第一步就去拉 GitHub 仓库,网络一抖直接超时;二是提示缺 Node.js,装完 Node 又发现版本不对,npm 依赖装到一半报错。我身边不少朋友就是在这一步放弃的,明明只是想本地跑个智能体,结果一半时间花在配环境上。
OpenClaw 本身是个开源智能体框架,能对接微信、飞书、钉钉这类通讯工具,让 AI 帮你处理消息、跑任务。它适合想在自己电脑或云服务器上搭一套私有智能体的人,尤其是 Windows 用户。但原生安装流程对国内网络环境不太友好,GitHub 拉取和 Node.js 依赖是两个高频卡点。
这篇要讲的思路是:绕开 GitHub 直连和 Node.js 手动安装,用 TaoToken 统一 Key 和 API 通道,把 OpenClaw 在 Windows 上跑通。核心交付三样东西——一份可复制的config.toml骨架、一段settings.json配置片段,以及安装后的连通性验证动作。全程 PowerShell 操作,不需要你提前装 Node.js,也不需要能稳定访问 GitHub。
先说清楚适用场景:你有一台 Windows 10/11 或 Windows Server,能联网,想快速把 OpenClaw 跑起来并接上模型。下面按步骤来,每一步都给完整命令和参数说明。
2. 前置准备:TaoToken 统一 Key 与 API 通道
OpenClaw 要调用大模型,必须有一个能用的 API Key 和对应的接口地址。传统做法是去各家模型厂商分别注册、分别拿 Key,配置里还要区分不同供应商的 endpoint,很碎。TaoToken 的作用是把这些统一成一个 Key、一个 API 通道,OpenClaw 里只配一次就行。
你需要先拿到两样东西:
- 一个 API Key:登录后在控制台的 API Keys 页面创建,格式通常是一串以
sk-开头的字符串。 - 接口地址:统一用
https://taotoken.net/api,注意这个地址不带任何查询参数,直接填进配置即可。
创建 Key 的入口在这里:
API Keys 管理页:https://taotoken.net/console/api-keys?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=openclaw_windows
拿到 Key 之后先别急着关页面,后面配置config.toml和settings.json都要用到。如果你还没决定用哪个模型,可以先去模型对话页面试一下,确认通道能正常返回再往下走:
模型对话体验:https://taotoken.net/models?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=openclaw_windows
这一步的关键认知是:OpenClaw 不关心你背后用的是哪家模型,它只认一个 base_url 和一个 api_key。TaoToken 把多供应商的差异收敛到服务端,客户端配置就变得极简。这也是后面能绕开 Node.js 依赖的前提——配置越简单,安装脚本要处理的分支就越少。
3. 可复制配置:config.toml 骨架与 settings.json 片段
OpenClaw 的配置分两层:config.toml管网关、通道和模型供应商,settings.json管运行时的一些开关和路径。下面这份骨架可以直接复制,把占位符替换成你自己的值。
3.1 config.toml 骨架
# OpenClaw 主配置 [gateway] host = "127.0.0.1" port = 18888 [model] provider = "taotoken" base_url = "https://taotoken.net/api" api_key = "sk-你的Key粘贴到这里" model_name = "qwen3.6-plus" [channels.wechat] enabled = true mode = "qr" [log] level = "info" path = "C:\\Users\\你的用户名\\.openclaw\\logs"几个参数说明一下。gateway段保持默认的127.0.0.1:18888就行,这是本地回环地址,不对外暴露。model段的provider填taotoken,base_url固定为https://taotoken.net/api,api_key换成你刚创建的那串。model_name按你实际要用的模型填,比如qwen3.6-plus。channels段先只开微信,其他通道等跑通后再加。log.path里的用户名换成你自己的 Windows 账户名,路径用双反斜杠转义。
3.2 settings.json 片段
{ "runtime": { "skip_node_check": true, "skip_git_check": true, "install_source": "mirror" }, "network": { "timeout_seconds": 60, "retry": 3 }, "onboard": { "completed": false } }skip_node_check和skip_git_check设为true,是让安装器跳过对 Node.js 和 Git 的强制检测,这样你机器上没装这两个也能继续。install_source设为mirror表示走镜像源拉取组件,避免直连 GitHub。network.timeout_seconds给到 60 秒,retry给 3 次,网络抖动时能自动重试。onboard.completed先留false,等初始化向导走完会自动改写。
把这两个文件放到 OpenClaw 的配置目录,Windows 下默认是C:\Users\你的用户名\.openclaw\。如果目录不存在,手动建一下即可。
4. 安装与验证:从 PowerShell 到收到机器人回复
配置准备好之后,安装和验证分四步走。全程在管理员权限的 PowerShell 里操作。
4.1 一键安装
按 Win 键,输入 PowerShell,右键选择“以管理员身份运行”。然后执行安装命令:
$env:OPENCLAW_MIRROR="https://taotoken.net/api" irm https://app.openclaw.ai/scripts/install.ps1 | iex这里把镜像环境变量指向 TaoToken 的 API 地址,安装脚本会从镜像拉取组件,不再直连 GitHub。执行过程中你会看到下载进度和组件解压日志,正常情况下两三分钟结束。
4.2 初始化配置
安装完成后,启动配置检测和向导:
openclaw setup openclaw onboardsetup会读取你之前放的config.toml,校验字段格式。onboard进入交互式向导,依次确认智能体名称(默认main即可)、模型供应商(选taotoken)、API Key(粘贴你创建的那串,输入时不显示,保持英文输入法)。模型版本按你config.toml里填的选。
4.3 启动网关
openclaw gateway start看到Gateway started就表示网关起来了。此时本地127.0.0.1:18888已经在监听。
4.4 连通性验证
打开微信,扫码添加向导里提示的机器人,提示创建成功后回到 PowerShell。给机器人发任意一条消息,你会收到一个配对码。执行配对:
openclaw channels pair 你的配对码再次用微信发消息,机器人正常回复,说明整条链路通了:微信 → 本地网关 → TaoToken API → 模型 → 原路返回。这一步能收到回复,就证明 Key、base_url、模型名三者都配对了。
如果你更想先在网页端确认模型通道本身没问题,可以打开模型对话页面发一条测试消息,对比一下返回是否正常:
模型对话验证:https://taotoken.net/models?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=openclaw_windows
5. 本篇常见错排查
装的过程中最容易碰到下面几类问题,按现象对号入座。
现象一:安装脚本卡在下载,超过 60 秒无响应。先看日志:
openclaw logs如果日志里出现timeout或connection refused,检查settings.json里的install_source是否为mirror,以及network.timeout_seconds是否够大。另外确认 PowerShell 是以管理员身份运行的,普通权限可能写不进配置目录。
现象二:openclaw gateway start报端口占用。18888 被别的程序占了。改config.toml里gateway.port为 18889 或其他空闲端口,然后重启网关。改完记得同步检查防火墙有没有拦本地回环,一般不用动。
现象三:微信发消息没反应,也收不到配对码。先确认网关进程还在跑,openclaw logs看有没有channel disconnected。常见原因是扫码后机器人没真正创建成功,重新执行openclaw channels pair流程。另外确认config.toml里channels.wechat.enabled是true。
现象四:模型返回 401 或 403。基本是 API Key 的问题。检查config.toml里api_key有没有多余空格,粘贴时是否漏字符。Key 失效就去控制台重新创建一个:
重新创建 Key:https://taotoken.net/console/api-keys?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=openclaw_windows
现象五:提示模型不存在。model_name拼写和实际模型 ID 不一致。去模型对话页面确认可用的模型标识,再回填到config.toml。
排查顺序建议固定为:先看日志,再查配置字段,最后验 Key。大部分问题出在配置字段的拼写和空格上,而不是网络本身。
6. 长期跑编码和 Agent 任务,怎么配更省心
如果你只是偶尔用 OpenClaw 处理消息,上面这套配置就够了。但如果你打算让它长期跑编码任务、接 Agent 工作流,调用量会明显上去,这时候按量计费的方式可能不够划算,也更难控制成本。
TaoToken 的 Coding Plan 是面向长期编码和 Agent 场景的订阅方案,适合把 OpenClaw 当日常工具用的人。配置方式不变,还是同一个 base_url 和 Key,只是计费模式换成订阅,调用时不用每次算 token。
Coding Plan 入口:https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=openclaw_windows
接入文档里有各语言 SDK 和 OpenClaw 这类客户端的对接示例,遇到字段不确定的时候翻一下比猜快:
接入文档:https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=openclaw_windows
最后给一个实用习惯:把config.toml和settings.json备份一份到别的目录。OpenClaw 升级或重装时,配置文件可能被覆盖,有备份直接拷回来,省得重新走一遍向导。网关日志建议定期清理,log.path那个目录下的文件攒多了会占空间,设个每月清理的计划任务就行。