1. Windows 本地从零搭建 openclaw先把环境这关过了openclaw 是一个可以跑在 Windows 本地的 AI Agent 网关它能把你常用的聊天工具比如飞书和背后的大模型连起来让你在群里 一下机器人就能下指令、执行任务。适合谁适合想在本地折腾一个可控 AI 助手、又不想把数据全丢到云端的开发者或者单纯想体验 Agent 编排的折腾党。这篇我会把从 Node.js 环境准备、openclaw 安装、DeepSeek 模型接入到 config.toml 配置骨架、启动验证、常见报错排查的完整链路走一遍你跟着敲就能跑通。整个流程分四块第一块是 Windows 上把 Node.js 和 npm 装好这是 openclaw 的运行底座第二块是用 npm 全局安装 openclaw 并验证版本第三块是接入模型这里我用 TaoToken 的统一 Key 来管多家模型省得每个平台单独配第四块是写 config.toml 骨架并启动网关验证。中间踩坑最多的其实是 npm 安装阶段的 git 协议报错和缓存问题我会把处理动作写清楚。先确认你的 Windows 版本Win10 和 Win11 都行建议 22H2 以上。内存 8G 起步16G 更稳因为后面跑网关加浏览器会吃点资源。磁盘留 5G 以上给 npm 全局包和缓存。网络方面能正常访问 npm registry 和模型 API 地址就行不需要额外折腾网络工具这点先说明白免得你走弯路。2. Node.js 与 npm 环境准备2.1 下载与安装 Node.js打开 Node.js 官网下载 LTS 版本写这篇时是 20.x 系列。Windows 选.msi安装包双击一路下一步。安装向导里有个勾选项 Automatically install the necessary tools如果你不想装 Visual Studio Build Tools 那一大坨可以先不勾后面真缺了再补。安装路径默认C:\Program Files\nodejs\就行别放中文目录openclaw 有些路径处理对中文不友好。装完打开一个新的 PowerShell 或 CMD 窗口注意必须是新开的旧窗口环境变量没刷新。执行node -v npm -v正常会输出类似v20.11.1和10.2.4。如果提示node 不是内部或外部命令说明 PATH 没生效重启终端或者手动把C:\Program Files\nodejs\加到系统环境变量 Path 里。2.2 npm 源与全局目录国内直连 npm 有时候慢可以换成淘宝源但注意换源后某些包的 postinstall 脚本可能行为不一致。我实测下来如果公司网络还行先用默认源卡了再换npm config set registry https://registry.npmmirror.com npm config get registry全局包目录建议确认一下避免权限问题npm config get prefix如果输出的是C:\Users\你的用户名\AppData\Roaming\npm这是用户级目录一般不需要管理员权限。如果输出C:\Program Files\nodejs那全局安装可能要管理员终端建议改成用户级npm config set prefix C:\Users\你的用户名\AppData\Roaming\npm改完把C:\Users\你的用户名\AppData\Roaming\npm加到 Path 里重新开终端。3. 安装 openclaw 与 git 协议报错处理3.1 全局安装命令环境好了直接装npm install -g openclaw装完验证openclaw --version能打印出版本号就说明二进制装好了。如果这一步报错大概率是下面两种。3.2 报错一gitgithub.com 协议失败典型报错长这样npm ERR! Error while executing: npm ERR! git clone gitgithub.com:xxx/xxx.git npm ERR! Permission denied (publickey)原因是某些依赖用 SSH 协议拉 GitHub而你本地没配 SSH key。解决办法是让 git 把 SSH 地址重写成 HTTPSgit config --global url.https://github.com/.insteadOf gitgithub.com:执行完再清一下 npm 缓存避免拉到半截的坏包npm cache clean --force然后重新npm install -g openclaw。这个坑我踩过重写协议后基本一次过。3.3 报错二权限与缓存损坏如果报EACCES或EPERM说明全局目录没写权限。用管理员身份开 PowerShell 重装或者按 2.2 改成用户级 prefix。如果报Unexpected end of JSON input这类缓存损坏同样npm cache clean --force后重装。装完再跑一次openclaw --version确认。4. TaoToken 统一 Key 接入与 config.toml 配置骨架4.1 为什么用 TaoToken 统一 Keyopenclaw 支持自定义 OpenAI 兼容端点你可以直接填 DeepSeek 官方地址。但如果你后面想换模型、加模型每个平台单独管 Key 很烦。TaoToken 提供统一 Key一个 Key 走多家模型配置里只改模型名就行。官网入口在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 基址是 https://taotoken.net/api 注意这个地址不带 UTM 参数配置里填干净的。先去控制台创建 API Key入口https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 。创建后复制只显示一次。模型对话调试页在 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 可以先用它验证 Key 通不通。4.2 config.toml 骨架openclaw 的配置文件默认在用户目录下Windows 一般是C:\Users\你的用户名\.openclaw\config.toml。如果目录不存在先跑一次openclaw onboard让它生成或者手动建。下面是我实测可用的骨架你按需改# openclaw 主配置 [gateway] host 127.0.0.1 port 18789 log_level info # 模型提供方TaoToken 统一 Key [providers.taotoken] type openai base_url https://taotoken.net/api api_key sk-你的TaoTokenKey default_model deepseek-chat # 模型别名方便在 agent 里引用 [models.deepseek-chat] provider taotoken model deepseek-chat max_tokens 4096 temperature 0.7 [models.deepseek-reasoner] provider taotoken model deepseek-reasoner max_tokens 8192 temperature 0.6 # Agent 默认使用的模型 [agent] default_model deepseek-chat system_prompt 你是一个运行在 Windows 本地的助手可以执行命令和操作浏览器。 # 工具权限开启命令执行与浏览器操作 [tools] profile coding deny [] elevated { enabled true } # 飞书接入可选 [channels.feishu] enabled true app_id cli_你的AppID app_secret 你的AppSecret connection_mode long_connection region cn group_policy mention_only几个关键点说明。base_url填https://taotoken.net/api不要带尾部斜杠openclaw 会自己拼/v1/chat/completions。api_key就是 TaoToken 控制台拿的那个。deepseek-chat对应非思考模式deepseek-reasoner对应思考模式按任务选。[tools]这段是让 openclaw 能真正干活的关键profile coding加上elevated.enabled true它才有权限执行命令、开浏览器。默认只有 message 聊天能力很多人卡在这以为装坏了。4.3 用 onboard 向导生成配置如果你不想手写可以跑向导openclaw onboard向导里模型选择那步列表里没有 TaoToken 就选最后一个自定义API 地址填https://taotoken.net/apiKey 粘贴进去接口兼容性直接回车OpenAI 格式模型名填deepseek-chatEndpoint ID 和 Model alias 随意填。后面飞书那几步按提示走密钥从飞书开放平台拿。向导卡住的话按一下回车有时候是终端渲染问题。5. 启动验证与成功结果配置写完启动网关openclaw gateway start或者前台跑看日志openclaw gateway run正常会看到类似输出[gateway] listening on 127.0.0.1:18789 [provider.taotoken] loaded model deepseek-chat [agent] ready然后浏览器打开http://127.0.0.1:18789能看到聊天页面。发一句 你好帮我列一下当前目录文件如果它返回内容并触发工具调用说明模型和工具链都通了。想单独验证 TaoToken Key 通不通可以用 curlcurl https://taotoken.net/api/v1/chat/completions ^ -H Authorization: Bearer sk-你的Key ^ -H Content-Type: application/json ^ -d {\model\:\deepseek-chat\,\messages\:[{\role\:\user\,\content\:\ping\}]}Windows CMD 里换行用^PowerShell 里用反引号。返回 JSON 里有choices就说明 Key 和端点没问题。如果返回 401检查 Key 有没有复制全返回 404检查 base_url 是不是多写了/v1。改完 config.toml 记得重启网关openclaw gateway restart6. 本篇常见报错排查6.1 openclaw 命令找不到装完openclaw --version报不是内部命令。先确认 npm 全局 prefix 在 Path 里npm config get prefix的输出目录要加到系统 Path。加完重开终端。还不行就npm list -g --depth0看 openclaw 在不在列表里不在说明没装上回第 3 步。6.2 模型返回 401 或 403Key 错了或者没带Bearer前缀。openclaw 配置里api_key只填 Key 本身不要手写Bearer。如果用的是 TaoToken确认 Key 没过期、额度没耗尽。可以先去模型对话页 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 测一下同一个 Key。6.3 工具不执行只聊天这是最常见的。检查 config.toml 里[tools]段profile必须是codingelevated.enabled必须是true。改完openclaw gateway restart。如果还不行看日志里有没有tool denied字样有的话是deny列表拦了清空它。6.4 飞书收不到消息先确认应用版本已发布飞书开放平台里改任何配置都要创建版本并发布才生效。然后确认群机器人加对了应用群 ID 填的是oc_开头那串。连接模式选长连接区域选国内。权限里消息与群组要全开。这几步缺一个都收不到。6.5 端口被占用gateway start报EADDRINUSE说明 18789 被占了。改 config.toml 里[gateway] port换个值比如 18790重启。或者用netstat -ano | findstr 18789找到占用进程处理掉。7. 后续接入与长期使用建议环境跑通后如果你打算长期用 openclaw 做编码辅助或者 Agent 编排建议把模型 Key 统一走 TaoToken换模型只改 config.toml 里的模型名不用动代码。API Key 管理入口在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 配置字段有疑问可以对着文档核。如果你主要跑 Claude Code 这类编码场景可以看 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite ClaudeCodeAnthropic 相关配置在 https://taotoken.net/claudecode-anthropic?utm_sourcetaotoken_aicg_blog_endutm_contentclaudecode-anthropicutm_campaignrewrite 。最后提醒一句[tools]开了 elevated 之后openclaw 能执行本机命令别把网关暴露到公网host 保持127.0.0.1飞书群策略用mention_only这样只有你 它才响应安全可控。配置改完养成openclaw gateway restart的习惯很多改了没生效都是忘了重启。