★ FEATURED ARTICLE 1. 为什么要在个人 Windows 电脑上跑私有化 AI Agent很多人第一次听到「私有化 AI Agent」会以为是把某个大模型下载到本地其实不是。Agent 的重点不在模型本身而在于它能代替你操作电脑读文件、改目录、开浏览器、填表格、发消息。模型只是它的「大脑」真正干活的是它调用的一堆本地工具。OpenClaw圈内叫小龙虾就是这类开源项目里比较成熟的一个它把「自然语言指令 → 任务拆解 → 调用工具 → 持续执行」这条链路做成了可视化流程Windows 上双击就能跑起来。那为什么强调「私有化」因为 Agent 要拿到你电脑的文件读写、键鼠模拟权限如果这些操作都走云端等于把整台机器的控制权交出去。私有化部署的意思是Agent 本体、任务记录、执行日志都留在你自己的硬盘上只有需要模型推理的那一步才发请求出去。这一步发到哪里、用什么 Key是整篇教程里最值得认真配置的地方——我后面会用 TaoToken 统一接管模型通道这样你换模型、换供应商都不用改 Agent 本体。这篇面向的是零基础 Windows 用户不需要你提前装 Python、Node.js不需要敲命令行跟着做就能在本地跑通一个能对话、能执行任务的 Agent 实例。适合谁日常有大量重复文件整理、表格汇总、网页信息提取需求又不想把数据交给第三方云 Agent 的人。全程大约 10 分钟其中 3 到 5 分钟是自动部署在跑你只需要等。先说清楚一个预期OpenClaw 装完之后它默认的模型通道需要你自己填。这一步不填界面能打开但发消息会报错。所以本教程的结构是「先装本体 → 再配模型通道 → 最后验证对话」三步都跑通才算真正可用。2. 部署前必须搞定的环境与安全软件设置这一步看起来啰嗦但实测下来 80% 的「装到一半失败」都出在这里。OpenClaw 要模拟键鼠、读写系统目录安全软件会把它当成可疑程序拦截轻则启动被拦重则核心 exe 被直接隔离删除。所以部署前请逐条核对。第一关闭所有实时防护。包括 Windows Defender 的实时保护、360 安全卫士、腾讯电脑管家、火绒。注意不是只关主界面开关要进设置里把「实时防护」「行为监控」这类模块也关掉并在任务管理器里结束后台防护进程。项目本身是开源的你可以去 GitHub 仓库核对源码临时关闭只是为了避开误拦截。第二确认磁盘空间和路径规划。建议预留至少 5GB安装目录必须是纯英文不能有中文、空格、、¥、中文标点。推荐直接用D:\OpenClaw。错误示范D:\工具\OpenClaw含中文、D:\Open Claw含空格、D:\小龙虾AI含中文昵称。路径不规范会直接导致部署中断而且报错信息往往很含糊排查起来很痛苦。第三准备一个模型通道的 Key。这是很多人卡住的地方。OpenClaw 本体不含模型它需要一个兼容 OpenAI 协议的 API 端点。你可以用各家官方 API但更省事的做法是用 TaoToken 这类统一通道一个 Key 走多家模型Base URL 固定换模型只改一个 Model ID。注册和拿 Key 的入口在官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 进去后在控制台创建 API Key 即可。这一步先记着第 3 节会具体填。第四确认系统版本。Windows 10 1809 及以上、Windows 11 都可以。太老的系统可能缺 .NET 组件部署脚本会自动补但补不上的话需要手动装。把上面四条过一遍再往下走。别跳过跳过的人最后都会回来重装。3. 可复制的 OpenClaw 配置Base URL、Key 与 Model ID 三件套部署包跑完之后OpenClaw 会在安装目录生成一个.env配置文件模型通道就写在这里。很多人第一次打开主界面发现「Gateway 在线」但一发消息就报错基本都是这个文件没配对。下面给你一份可以直接抄的配置片段。先找到文件位置D:\OpenClaw\.env如果你装到别的盘对应替换。用记事本或 VS Code 打开核心字段如下# 模型通道配置 OPENAI_BASE_URLhttps://taotoken.net/api OPENAI_API_KEYsk-你的TaoToken密钥 DEFAULT_MODELclaude-sonnet-4-20250514 # Agent 运行参数 AGENT_MAX_STEPS20 AGENT_TIMEOUT120 GATEWAY_PORT18789 LOG_LEVELinfo三个关键点逐个说Base URL填https://taotoken.net/api注意结尾不要多加/v1OpenClaw 内部会自己拼路径多写一层会 404。这个地址是统一的模型入口不管你后面用 Claude、GPT 还是别的都走这一个。API Key填你在控制台创建的那串sk-开头的密钥。创建入口https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。注意 Key 只在创建时完整显示一次关掉页面就看不到了记得先复制到安全的地方。Model ID是决定你用哪个模型的地方。这里填的是模型标识符不是显示名。比如claude-sonnet-4-20250514、gpt-4o这类。填错了会报model not found。你可以在模型对话页先确认可用模型列表https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。如果你更习惯用 JSON 格式管理比如后续要接 Cline、Codex 这类工具可以另存一份config.json{ provider: openai-compatible, baseURL: https://taotoken.net/api, apiKey: sk-你的TaoToken密钥, model: claude-sonnet-4-20250514, maxTokens: 8192, temperature: 0.7 }改完保存回到 OpenClaw 主界面点右上角「重启 Gateway」。等状态重新变成「Gateway 在线」配置就生效了。这一步是整个教程里唯一需要你手动填东西的地方其余都是自动的。4. 验证请求从 Gateway 在线到第一次成功对话配置写完不代表通了得实际发一次请求验证。这里给你一套从底层到上层的验证顺序哪一层断了就定位到哪一层。第一层验证 API 通道本身通不通。打开 PowerShell跑一条 curlcurl https://taotoken.net/api/v1/chat/completions ^ -H Content-Type: application/json ^ -H Authorization: Bearer sk-你的TaoToken密钥 ^ -d {\model\:\claude-sonnet-4-20250514\,\messages\:[{\role\:\user\,\content\:\回复ok\}]}如果返回一段 JSON里面有choices字段和内容说明 Key、Base URL、Model ID 三件套都对。如果返回 401是 Key 错了返回 404多半是 Base URL 多写了/v1返回model not found是 Model ID 拼错。第二层验证 OpenClaw 能不能读到配置。回到主界面右上角有个「运行日志」入口点开看启动日志里有没有Loaded model: claude-sonnet-4-20250514这类字样。没有的话说明.env没被加载检查文件名是不是.env而不是.env.txt记事本容易犯这个错。第三层发第一条真实指令。在底部输入框输入一句最简单的帮我在 D 盘新建一个文件夹命名为 agent-test按 Enter 发送。正常情况下你会看到 Agent 拆解出「创建目录」这个动作然后执行最后返回结果。去 D 盘看一眼文件夹真的出现了就说明整条链路通了。第四层试一个多步任务。单步任务只能验证工具调用多步才能验证 Agent 的规划能力。试这句整理 D:\Downloads 里的图片按修改日期分文件夹存放观察它是否先列目录、再判断文件类型、再创建子文件夹、再移动。整个过程在界面上是可见的你能看到它每一步在干什么。如果中途卡住看日志里最后一条动作是什么通常能定位到是权限问题还是路径问题。四层都过你的私有化 Agent 就算真正跑起来了。后面就是慢慢喂它更复杂的任务。5. 高频报错排查401、local proxy failed 与 reading choices这一节按真实报错来遇到问题直接对号入座。报错一401 Unauthorized。这是最常见的。原因有三个Key 复制时带了空格、Key 已失效或被删、.env里 Key 那行前面有#被注释掉了。排查方法把 Key 单独拿去跑第 4 节的 curl能通就是 OpenClaw 配置问题不能通就是 Key 本身问题。重新去 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 建一个再试。报错二local proxy failed或connection refused。这个通常不是模型通道的问题而是 OpenClaw 自己的 Gateway 没起来。检查顺序主界面右上角状态是不是「Gateway 在线」GATEWAY_PORT18789这个端口有没有被别的程序占用用netstat -ano | findstr 18789查防火墙有没有拦本地回环。解决办法换个端口比如改成18790重启 Gateway。报错三error reading choices或invalid response format。这个说明请求发出去了但返回的结构 OpenClaw 解析不了。常见原因是 Base URL 写成了https://taotoken.net/api/v1导致路径拼成/api/v1/v1/chat/completions返回的是错误页而不是标准 JSON。把 Base URL 改回https://taotoken.net/api即可。另一个可能是 Model ID 填了一个不支持 chat 格式的模型换回claude-sonnet-4-20250514这类通用对话模型。报错四OAuth token expired或要求重新登录。如果你之前用的是某家官方 OAuth 登录方式token 会过期。用 TaoToken 的 Key 方式就不会有这个问题因为它是长期有效的 API Key不涉及 OAuth 刷新。这也是统一通道的一个实际好处。报错五Agent 执行到一半卡住不动。看日志最后一条动作。如果是「等待用户确认」说明任务涉及敏感操作比如删除文件Agent 在等你点确认。如果是「工具调用超时」把.env里的AGENT_TIMEOUT从 120 调到 300 再试。排查的核心思路就一句先分层再定位。API 层用 curl 验Gateway 层看状态和端口Agent 层看日志动作。三层分开问题就不会糊在一起。6. 把模型通道固定下来后续扩展才不折腾装完这一套你手里其实有了一个可复用的底座OpenClaw 负责本地执行TaoToken 负责模型推理两者通过一个 Base URL 和一个 Key 解耦。这个解耦的价值在你后续想扩展时才会体现出来。比如你哪天想换成更强的模型跑复杂任务只需要改.env里的DEFAULT_MODEL一行Gateway 重启其余不动。想接 Cline 做代码补全、接 Codex 做命令行辅助也是同一套 Base URL Key Model ID 三件套填进去就行。想长期跑 Agent 任务、不想每次手动开可以了解下 Coding Plan 这类按周期计费的方案https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。如果你在配置过程中想先确认某个模型的实际表现再决定用哪个可以直接在模型对话页试https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。接入细节和参数说明在文档里https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。最后给一个我自己的习惯把.env和config.json备份一份到非安装目录。OpenClaw 升级或重装时安装目录可能被覆盖配置丢了就得重填。备份一份重装后直接拷回去省事。
阅读完成 · 觉得有帮助？
