1. Windows 安装 OpenClaw 前，先把 npm、Git、SSH 这三件事理顺

OpenClaw 是一个可以在本地跑起来的 AI Agent 运行环境，支持接入多种大模型、IM 机器人和技能插件，适合想在 Windows 上折腾本地智能助手、又不想被复杂环境劝退的人。它的安装流程本身不复杂，真正卡人的地方往往在 npm 全局目录权限、Git 拉取时的 SSH 认证，以及初始化阶段模型 API Key 的填写方式。这篇就把 Windows 安装 OpenClaw 的完整链路拆开讲，从 npm 依赖、Git 配置、SSH 密钥，到 config.toml 骨架和 TaoToken 统一 Key 接入，每一步都给可复制的命令。

我自己的机器是 Windows 11，PowerShell 和 CMD 混着用，踩过的坑主要集中在两处：一是 npm 全局安装时 optional 依赖编译失败，二是 onboard 初始化时没给管理员权限导致守护进程起不来。下面按顺序来，你跟着敲基本不会偏。

先明确一下整体路径：装 Node.js 和 npm → 装 Git 并配好 SSH → 用 npm 全局装 OpenClaw → 管理员权限跑 onboard 初始化 → 填模型 API Key（这里用 TaoToken 统一通道）→ 验证本地服务 → 排查常见报错。整个流程大概 20 到 30 分钟，取决于网络和依赖下载速度。

需要提前准备的东西：一台 Windows 10/11 电脑，能正常访问 npm registry，一个可用的模型 API Key（后面会讲怎么用 TaoToken 统一管理），以及管理员权限的终端窗口。如果你之前装过 Node.js 但版本很老，建议先升级到 18 以上，OpenClaw 对 Node 版本有要求，低于 18 会在安装阶段直接报 engine 不匹配。

另外提醒一句，OpenClaw 的初始化向导里会让你选模型、选 IM 接入方式、选技能和 memory，新手直接选 QuickStart，别去碰高级配置，那个是给熟悉整套架构的人准备的。选错了我见过有人卡在插件依赖上半小时出不来。

1.1 安装 Node.js 与 npm 依赖环境

Windows 上装 Node.js 最省事的方式是去官网下 LTS 安装包，一路下一步，安装时勾选“Add to PATH”。装完打开新的 PowerShell 窗口，敲：

node -v npm -v

能分别打印出版本号就说明环境变量生效了。如果提示node 不是内部或外部命令，八成是装完没重开终端，或者 PATH 没勾上，重装一遍勾选即可。

Node 版本建议 18.17 以上，我用的是 20.x LTS。版本太低会在npm install -g openclaw时报Unsupported engine。升级 Node 可以直接下新版安装包覆盖，也可以用 nvm-windows 管理多版本，但新手不建议一上来就上 nvm，多一层变量容易乱。

npm 本身随 Node 一起装好，但国内网络下建议换一下 registry，不然全局安装会慢到怀疑人生：

npm config set registry https://registry.npmmirror.com npm config get registry

第二条命令用来确认是否切换成功。切回官方源用npm config set registry https://registry.npmjs.org。这一步不是必须，但能明显减少超时概率。

1.2 安装 Git 并生成 SSH 密钥

Git 在 Windows 上同样去官网下安装包，安装时建议选“Use Git from the Windows Command Prompt”，这样 CMD 和 PowerShell 里都能直接用 git 命令。装完验证：

git --version

接下来配 SSH。SSH 密钥的作用是让你在拉取私有仓库或走 git 协议时免密认证。先生成一对密钥：

ssh-keygen -t ed25519 -C "your_email@example.com"

一路回车，默认存到C:\Users\你的用户名\.ssh\id_ed25519。然后启动 ssh-agent 并把私钥加进去（PowerShell 管理员窗口执行）：

Get-Service ssh-agent | Set-Service -StartupType Automatic Start-Service ssh-agent ssh-add $env:USERPROFILE\.ssh\id_ed25519

公钥在id_ed25519.pub里，用记事本打开复制内容，粘贴到你 Git 托管平台的 SSH Keys 设置页。验证连通性：

ssh -T git@github.com

看到类似Hi xxx! You've successfully authenticated就说明 SSH 通了。这一步很多人跳过，结果后面 OpenClaw 拉插件仓库时卡在认证上，回头再补更麻烦。

1.3 用 npm 全局安装 OpenClaw

环境齐了就可以装 OpenClaw 本体。官方推荐的命令是：

npm install -g openclaw@latest --omit=optional --legacy-peer-deps

这里两个参数值得说清楚。--omit=optional是跳过可选依赖，主要是本地模型相关的插件，这些插件在配置一般的电脑上编译容易报错，直接导致整个安装失败；如果你不用本地模型，跳过完全没影响。--legacy-peer-deps是让 npm 用旧版的 peer 依赖解析策略，避免新版 npm 因为 peer 冲突直接中断安装。

装完验证：

openclaw --version

能打印版本号就说明全局命令注册成功。如果提示找不到命令，检查 npm 全局 bin 目录有没有在 PATH 里，用npm config get prefix看路径，把它加到系统环境变量。

