1. 为什么打工人需要一个本地 AI 助手OpenClaw 能帮你做什么如果你每天的工作里有一半时间在重复「下载文件夹又乱了」「周报数据要从三个 Excel 里拼」「会议纪要要手动整理」这类事那 OpenClaw 值得你花十分钟装一次。它是一个开源的本地智能体框架跑在你自己电脑上能调用大模型理解你的自然语言指令然后真的去操作文件、执行脚本、拉取数据。和网页版聊天机器人最大的区别是它不只是「说」而是「做」。我第一次接触 OpenClaw 是因为一个很具体的痛点——每周要从十几个 CSV 里汇总销售数据手动复制粘贴要花四十分钟。装好 OpenClaw 之后一句「把 D 盘报表文件夹里本周的 CSV 合并成一张表按日期排序」就能搞定。它背后靠的是技能Skill机制类似手机装 App装什么技能就能干什么活。这篇文章面向 Windows 用户从零开始走完整条链路装 Node.js、配 PowerShell、拉 OpenClaw、装 ClawHub 技能、接入模型、跑通第一个任务。每一步都有可复制的命令和验证动作。模型接入这块我用 TaoToken 的统一 Key 来做一个 Key 走通多个模型省得在好几个平台之间来回切换配置。适合谁看会用 PowerShell 复制粘贴命令、但没写过复杂脚本的办公族想给团队搭一个本地自动化助手的运维同学以及被各种 AI 工具注册流程折腾烦了、想找个统一入口的开发者。不需要你会写代码但需要你愿意跟着敲命令。装之前先确认三件事系统是 Windows 10 21H2 以上或 Windows 1164 位内存至少 8GB跑本地模型建议 16GB磁盘留 5GB 以上空间。另外安装路径和你的 Windows 用户名都不要用中文这是后面技能加载失败最常见的原因我踩过这个坑排查了半小时才发现是用户名带中文导致的。2. 前置准备Node.js、npm 与 PowerShell 环境一次配好OpenClaw 的核心依赖是 Node.js而且版本要求比较严必须 22.0.0 以上的 LTS 版本。低于这个版本会在启动时报语法错误很多人卡在这一步以为是安装脚本坏了其实是 Node 版本太旧。所以这一章我们先把地基打好。2.1 用 winget 装 Node.js 22 LTSWindows 10/11 自带 winget 包管理器这是最省事的方式。打开管理员 PowerShell按 Win X选「终端(管理员)」执行winget install OpenJS.NodeJS.LTS --version 22.12.0如果你不确定 winget 里有哪些版本可以先搜一下winget search OpenJS.NodeJS装完之后必须重开一个 PowerShell 窗口因为环境变量需要重新加载。然后验证node --version npm --version正常输出应该是v22.12.0和类似10.9.0的 npm 版本号。如果node命令提示「不是内部或外部命令」说明 PATH 没生效重开终端或者重启电脑即可。2.2 切换 npm 国内镜像默认 npm 源在国内下载会很慢甚至超时。切换成 npmmirror 镜像npm config set registry https://registry.npmmirror.com npm config get registry第二条命令应该返回https://registry.npmmirror.com/确认切换成功。这一步能让你后面装 ClawHub 和技能包的速度从「等到怀疑人生」变成「几秒钟搞定」。2.3 配置 PowerShell 执行策略OpenClaw 的安装脚本是远程脚本PowerShell 默认会拦截。需要把当前用户的执行策略设为 RemoteSignedSet-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser按 Y 确认。这个设置只影响当前用户不会降低系统整体安全性是运行本地脚本的标准操作。2.4 环境自检清单在正式装 OpenClaw 之前跑一遍这个自检把问题提前暴露Write-Host Node 版本: (node --version) Write-Host npm 版本: (npm --version) Write-Host npm 源: (npm config get registry) Write-Host 执行策略: (Get-ExecutionPolicy -Scope CurrentUser) Write-Host 当前用户: $env:USERNAME重点看两处执行策略必须是RemoteSigned或Unrestricted当前用户名不能含中文。如果用户名是中文建议新建一个英文名的本地账户来跑 OpenClaw或者把工作目录放到C:\openclaw-workspace这类纯英文路径下。注意不要用系统自带的 Node.js 旧版本直接升级容易残留旧文件导致版本冲突。如果之前装过 Node先用winget uninstall OpenJS.NodeJS卸干净再装。3. 安装 OpenClaw 并接入 TaoToken 统一 Key环境就绪后进入正题。这一章分两部分先把 OpenClaw 本体装上再配置模型通道。模型这块用 TaoToken 的统一 Key一个 Key 就能调用多个模型配置一次到处能用。3.1 一键安装 OpenClaw在管理员 PowerShell 里执行官方安装脚本iwr -useb https://openclaw.ai/install.ps1 | iex脚本会自动检测 Node.js、下载 OpenClaw 核心程序、配置环境变量全程 3 到 8 分钟取决于网速。中途不要关终端。看到OpenClaw installed successfully就成功了。验证openclaw --version输出类似openclaw v2026.3.8即安装成功。如果你已经有 Node.js 22 环境也可以走 npm 手动安装更可控npm install -g openclawlatest openclaw --version3.2 获取 TaoToken API Key打开 TaoToken 控制台创建 API Keyhttps://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentopenclaw_install登录后在「API Keys」页面点创建复制生成的 Key形如sk-xxxxxxxx。这个 Key 就是你的统一凭证后面所有模型调用都用它。建议先存到记事本下一步要粘贴。3.3 配置 OpenClaw 的模型通道OpenClaw 的配置文件在~/.openclaw目录下Windows 上对应C:\Users\你的用户名\.openclaw。我们通过初始化向导来配置比手改文件更稳。执行openclaw onboard向导会依次问你几个问题。走到模型配置这一步时选择自定义 OpenAI 兼容通道Custom / OpenAI-Compatible然后填入以下三件套配置项填写内容Base URLhttps://taotoken.net/apiAPI Key你刚才复制的sk-xxxxxxxxModel ID例如claude-sonnet-4-5或gpt-4o按需选Base URL 这里注意不要带末尾斜杠也不要加 UTM 参数就是干净的https://taotoken.net/api。Model ID 填你在 TaoToken 控制台里能看到的具体模型名。如果你更习惯直接改配置文件OpenClaw 的模型配置存在~/.openclaw/config.json对应的片段长这样{ models: { default: { provider: openai-compatible, baseUrl: https://taotoken.net/api, apiKey: sk-你的Key, model: claude-sonnet-4-5 } }, gateway: { port: 18789, bind: 127.0.0.1 } }改完保存重启网关生效。用 JSON 配置的好处是以后换模型只改model字段不用重跑向导。3.4 启动网关服务配置完成后启动 OpenClaw 网关openclaw gateway start看到Gateway started successfully后浏览器访问http://localhost:18789能打开中文控制面板就说明整条链路通了。面板里能看到 AI 对话、技能管理、定时任务几个模块。提示如果 18789 端口被占用执行openclaw config set gateway.port 18790换端口然后重启网关。4. 用 ClawHub 拉取技能并跑通第一个自动化任务OpenClaw 本体只是个框架真正干活的是技能。ClawHub 是官方的技能管理工具类似 npm 之于 Node.js。这一章我们装 ClawHub、拉几个高频技能然后跑一个真实任务验证。4.1 安装 ClawHub CLInpm install -g clawhublatest --registry https://registry.npmmirror.com clawhub --version能输出版本号就装好了。4.2 安装高频技能先装一个安全守门人它会扫描其他技能的隐私风险必装clawhub install skill-vetter然后按需装几个覆盖日常场景的clawhub install office-automation clawhub install file-organizer clawhub install tavily-search clawhub install remind-meoffice-automation处理 Excel/Word/PPT 批量操作file-organizer自动整理文件夹tavily-search做实时联网搜索remind-me管会议和打卡提醒。装完用clawhub list确认clawhub list应该能看到已安装技能列表。装完技能后重启网关让它们生效openclaw gateway restart4.3 跑通第一个任务整理下载文件夹打开http://localhost:18789进入对话界面输入帮我整理 C:\Users\你的用户名\Downloads 文件夹按文件类型文档、图片、视频、安装包分类归档删除重复文件保留最新版本OpenClaw 会先展示一个执行计划列出它打算怎么分类、移动哪些文件。你确认后它调用file-organizer技能执行。执行完打开下载文件夹能看到文件已经按类型分好重复文件被清理。这一步的关键是先看计划再确认。OpenClaw 默认不会直接动手会等你点头这是它的安全设计。如果你发现计划里有不想动的文件可以在确认前补充指令比如「不要动 .zip 文件」。4.4 验证模型通道是否真的走通想确认请求确实走了 TaoToken 通道可以在对话里问一个需要模型推理的问题比如「把下面这段会议记录总结成三条待办」。如果模型正常返回结构化结果说明 Base URL、Key、Model ID 三件套都配对了。如果返回报错看下一章的排查。5. 常见报错排查401、端口占用与技能加载失败装的过程中大概率会碰到几个典型报错这一章按真实错误信息来对照排查。5.1 401 Unauthorized现象对话时提示401 Unauthorized或invalid api key。原因基本是 Key 没配对。检查三处Key 是否复制完整有没有漏掉sk-前缀后面的字符Base URL 是否写成了https://taotoken.net/api不要带/v1后缀也不要带 UTM 参数配置文件里apiKey字段有没有多余空格。改完重启网关。5.2 local proxy failed / connection refused现象启动时报local proxy failed或面板打不开提示connection refused。这是网关没起来或绑定地址不对。先确认进程在跑openclaw gateway status如果没跑执行openclaw gateway start。如果跑了但面板打不开检查配置里gateway.bind是不是127.0.0.1端口是不是被别的程序占了。换端口openclaw config set gateway.port 18790 openclaw gateway restart5.3 reading choices 报错现象模型返回时提示error reading choices或返回结构解析失败。这通常是 Model ID 填错了或者该模型不支持当前调用格式。回到 TaoToken 控制台确认模型名拼写换成claude-sonnet-4-5或gpt-4o这类标准名再试。如果换了还不行检查 Base URL 末尾有没有多余斜杠。5.4 技能加载失败 / 中文路径问题现象clawhub install成功但技能不生效或启动时报路径错误。九成是中文路径导致的。检查你的 Windows 用户名和 OpenClaw 工作目录是否含中文。如果是把工作目录改到纯英文路径openclaw config set workspace.path C:\openclaw-workspace openclaw gateway restart5.5 OAuth 相关报错现象提示OAuth token expired或要求重新授权。如果你用的是需要 OAuth 的模型通道token 过期了。TaoToken 走的是 API Key 模式不涉及 OAuth所以用统一 Key 能绕开这类问题。确认配置里provider是openai-compatible而不是某个 OAuth provider。5.6 排查速查表报错关键词最可能原因处理动作401 UnauthorizedKey 错误或 Base URL 带后缀重贴 KeyURL 用https://taotoken.net/apilocal proxy failed网关未启动openclaw gateway startreading choicesModel ID 拼写错误换成标准模型名技能不生效中文路径工作目录改纯英文OAuth expired用了 OAuth 通道改用 API Key 模式6. 把 OpenClaw 用成日常统一 Key 与长期编码方案装好只是开始真正省时间的是把它嵌进日常工作流。我现在的用法是早上到工位先让 OpenClaw 整理昨天的下载文件和邮件附件中午用它把会议录音转写的文本总结成待办下午批量处理报表。这些任务都不需要我写代码自然语言描述就行。模型通道这块TaoToken 的统一 Key 最大的好处是「配一次到处用」。OpenClaw 里配好之后如果你还用 Claude Code 做编码、用其他工具做文档处理同一个 Key 和 Base URL 可以直接复用不用每个工具单独注册和配置。对于需要长期跑编码任务或 Agent 流程的场景可以了解下 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentopenclaw_coding想快速验证某个模型效果直接用模型对话页面试https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentopenclaw_models接入文档在这里遇到配置细节可以查https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentopenclaw_doc最后给几个实测下来有用的技巧。第一把常用任务写成 OpenClaw 的定时任务比如每天早上九点自动整理下载文件夹省得每次手动触发。第二技能不要一次装太多先装file-organizer和office-automation这两个最高频的用顺了再加。第三配置文件改之前先备份config.json改坏了能快速回滚。第四如果团队多人用把工作目录放在共享盘上但注意并发写入冲突建议每人一个子目录。OpenClaw 的价值不在于它多智能而在于它把「说一句话就能让电脑干活」这件事变得门槛足够低。装一次配一次 Key后面就是不断加技能、加任务的过程。