1. 为什么要在 Windows 上折腾 OpenClaw 本地智能体OpenClaw 是一个能在本地跑起来的 AI 智能体框架你可以把它理解成一个住在你电脑里的自动化助手你说一句把 D 盘下载文件夹里的图片按月份归档它会自己拆解步骤、调用文件系统工具、动手完成。和纯聊天类 AI 最大的区别在于OpenClaw 的重点是执行不是陪你聊天。它适合谁适合每天有大量重复文件整理、表格汇总、浏览器信息采集需求又不想把数据传到云端的 Windows 用户。但真正上手时很多人卡在同一个地方环境。Python 版本、Node.js、Git、环境变量、依赖冲突光是这几个词就够劝退。更麻烦的是OpenClaw 本身只是一个执行大脑它需要接一个大模型来理解你的指令。如果你直接去接官方 API会遇到两个现实问题一是海外服务在本地网络下经常连不上或超时二是按量计费对刚上手的人不友好跑几个任务就心疼。我试过的思路是本地部署 OpenClaw 负责执行模型调用统一走 TaoToken 的 API 通道。TaoToken 提供兼容 OpenAI 格式的统一 Key一个 Key 就能调用多种模型配置进 OpenClaw 的 config.toml 后本地智能体就能稳定拿到模型响应。这样你既保留了本地执行的数据安全性又避开了直连海外服务的网络和计费坑。下面这套流程是我在 Windows 11 上从零跑通的完整版本包含可复制的配置骨架和报错排查。2. 环境准备Windows 上跑 OpenClaw 需要什么2.1 系统与依赖清单在动手之前先把基础环境确认清楚。OpenClaw 在 Windows 上依赖 Node.js 运行时和 Git部分工具调用还需要 Python。建议按下表准备组件推荐版本作用检查命令Windows10 21H2 / 11系统底座winverNode.js20 LTS运行 OpenClaw 主程序node -vnpm随 Node 附带安装依赖npm -vGit2.40拉取仓库与技能包git --versionPython3.11部分工具脚本python --versionNode.js 一定要用 20 LTS不要用最新的奇数版本OpenClaw 的部分依赖在奇数版上会编译失败。安装 Node 时勾选Add to PATH装完打开新的 PowerShell 窗口验证旧窗口不会刷新环境变量。2.2 安装路径与安全软件安装路径必须是纯英文不能有中文、空格或特殊符号。推荐D:\OpenClaw不要用D:\软件\OpenClaw或D:\Open Claw。路径里有中文时Node 在解析模块路径会报Cannot find module这个错很难往路径上想。另外OpenClaw 运行时会读写文件、模拟输入容易触发安全软件误报。安装阶段可以临时关闭实时防护装完再把 OpenClaw 目录加入白名单。这不是让你长期裸奔只是避免安装中途文件被隔离导致部署失败。2.3 获取 TaoToken API Key模型通道这边先去 TaoToken 控制台创建一个 API Key。地址是 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite 登录后点创建密钥复制那串以sk-开头的字符串。这个 Key 后面要填进 OpenClaw 的配置里相当于本地智能体调用模型的通行证。注意Key 只在创建时完整显示一次复制后先存到记事本别直接关页面。如果泄露了在控制台删除重建即可。TaoToken 的 API 基地址是 https://taotoken.net/api 它兼容 OpenAI 的接口格式所以 OpenClaw 里凡是要求填base_url的地方都填这个地址注意结尾不要多加/v1具体看下面配置说明。3. 安装 OpenClaw 与接入 TaoToken 的完整配置3.1 安装 OpenClaw 主程序打开 PowerShell用 npm 全局安装 OpenClaw。如果你拿到的是整合包也可以直接解压运行一键启动程序但用 npm 安装更利于后续升级# 确认 Node 版本必须是 20.x node -v # 全局安装 OpenClaw npm install -g openclaw3.1.0 # 验证安装 openclaw --version如果openclaw --version报不是内部或外部命令说明 npm 全局目录没进 PATH。执行npm config get prefix看路径把它加到系统环境变量 Path 里重开终端。3.2 config.toml 骨架把模型通道指向 TaoTokenOpenClaw 的主配置放在用户目录下的.openclaw\config.toml。如果目录不存在就手动建。下面是我实测可用的骨架重点是[model]段# D:\OpenClaw\config.toml 或 %USERPROFILE%\.openclaw\config.toml [gateway] host 127.0.0.1 port 18789 # 本地网关只监听本机不要改成 0.0.0.0 [model] # 走 TaoToken 统一通道兼容 OpenAI 格式 provider openai-compatible base_url https://taotoken.net/api api_key sk-你从控制台复制的Key model claude-3-5-sonnet # 模型名按 TaoToken 控制台里可用的填这里只是示例 [agent] workspace D:\\OpenClaw\\workspace max_steps 20 # 单个任务最多执行 20 步防止死循环 [tools] enable_filesystem true enable_browser true enable_shell false # shell 默认关掉需要时再开安全第一几个关键点base_url填https://taotoken.net/api不要自己拼/v1/chat/completionsOpenClaw 会自动补全路径。api_key就是刚才那串sk-开头的 Key。model字段填你在 TaoToken 控制台看到的模型标识不同模型能力不同编码类任务建议选长上下文版本。3.3 settings.json工具与权限细项除了 config.tomlOpenClaw 还有一个settings.json管工具权限和运行参数放在同一目录{ gateway: { autoStart: true, logLevel: info }, tools: { filesystem: { allowedPaths: [D:\\OpenClaw\\workspace, D:\\Downloads], readOnly: false }, browser: { headless: false, timeout: 30000 } }, model: { temperature: 0.2, maxTokens: 4096, requestTimeout: 60000 } }allowedPaths是文件工具的沙箱范围只允许智能体在这几个目录里操作避免它误删系统文件。temperature设 0.2 是因为自动化任务要的是稳定执行不是创意发挥。requestTimeout给到 60 秒模型响应慢时不至于直接断。3.4 启动与验证请求配置写好后启动 OpenClawopenclaw start第一次启动会初始化 Gateway界面显示正在等待 Gateway 就绪等 1 到 3 分钟正常。看到右上角显示Gateway 在线就成功了。接着验证模型通道是否真的通了。在 OpenClaw 输入框里发一条最简单的指令列出 D:\OpenClaw\workspace 目录下的所有文件如果它能返回文件列表说明模型调用和工具执行都正常。如果卡住或报模型错误先用 curl 单独测一下 TaoToken 通道curl https://taotoken.net/api/chat/completions -H Authorization: Bearer sk-你的Key -H Content-Type: application/json -d {\model\:\claude-3-5-sonnet\,\messages\:[{\role\:\user\,\content\:\ping\}]}返回带choices字段的 JSON就说明 Key 和通道没问题问题在 OpenClaw 配置侧。想直接在网页里对比不同模型的响应效果可以用模型对话页面 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentchatutm_campaignrewrite 快速验证。4. 跑通第一个本地任务与结果确认4.1 一个可复制的文件整理任务环境通了之后用一个真实任务验证整条链路。在 OpenClaw 输入帮我整理 D:\Downloads 里的图片按文件修改日期分到 2024、2025 两个子文件夹 没有日期的放到未分类文件夹操作前先列出计划让我确认。OpenClaw 会先输出一个执行计划你确认后它才动手。这一步很重要max_steps和确认机制能防止它乱来。执行完成后去D:\Downloads看目录结构应该出现按年份分的文件夹。4.2 成功结果的判断标准判断任务是否真的成功看三个地方一是 OpenClaw 界面显示任务状态为完成没有红色报错二是文件系统里的实际变化符合预期三是 Gateway 日志里没有tool_error或model_timeout。三者都满足才算这条链路稳定。如果你打算长期跑编码类或 Agent 类任务单次按量调用成本会累积可以了解下 Coding Plan https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite 它更适合高频使用的场景。5. 本篇常见报错排查5.1 Gateway 一直离线最常见的原因是端口被占用或安全软件拦截。先确认 18789 端口没被别的程序占用netstat -ano | findstr 18789有输出就说明被占了改 config.toml 里的 port 换一个。如果端口正常但还离线检查安全软件隔离区把被删的 OpenClaw 文件恢复并加白名单然后重启 Gateway。5.2 模型调用报 401 或 403401 基本是 Key 错了。检查 config.toml 里api_key有没有多余空格sk-前缀是否完整。403 通常是 Key 权限或额度问题去 TaoToken 控制台确认 Key 状态和余额。还有一种情况是base_url写成了https://taotoken.net/api/v1多加了/v1导致路径重复改回https://taotoken.net/api即可。5.3 任务执行到一半卡住先看是不是max_steps太小复杂任务 20 步不够用调到 40 试试。如果卡在某个工具调用上多半是该工具的超时设置太短把 settings.json 里的requestTimeout和 browser 的timeout都调大。另外指令太模糊也会让模型反复试探把任务拆成更小的步骤重新下发成功率会明显提升。5.4 中文路径导致的诡异错误如果你没听劝用了中文路径可能出现ENOENT或Cannot find module。解决办法只有一个把 OpenClaw 整个目录移到纯英文路径重新生成配置。别试图改环境变量绕过后面坑更多。6. 后续怎么用得更顺基础跑通后接入文档 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 里有更细的接口说明和参数解释遇到配置项不确定时可以直接查。控制台 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 能看每次调用的消耗方便你判断哪个模型性价比高。真正决定 OpenClaw 好不好用的不是安装而是指令写法。把帮我整理文件改成把 D:\Downloads 里所有 .jpg 按修改月份移到对应文件夹文件名保留原样执行成功率会差很多。任务描述越具体智能体越不容易跑偏。先从文件整理、表格汇总这类规则清晰的任务练手熟悉了再碰浏览器自动化和多步流程。