2. TaoToken 前置：用统一 Key 和 API 通道接管模型配置

OpenClaw 初始化时会让你选模型并填 API Key，如果你同时想用多个模型，一个个去各家平台申请 Key、记不同 Base URL 会很乱。TaoToken 在这里的作用就是提供一个统一的 API 通道，你只需要一个 Key，就能在 OpenClaw 里切换不同模型，配置也集中在一处。

它的定位是模型 API 的统一入口，适合需要频繁切换模型、或者不想在多个平台之间来回折腾 Key 的人。对 OpenClaw 这种支持多模型接入的工具来说，把 Base URL 指向统一通道，后续换模型只改一个 Model ID，不用动 Key 和地址。

2.1 获取 TaoToken API Key

先到官网了解整体能力，地址是 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 。注册登录后进入控制台，在 API Keys 页面创建一个新 Key。创建时给它起个能认出来的名字，比如openclaw-local，方便后面区分用途。

创建完把 Key 复制下来，格式通常是一串以特定前缀开头的字符串。这个 Key 只显示一次，丢了只能重建，所以先存到安全的地方。注意不要把它提交到 Git 仓库或者贴到公开地方。

如果你还没想好具体用哪个模型，可以先在模型对话页面试几个，确认效果和响应速度再决定 OpenClaw 里默认用哪个。模型对话入口在 https://taotoken.net/api ，登录后可以直接对话测试。

2.2 确认 Base URL 与 Model ID

TaoToken 的 API 基础地址是：

https://taotoken.net/api

注意这个地址不带任何查询参数，是纯粹的 API 端点。在 OpenClaw 的配置里，Base URL 就填这个。Model ID 则根据你想用的模型来填，具体可用的模型列表在控制台或文档里能查到，填的时候要和平台上的标识完全一致，大小写错了会报模型不存在。

这里有个容易混的点：官网地址带 UTM 参数是给推广归因用的，API 地址不要带这些参数，否则请求可能被当成异常流量。配置时严格区分这两个地址。

2.3 在 OpenClaw 中接入统一通道

OpenClaw 的模型配置最终会落到 config.toml 里。初始化向导里选择“现在粘贴 API Key”时，把 TaoToken 的 Key 贴进去；如果向导里让你填 Base URL，就填https://taotoken.net/api。如果向导没问 Base URL，就等初始化完成后手动改 config.toml，下一节会给完整骨架。

这样配的好处是：以后你想从 A 模型换到 B 模型，只改 config.toml 里的 model 字段，Key 和 Base URL 都不用动。对经常做模型对比的人来说省事很多。

3. 可复制配置：config.toml 骨架与 SSH 相关设置

OpenClaw 初始化完成后会在用户目录下生成配置文件，Windows 上通常在C:\Users\你的用户名\.openclaw\config.toml。下面给一份可直接改用的骨架，把模型部分指向 TaoToken 统一通道，其他字段按需调整。

# OpenClaw 主配置 [general] # 本地服务监听地址与端口 host = "127.0.0.1" port = 18789 # 日志级别：debug / info / warn / error log_level = "info" [model] # 使用 TaoToken 统一 API 通道 provider = "openai-compatible" base_url = "https://taotoken.net/api" api_key = "sk-你的TaoTokenKey" # 默认模型，按控制台可用列表填写 model = "你的ModelID" # 请求超时（秒） timeout = 60 [model.params] temperature = 0.7 max_tokens = 4096 [daemon] # 守护进程，onboard 时选 yes 会启用 enabled = true # 开机自启 auto_start = true [skills] # 技能目录，初始化时选本地路径则填这里 path = "C:/Users/你的用户名/.openclaw/skills" enabled = true [memory] enabled = true # 记忆存储路径 path = "C:/Users/你的用户名/.openclaw/memory" [search] # 联网搜索，暂不配置则保持 false enabled = false

几个关键点说明。provider填openai-compatible是因为 TaoToken 走的是兼容 OpenAI 的接口协议，OpenClaw 能直接识别。base_url严格填https://taotoken.net/api，不要加斜杠结尾之外的任何东西。api_key换成你自己的。model填你在控制台确认过的 Model ID。

如果你在初始化时选了飞书接入，config.toml 里还会多出[feishu]段，包含 app_id、app_secret 和连接方式。连接方式选 websocket 的话，长连接模式不需要公网回调地址，本地开发很方便。飞书那段配置建议单独放，别和模型配置混在一起，改的时候不容易看花眼。

SSH 相关的配置不在 config.toml 里，而在.ssh目录。如果你需要 OpenClaw 通过 git 拉取技能仓库，确保 ssh-agent 在跑、私钥已 add，并且ssh -T能通。Windows 上 ssh-agent 服务默认可能是手动启动，前面已经设成自动了，重启后不用再手动开。

改完 config.toml 记得保存为 UTF-8 编码，Windows 记事本默认可能是 GBK，中文注释会乱码，建议用 VS Code 或 Notepad++ 编辑。

