1. Windows 11 装 OpenClaw 到底卡在哪OpenClaw龙虾是一个能在本地跑任务的 AI 智能体能读文件、执行动作、对接聊天渠道全程跑在自己电脑上数据不出本机。它适合想折腾本地 Agent 的 Windows 11 用户尤其是手里已经有一堆模型 Key、不想每个工具都单独配一遍的人。但新手第一次装十有八九会卡在三个地方Node.js 版本不够、PowerShell 执行策略拦脚本、以及模型通道配得七零八落。我自己在 Windows 11 上装的时候前面环境准备花了不到五分钟真正折腾的是模型接入那一段——每个平台一个 Key、一个 Base URL配到第三个就开始记混。后来换成 TaoToken 的统一 Key 通道一个 Key 走所有模型配置文件里只改一处省事很多。这篇就把从零到跑通的完整流程拆开包括可复制的配置骨架、环境检查命令和连通性验证动作照着做基本能一次过。需要提前说清楚OpenClaw 官方在 Windows 上更推荐 WSL2原生 Windows 能用但偶有兼容问题。本文走原生 Windows 11 路线适合不想装 WSL 的新手如果你后面遇到奇怪的报错再考虑切 WSL2 也不迟。2. 装 OpenClaw 前先把 Node.js 和 Git 备好OpenClaw 依赖 Git 和 Node.js 两个基础环境缺一个都装不下去。Node.js 版本必须 ≥ 22这是硬门槛低于这个版本装到一半会报错。2.1 Git 安装去 Git for Windows 官方发布页下载 64 位安装包双击运行全程默认下一步即可不需要改任何选项。装完 Git 会自动进 PATH不用手动配。2.2 Node.js 安装去 nodejs.org 下载 LTS 稳定版同样默认安装。安装器会自动配置环境变量装完直接能用。注意别选 Current 版LTS 更稳。2.3 环境验证以管理员身份打开 CMD不是 PowerShell后面会解释为什么依次输入git --version node -v npm -v三条命令都能打印出版本号说明环境正常。node -v输出应该是 v22 或更高比如 v24.14.0。如果提示「不是内部或外部命令」说明 PATH 没配好重装 Node.js 并勾选「Add to PATH」。注意如果你之前装过旧版 Node.js建议先卸载再装新版避免多版本冲突导致node -v指向旧版本。3. 用 TaoToken 统一 Key 打通模型通道OpenClaw 本身不带模型它需要你提供一个模型通道才能干活。传统做法是每个模型平台单独申请 Key、单独填 Base URL配多了容易乱。TaoToken 的思路是把这些通道统一成一个 KeyOpenClaw 里只填一次换模型时改个模型名就行。3.1 拿 Key 和确认接入地址先去 TaoToken 官网注册账号然后进控制台创建 API Key。地址如下官网入口https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content控制台创建 Keyhttps://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentAPI Keys 管理页https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content创建完 Key 先复制存好页面关了就看不到了。接入地址用https://taotoken.net/api这个地址不加任何参数直接填进配置。3.2 确认可用模型在模型对话页可以先试一下 Key 通不通顺便看看有哪些模型可选模型对话https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content新手建议先用 Qwen 或 Kimi 这类中文友好的模型响应快、报错少。等你跑通了再换别的。3.3 配置骨架OpenClaw 的配置文件在C:\Users\你的用户名\.openclaw\config.json。安装初始化后这个文件会自动生成你只需要改模型相关的那一段。下面是一个可复制的骨架把你的Key替换成刚才复制的{ models: { provider: openai-compatible, baseUrl: https://taotoken.net/api, apiKey: 你的Key, model: qwen-plus }, gateway: { port: 18789, mode: local, bind: loopback, auth: { mode: token, token: 你的本地token } } }这里provider填openai-compatible因为 TaoToken 走的是兼容 OpenAI 的接口格式。baseUrl就是上面那个 API 地址注意结尾不要多加斜杠。model字段换成你想用的模型名比如kimi-k2.5或qwen-plus。提示gateway.auth.token是本地 Web UI 的访问令牌跟 API Key 不是一回事别搞混。这个 token 是初始化时自动生成的保持原样即可。4. 安装 OpenClaw 并验证连通性环境备好、Key 拿到接下来装主程序。4.1 执行安装命令以管理员身份打开 PowerShell运行官方安装脚本iwr -useb https://openclaw.ai/install.ps1 | iex如果国内网络拉取慢改用 npm 镜像安装npm i -g openclaw --ignore-scripts --registryhttps://registry.npmmirror.com安装成功的标志是提示OpenClaw installed successfully并打印出版本号比如2026.3.2。装完验证一下openclaw --version能打印版本号就说明主程序装好了。4.2 初始化配置运行初始化命令openclaw onboard --install-daemon向导里几个关键选择安装模式选 QuickStart配置处理选 Use existing values模型选择时如果你已经在 config.json 里填好了 TaoToken 通道这里可以跳过或选自定义。通讯渠道和技能依赖全部选 Skip for now后面需要再加。各类 API Key 统一选 No因为我们已经用 TaoToken 统一通道了。网关服务选 Skip。初始化完成后选 Open the Web UI浏览器会自动打开http://127.0.0.1:18789/chat。4.3 验证请求Web UI 打开后如果页面显示版本号和健康状态正常说明服务起来了。但服务起来不等于模型通道通还得实际发一条消息验证。在对话框里输入一句简单的话比如「你好帮我列一下当前目录的文件」。如果模型正常返回内容说明 TaoToken 通道打通了。如果返回报错看下面的排查部分。你也可以用命令行直接验证通道curl https://taotoken.net/api/v1/models -H Authorization: Bearer 你的Key返回模型列表 JSON 就说明 Key 和地址都没问题。5. 装 OpenClaw 常见的几个坑5.1 PowerShell 报「禁止运行脚本」这是最常见的报错完整信息是无法加载文件 npm.ps1因为在此系统上禁止运行脚本。原因是 PowerShell 默认执行策略是 Restricted不允许跑脚本。解决办法是改执行策略Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force这条命令只对当前用户生效允许运行本地脚本远程脚本需要签名安全性够用。改完重新跑安装命令即可。5.2 安装报错 code 128code 128 基本是网络波动导致 Git 拉取失败。多执行几次安装命令通常就好了。如果反复失败检查 Git 是否装好、能否正常访问 GitHub。用 npm 镜像那条命令可以绕开这个问题。5.3 启动后 Web UI 打不开先确认端口 18789 没被占用netstat -ano | findstr 18789如果有输出说明端口被占改 config.json 里的gateway.port换个端口或者杀掉占用进程。另外确认服务确实在跑重新执行openclaw onboard --install-daemon一次。5.4 模型不生效如果 Web UI 能打开但发消息报错八成是 config.json 里的模型配置有问题。检查三点baseUrl是不是https://taotoken.net/api结尾别加斜杠、apiKey有没有复制完整、model字段的模型名是否拼对。改完配置要重启 OpenClaw 服务才生效。5.5 原生 Windows 的兼容性OpenClaw 官方更推荐 WSL2原生 Windows 偶尔会有路径或权限相关的小问题。如果你按上面流程走完还是各种报错可以考虑装 WSL2 再跑一遍命令基本一样只是环境换成 Linux。装 WSL2 就一条命令wsl --install重启后即可。6. 跑通之后怎么继续用到这一步OpenClaw 已经在你的 Windows 11 上跑起来了模型通道走的是 TaoToken 统一 Key后面想换模型只改 config.json 里的model字段就行不用重新申请 Key。如果你打算长期用 OpenClaw 做编码或跑 Agent 任务可以了解一下 Coding Plan额度更划算Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content接入过程中遇到报错优先翻接入文档大部分常见问题都有说明接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content如果你用的是 Claude Code 这类工具Anthropic 兼容通道的配置方式在文档里也有单独说明ClaudeCodeAnthropic 接入https://taotoken.net/doc/claudecode-anthropic?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content最后提醒一句OpenClaw 默认是单操作者边界能读文件、能执行动作别把它暴露到公网也别在共享环境里开工具权限。跑之前建议执行一次openclaw security audit --deep看看有没有明显的安全配置问题。