1. Windows 上装 OpenClaw 到底卡在哪OpenClaw 是一个可以跑在个人电脑上的开源智能体网关它能把你常用的聊天入口Telegram、Discord、飞书等接到大模型上让模型帮你处理消息、执行任务。它适合想在 Windows 个人环境里搭一个私人 AI 助手、又不想折腾服务器的人。官方推荐的安装方式是一条 PowerShell 命令看起来简单但真正跑起来会撞上三件事Node.js 和 npm 的前置环境没准备好、PowerShell 默认不允许执行远程脚本、以及装完之后模型通道没配通导致界面能开但聊天报错。我实测下来这三步里最容易翻车的是执行策略和模型配置。前者会让你在第一步就卡住后者会让你以为装好了其实用不了。这篇就按官方推荐流程走一遍把每一步的 PowerShell 命令、配置文件片段和验证动作都写清楚最后用 TaoToken 的统一 Key 把模型通道接上让你一次跑通并确认 OpenClaw 真的可用。整篇的操作路径是先检查 Node.js/npm/git 前置再处理 PowerShell 执行策略然后跑官方安装脚本接着写入 TaoToken 的 config 骨架最后做连通性验证。每一步都有可复制的命令和预期结果遇到报错直接对照第 5 节的排查清单。2. 装之前先把 Node.js、npm、git 这三样备齐OpenClaw 本体是 Node.js 写的安装脚本会依赖 npm 去拉包git 则用于部分依赖的源码获取。这三样缺一个后面都会以奇怪的方式报错所以先花两分钟确认。打开 PowerShell普通权限即可逐条跑node -v npm -v git --version正常的话会分别输出类似v20.11.0、10.2.4、git version 2.43.0的版本号。如果某条提示「无法将 xxx 项识别为 cmdlet」说明这个工具没装或没进 PATH。Node.js 建议用 18 以上的 LTS 版本。如果没装去 Node.js 官网下 LTS 的 Windows 安装包安装时勾选「Add to PATH」。装完关掉当前 PowerShell 重新开一个再跑node -v确认。git 没装的话去 git-scm 官网下 Windows 版一路默认下一步即可同样记得让它进 PATH。npm 源这块国内直连官方源偶尔会超时导致安装脚本拉到一半失败。可以先切到国内镜像npm config set registry https://registry.npmmirror.com npm config get registry第二条命令应该回显https://registry.npmmirror.com。这一步不是必须但能明显减少安装中途卡住的情况。等 OpenClaw 装完你想换回官方源随时可以npm config set registry https://registry.npmjs.org注意切换 npm 源只影响 npm 拉包不影响后面模型 API 的请求地址两者是独立的别混在一起理解。3. PowerShell 执行策略与官方安装命令官方推荐的安装方式是一条iwr ... | iex命令本质是从远程拉一个安装脚本直接执行。Windows 默认的执行策略是Restricted会直接拦下这种远程脚本所以先看当前策略Get-ExecutionPolicy如果回显Restricted就需要改成RemoteSigned。这个策略的含义是本地写的脚本可以跑从网上下载的脚本必须有数字签名才能跑是安全和便利之间比较平衡的选择。改策略需要管理员权限。在任务栏搜索框输入 PowerShell右键「Windows PowerShell」选「以管理员身份运行」弹出 UAC 点「是」。然后执行Set-ExecutionPolicy RemoteSigned系统会问你是否确认输入Y回车。再验证一次Get-ExecutionPolicy确认显示RemoteSigned后回到普通 PowerShell 窗口管理员窗口也行跑官方安装命令iwr -useb https://openclaw.ai/install.ps1 | iex这条命令会先检测环境如果发现没装 Node.js会弹出 Node.js 的安装界面点确定让它装。装完 Node.js 后命令行会提示你输入y继续输入后系统会继续拉取 OpenClaw 本体。安装过程中如果提示需要在 PATH 中配置环境变量或者装完openclaw命令找不到先别急看第 5 节的排查。安装脚本跑完后它会告诉你openclaw.cmd被放到了哪个路径通常在Added后面那行。把这个路径记下来如果openclaw命令不识别就手动把它加进系统环境变量 Path。装完先验证版本openclaw --version能打印出版本号说明本体装好了。如果提示找不到命令重新开一个 PowerShell 再试还不行就按第 5 节处理 PATH。安全提醒安装完成后建议把执行策略改回Restricted减少日常使用中误执行远程脚本的风险Set-ExecutionPolicy Restricted后续如果还要跑安装类脚本再临时改回来即可。4. 写入 TaoToken 统一 Key 的 config 骨架OpenClaw 装好后默认的模型通道是空的直接开界面聊天会报连接错误。这里用 TaoToken 的统一 Key 来配模型通道好处是一个 Key 能对接多个模型后面换模型不用改一堆配置。先拿到 Key。打开 TaoToken 控制台创建 API Keyhttps://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentopenclaw_windows创建后复制那串 Key格式通常以sk-开头。TaoToken 的 API 基地址是https://taotoken.net/api注意这个地址后面不加 UTM 参数直接用于配置。OpenClaw 的主配置文件在用户目录下的.openclaw文件夹里。先确认路径echo $env:USERPROFILE假设输出是C:\Users\你的用户名那配置文件就是C:\Users\你的用户名\.openclaw\openclaw.json用文本编辑器VS Code、Notepad 都行打开这个文件。找到models这一段如果没有就手动加。写入下面这个骨架把apiKey换成你刚复制的真实 Keymodels: { mode: merge, providers: { taotoken: { baseUrl: https://taotoken.net/api, apiKey: sk-你的实际TaoToken密钥, api: openai-completions, models: [ { id: gpt-4o, name: GPT-4o }, { id: claude-3-5-sonnet, name: Claude 3.5 Sonnet } ] } } }这里mode设为merge表示和已有配置合并不会覆盖你之前写的东西。api字段用openai-completions因为 TaoToken 的接口兼容 OpenAI 的调用格式OpenClaw 按这个协议发请求就能通。接着找到默认主模型那一行把 primary 指向你刚配的 providerprimary: taotoken/gpt-4o格式是provider名/模型idprovider 名就是上面写的taotoken模型 id 是gpt-4o。想用 Claude 就改成taotoken/claude-3-5-sonnet。保存文件后重启 OpenClaw 网关让配置生效openclaw gateway restart如果这条命令报错也可以先停再起openclaw gateway stop openclaw gateway start提示如果不想把 Key 明文写在 json 里可以写成${TAOTOKEN_API_KEY}然后在系统环境变量里设置TAOTOKEN_API_KEY的值。这样配置文件可以安全地分享或备份。5. 验证请求与常见报错排查配置写完重启网关后做一次连通性验证。最直接的方式是让 OpenClaw 发一条测试消息。如果你已经配了 Telegram 或 Discord 频道直接在对应聊天里发一句「你好」看模型是否正常回复。如果还没配频道可以用命令行方式触发一次模型调用。OpenClaw 提供了直接对话的入口openclaw chat 用一句话介绍你自己正常的话会返回模型生成的内容。如果返回报错按下面的清单逐条排查。报错一PowerShell 提示没有执行远程脚本的权限现象是跑安装命令时提示无法加载文件因为在此系统上禁止运行脚本。原因是执行策略还是Restricted。按第 3 节用管理员 PowerShell 执行Set-ExecutionPolicy RemoteSigned确认Get-ExecutionPolicy显示RemoteSigned后重跑安装命令。报错二安装后提示找不到 openclaw 命令现象是openclaw --version提示「无法将 openclaw 项识别为 cmdlet」。原因是openclaw.cmd所在目录没进 PATH。安装脚本跑完时会在Added后面打印一个路径去那个路径下找到openclaw.cmd把它的父目录加进系统环境变量 Path。加完重新开 PowerShell 再验证。如果安装中途还报过 PATH 相关的错可以先清 npm 缓存再重装npm cache clean --force npm config set registry https://registry.npmmirror.com iwr -useb https://openclaw.ai/install.ps1 | iex报错三界面能打开但聊天报连接错误现象是 OpenClaw 的 Web 界面能加载但发消息后提示模型连接失败或 401。原因通常是openclaw.json里的模型配置没写对或者 Key 无效。检查三处baseUrl是不是https://taotoken.net/api不要多写斜杠或路径、apiKey是不是完整的sk-开头字符串、primary是不是taotoken/模型id的格式。改完记得openclaw gateway restart。报错四改了配置但没生效现象是明明改了 json行为还是旧的。原因是网关没重启配置是启动时加载的。执行openclaw gateway restart然后刷新浏览器或重开聊天窗口。报错五npm 安装超时或卡住现象是安装脚本拉到一半不动了。切国内镜像源后重试npm config set registry https://registry.npmmirror.com装完想换回官方源再执行npm config set registry https://registry.npmjs.org。排查完这几条基本能覆盖 Windows 个人环境下装 OpenClaw 的绝大多数坑。验证通过后你就可以继续去配 Telegram 或 Discord 频道把助手接到日常聊天里。6. 后续接入与 Key 管理模型通道跑通之后下一步通常是配一个聊天入口。OpenClaw 支持 Telegram、Discord、飞书、Slack 等多个平台个人使用推荐从 Telegram 或 Discord 起步配置简单、文档全。配频道时如果遇到问题可以对照接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentopenclaw_windows如果你打算长期跑编码类任务或 Agent 工作流TaoToken 的 Coding Plan 会比按量调用更划算适合高频使用场景https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentopenclaw_windows想先在网页里直接试模型效果、确认哪个模型适合你的任务可以用模型对话入口https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentopenclaw_windowsKey 的创建和管理都在控制台https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentopenclaw_windows最后提醒一句openclaw.json里如果写了明文 Key注意别把这个文件传到公开仓库或分享给别人。用环境变量${TAOTOKEN_API_KEY}的方式更稳妥换 Key 时也只改环境变量不用动配置文件。
在 Windows 上用官方推荐方式安装 OpenClaw：TaoToken 统一 Key 配置与 PowerShell 验证
1. Windows 上装 OpenClaw 到底卡在哪OpenClaw 是一个可以跑在个人电脑上的开源智能体网关它能把你常用的聊天入口Telegram、Discord、飞书等接到大模型上让模型帮你处理消息、执行任务。它适合想在 Windows 个人环境里搭一个私人 AI 助手、又不想折腾服务器的人。官方推荐的安装方式是一条 PowerShell 命令看起来简单但真正跑起来会撞上三件事Node.js 和 npm 的前置环境没准备好、PowerShell 默认不允许执行远程脚本、以及装完之后模型通道没配通导致界面能开但聊天报错。我实测下来这三步里最容易翻车的是执行策略和模型配置。前者会让你在第一步就卡住后者会让你以为装好了其实用不了。这篇就按官方推荐流程走一遍把每一步的 PowerShell 命令、配置文件片段和验证动作都写清楚最后用 TaoToken 的统一 Key 把模型通道接上让你一次跑通并确认 OpenClaw 真的可用。整篇的操作路径是先检查 Node.js/npm/git 前置再处理 PowerShell 执行策略然后跑官方安装脚本接着写入 TaoToken 的 config 骨架最后做连通性验证。每一步都有可复制的命令和预期结果遇到报错直接对照第 5 节的排查清单。2. 装之前先把 Node.js、npm、git 这三样备齐OpenClaw 本体是 Node.js 写的安装脚本会依赖 npm 去拉包git 则用于部分依赖的源码获取。这三样缺一个后面都会以奇怪的方式报错所以先花两分钟确认。打开 PowerShell普通权限即可逐条跑node -v npm -v git --version正常的话会分别输出类似v20.11.0、10.2.4、git version 2.43.0的版本号。如果某条提示「无法将 xxx 项识别为 cmdlet」说明这个工具没装或没进 PATH。Node.js 建议用 18 以上的 LTS 版本。如果没装去 Node.js 官网下 LTS 的 Windows 安装包安装时勾选「Add to PATH」。装完关掉当前 PowerShell 重新开一个再跑node -v确认。git 没装的话去 git-scm 官网下 Windows 版一路默认下一步即可同样记得让它进 PATH。npm 源这块国内直连官方源偶尔会超时导致安装脚本拉到一半失败。可以先切到国内镜像npm config set registry https://registry.npmmirror.com npm config get registry第二条命令应该回显https://registry.npmmirror.com。这一步不是必须但能明显减少安装中途卡住的情况。等 OpenClaw 装完你想换回官方源随时可以npm config set registry https://registry.npmjs.org注意切换 npm 源只影响 npm 拉包不影响后面模型 API 的请求地址两者是独立的别混在一起理解。3. PowerShell 执行策略与官方安装命令官方推荐的安装方式是一条iwr ... | iex命令本质是从远程拉一个安装脚本直接执行。Windows 默认的执行策略是Restricted会直接拦下这种远程脚本所以先看当前策略Get-ExecutionPolicy如果回显Restricted就需要改成RemoteSigned。这个策略的含义是本地写的脚本可以跑从网上下载的脚本必须有数字签名才能跑是安全和便利之间比较平衡的选择。改策略需要管理员权限。在任务栏搜索框输入 PowerShell右键「Windows PowerShell」选「以管理员身份运行」弹出 UAC 点「是」。然后执行Set-ExecutionPolicy RemoteSigned系统会问你是否确认输入Y回车。再验证一次Get-ExecutionPolicy确认显示RemoteSigned后回到普通 PowerShell 窗口管理员窗口也行跑官方安装命令iwr -useb https://openclaw.ai/install.ps1 | iex这条命令会先检测环境如果发现没装 Node.js会弹出 Node.js 的安装界面点确定让它装。装完 Node.js 后命令行会提示你输入y继续输入后系统会继续拉取 OpenClaw 本体。安装过程中如果提示需要在 PATH 中配置环境变量或者装完openclaw命令找不到先别急看第 5 节的排查。安装脚本跑完后它会告诉你openclaw.cmd被放到了哪个路径通常在Added后面那行。把这个路径记下来如果openclaw命令不识别就手动把它加进系统环境变量 Path。装完先验证版本openclaw --version能打印出版本号说明本体装好了。如果提示找不到命令重新开一个 PowerShell 再试还不行就按第 5 节处理 PATH。安全提醒安装完成后建议把执行策略改回Restricted减少日常使用中误执行远程脚本的风险Set-ExecutionPolicy Restricted后续如果还要跑安装类脚本再临时改回来即可。4. 写入 TaoToken 统一 Key 的 config 骨架OpenClaw 装好后默认的模型通道是空的直接开界面聊天会报连接错误。这里用 TaoToken 的统一 Key 来配模型通道好处是一个 Key 能对接多个模型后面换模型不用改一堆配置。先拿到 Key。打开 TaoToken 控制台创建 API Keyhttps://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentopenclaw_windows创建后复制那串 Key格式通常以sk-开头。TaoToken 的 API 基地址是https://taotoken.net/api注意这个地址后面不加 UTM 参数直接用于配置。OpenClaw 的主配置文件在用户目录下的.openclaw文件夹里。先确认路径echo $env:USERPROFILE假设输出是C:\Users\你的用户名那配置文件就是C:\Users\你的用户名\.openclaw\openclaw.json用文本编辑器VS Code、Notepad 都行打开这个文件。找到models这一段如果没有就手动加。写入下面这个骨架把apiKey换成你刚复制的真实 Keymodels: { mode: merge, providers: { taotoken: { baseUrl: https://taotoken.net/api, apiKey: sk-你的实际TaoToken密钥, api: openai-completions, models: [ { id: gpt-4o, name: GPT-4o }, { id: claude-3-5-sonnet, name: Claude 3.5 Sonnet } ] } } }这里mode设为merge表示和已有配置合并不会覆盖你之前写的东西。api字段用openai-completions因为 TaoToken 的接口兼容 OpenAI 的调用格式OpenClaw 按这个协议发请求就能通。接着找到默认主模型那一行把 primary 指向你刚配的 providerprimary: taotoken/gpt-4o格式是provider名/模型idprovider 名就是上面写的taotoken模型 id 是gpt-4o。想用 Claude 就改成taotoken/claude-3-5-sonnet。保存文件后重启 OpenClaw 网关让配置生效openclaw gateway restart如果这条命令报错也可以先停再起openclaw gateway stop openclaw gateway start提示如果不想把 Key 明文写在 json 里可以写成${TAOTOKEN_API_KEY}然后在系统环境变量里设置TAOTOKEN_API_KEY的值。这样配置文件可以安全地分享或备份。5. 验证请求与常见报错排查配置写完重启网关后做一次连通性验证。最直接的方式是让 OpenClaw 发一条测试消息。如果你已经配了 Telegram 或 Discord 频道直接在对应聊天里发一句「你好」看模型是否正常回复。如果还没配频道可以用命令行方式触发一次模型调用。OpenClaw 提供了直接对话的入口openclaw chat 用一句话介绍你自己正常的话会返回模型生成的内容。如果返回报错按下面的清单逐条排查。报错一PowerShell 提示没有执行远程脚本的权限现象是跑安装命令时提示无法加载文件因为在此系统上禁止运行脚本。原因是执行策略还是Restricted。按第 3 节用管理员 PowerShell 执行Set-ExecutionPolicy RemoteSigned确认Get-ExecutionPolicy显示RemoteSigned后重跑安装命令。报错二安装后提示找不到 openclaw 命令现象是openclaw --version提示「无法将 openclaw 项识别为 cmdlet」。原因是openclaw.cmd所在目录没进 PATH。安装脚本跑完时会在Added后面打印一个路径去那个路径下找到openclaw.cmd把它的父目录加进系统环境变量 Path。加完重新开 PowerShell 再验证。如果安装中途还报过 PATH 相关的错可以先清 npm 缓存再重装npm cache clean --force npm config set registry https://registry.npmmirror.com iwr -useb https://openclaw.ai/install.ps1 | iex报错三界面能打开但聊天报连接错误现象是 OpenClaw 的 Web 界面能加载但发消息后提示模型连接失败或 401。原因通常是openclaw.json里的模型配置没写对或者 Key 无效。检查三处baseUrl是不是https://taotoken.net/api不要多写斜杠或路径、apiKey是不是完整的sk-开头字符串、primary是不是taotoken/模型id的格式。改完记得openclaw gateway restart。报错四改了配置但没生效现象是明明改了 json行为还是旧的。原因是网关没重启配置是启动时加载的。执行openclaw gateway restart然后刷新浏览器或重开聊天窗口。报错五npm 安装超时或卡住现象是安装脚本拉到一半不动了。切国内镜像源后重试npm config set registry https://registry.npmmirror.com装完想换回官方源再执行npm config set registry https://registry.npmjs.org。排查完这几条基本能覆盖 Windows 个人环境下装 OpenClaw 的绝大多数坑。验证通过后你就可以继续去配 Telegram 或 Discord 频道把助手接到日常聊天里。6. 后续接入与 Key 管理模型通道跑通之后下一步通常是配一个聊天入口。OpenClaw 支持 Telegram、Discord、飞书、Slack 等多个平台个人使用推荐从 Telegram 或 Discord 起步配置简单、文档全。配频道时如果遇到问题可以对照接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentopenclaw_windows如果你打算长期跑编码类任务或 Agent 工作流TaoToken 的 Coding Plan 会比按量调用更划算适合高频使用场景https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentopenclaw_windows想先在网页里直接试模型效果、确认哪个模型适合你的任务可以用模型对话入口https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentopenclaw_windowsKey 的创建和管理都在控制台https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentopenclaw_windows最后提醒一句openclaw.json里如果写了明文 Key注意别把这个文件传到公开仓库或分享给别人。用环境变量${TAOTOKEN_API_KEY}的方式更稳妥换 Key 时也只改环境变量不用动配置文件。