4. 验证请求：从本地服务到模型调用的完整链路

配置写完不能只看文件，得实际跑一遍确认链路通。验证分三层：本地服务是否起来、模型 API 是否通、IM 机器人是否配对成功。

4.1 启动 OpenClaw 并检查本地服务

初始化时如果选了安装守护进程，OpenClaw 会自动在后台跑。手动启动或重启用：

openclaw start

查看状态：

openclaw status

正常会显示 running 和监听端口。然后浏览器访问：

http://127.0.0.1:18789/

能看到聊天界面就说明本地服务正常。如果打不开，先看openclaw status是不是 running，再看端口有没有被占用：

netstat -ano | findstr 18789

有占用就改 config.toml 里的 port，或者把占用进程结束掉。

4.2 用 curl 验证模型 API 通道

在确认 OpenClaw 能调模型之前，先用 curl 直接打 TaoToken 的接口，排除配置问题：

curl https://taotoken.net/api/v1/chat/completions ^ -H "Content-Type: application/json" ^ -H "Authorization: Bearer sk-你的TaoTokenKey" ^ -d "{\"model\":\"你的ModelID\",\"messages\":[{\"role\":\"user\",\"content\":\"你好\"}]}"

Windows CMD 里换行用^，PowerShell 里用反引号。返回里有choices数组和内容，就说明 Key、Base URL、Model ID 三者都对。如果返回 401，是 Key 问题；返回模型不存在，是 Model ID 写错；连接超时，检查网络和 Base URL。

这一步过了，再回 OpenClaw 界面发一条消息，能正常回复就说明整条链路通了。

4.3 飞书机器人配对与验证

如果你接了飞书，配置完事件和长连接后需要重新发布机器人版本才生效。然后在飞书里 @ 机器人，会收到一个配对码。用管理员 CMD 执行：

openclaw pairing approve feishu 你的配对码

提示配对成功后，再 @ 机器人就能正常对话了。如果配对码一直不出现，检查飞书应用的事件订阅是否加了消息接收事件、长连接是否开启、机器人是否已发布。

5. 本篇常见错排查：401、local proxy failed、reading choices 与 OAuth

安装和接入过程中有几类报错出现频率特别高，这里逐个对照。

401 Unauthorized：最常见。先确认 config.toml 里的 api_key 是不是完整复制，有没有多余空格。再确认 Base URL 是不是https://taotoken.net/api，写成官网地址会 401。如果 Key 刚重建过，旧 Key 会失效，换新的。

local proxy failed：通常是本地代理或网络层拦截导致。检查系统代理设置，确认没有把taotoken.net走异常路由。另外 ssh-agent 没起来时，某些走 git 的插件加载也会报类似错误，确认Get-Service ssh-agent是 Running。

reading choices 报错：这个一般出现在模型返回结构不符合预期时。原因多是 Model ID 填错，或者 provider 没填openai-compatible。检查 config.toml 的[model]段，确认 provider、base_url、model 三个字段一致。

OAuth 相关报错：如果你在初始化时选了需要 OAuth 的接入方式，但回调地址没配好，会卡在授权环节。本地开发建议先用 API Key 方式，别一上来就 OAuth。已经选了的，回 config.toml 改成 Key 方式重新启动。

npm 安装时报 peer 依赖冲突：确认命令里带了--legacy-peer-deps。如果还报，先npm cache clean --force再重装。

onboard 初始化后启动不了：九成是没用管理员权限的终端。关掉当前窗口，用管理员身份重开 CMD，再跑openclaw onboard --install-daemon。

飞书配对码不生效：确认机器人已重新发布，事件订阅里有消息事件，长连接模式已开。配对码有时效，过期了重新 @ 获取。

排查思路统一是：先看报错关键词，再对照配置文件的对应字段，最后用 curl 单独验证 API 通道。把变量一个个隔离，比盲目重装快得多。

6. 后续接入与统一通道的持续使用

环境跑起来之后，日常使用主要围绕两件事：模型切换和技能扩展。模型切换在 config.toml 里改model字段就行，Key 和 Base URL 保持 TaoToken 统一通道不变，改完openclaw restart生效。技能扩展把插件放到 skills 目录，在配置里确认enabled = true。

如果你打算长期跑 Agent 类任务，比如让 OpenClaw 持续处理消息、调用工具，建议把守护进程和开机自启都打开，省得每次手动启动。Coding Plan 这类长期编码场景，可以在 https://taotoken.net/api 里看模型对话和额度情况，确认通道稳定。

API Key 的管理集中在控制台，地址是 https://taotoken.net/api ，需要新建或吊销 Key 都在这里操作。接入文档在 https://taotoken.net/api 可以查到最新的 Base URL 和模型列表，配置前对一眼，避免 Model ID 过期。

最后说个实际经验：config.toml 改完一定要重启服务，OpenClaw 不会热加载模型配置。我见过有人改完直接发消息，发现还是旧模型，以为配置没生效，其实是没重启。养成改完就openclaw restart的习惯，能省不少排查时间。