1. 为什么要在 Windows11 上本地部署 OpenClaw 智能体OpenClaw 是一款可以在本地运行的 AI 智能体自动化工具社区里习惯叫它“龙虾”。它能听懂自然语言指令然后直接操作你电脑上的文件、脚本、软件把重复性的操作接管过去。和纯聊天机器人不同OpenClaw 的重点是“动手执行”——读取本地表格、生成报告、调用接口推送消息这些都能在对话里一句话完成。适合谁用适合每天要处理固定报表、定时备份文件、批量整理目录又不想每次都手写脚本的开发者。我这次把它部署在 Windows11 上目标很明确不依赖 WSL2、不依赖 Docker纯本地跑起来并且通过 TaoToken 统一 Key 通道接入模型服务让 OpenClaw 的推理请求走一个稳定的 API 入口。为什么强调统一 Key因为 OpenClaw 本身不绑定某一家模型它需要一个兼容 OpenAI 协议的接口地址和 Key。TaoToken 提供的就是这样一个统一通道Base URL 固定、Key 统一管理切换模型时不用改一堆配置文件。部署前先确认环境Windows11 22H2 以上、Python 3.10、Node.js 18、Git可选。内存建议 8GB 以上因为本地智能体在解析任务时会占用一定资源。整个流程分两大块先把 OpenClaw 本体跑起来再把模型通道接进去。很多人卡在第二步报 401 或者 local proxy failed后面会专门讲排查。我试过用安装包和源码两种方式安装包适合纯新手源码适合要改端口、加自定义工具的场景。这篇教程以源码部署为主线因为源码方式能看清配置文件的每一行出问题也好定位。安装包方式会在关键步骤里顺带说明差异。先给结论Windows11 本地部署 OpenClaw 的核心是三件事——Python 环境、依赖安装、模型通道配置。前两件是体力活第三件是决定能不能真正用起来的关键。下面按顺序来每一步都给可复制的命令和配置。2. TaoToken 前置准备统一 Key 与 API 通道OpenClaw 启动后所有自然语言指令都要发给模型做意图解析和任务规划。默认配置里它可能指向某个公共端点但公共端点经常限流、超时尤其在批量自动化任务里会直接卡住。所以第一步先把模型通道换成 TaoToken 的统一入口。你需要准备两样东西一个 API Key一个 Base URL。Base URL 是https://taotoken.net/api注意这个地址不带任何查询参数直接填在配置里。API Key 在 TaoToken 控制台的 API Keys 页面创建创建后复制保存页面关闭后不会再完整显示。具体操作路径打开 TaoToken 官网进入控制台找到 API Keys 菜单点新建 Key命名比如openclaw-win11然后复制。如果你还没决定用哪个模型可以先在模型对话页面测试一下确认 Key 能正常返回内容再填进 OpenClaw。这里有个细节OpenClaw 的模型配置通常写在config.json或者环境变量里。源码部署时配置文件在源码根目录安装包部署时配置文件在安装目录的config子目录。不管哪种方式你都要找到base_url、api_key、model这三个字段。TaoToken 的 Base URL 填https://taotoken.net/apiKey 填刚才复制的Model ID 填你要用的模型标识比如claude-sonnet-4-20250514或者gpt-4o具体以 TaoToken 文档里的模型列表为准。为什么不用默认通道因为 OpenClaw 在执行多步任务时会连续发多次请求默认通道一旦触发限流任务就断在半路而且报错信息往往只显示reading choices失败很难定位。统一走 TaoToken 后Key 和额度在一个地方管理排查也方便。如果你打算长期跑自动化任务比如每天定时分析表格建议直接上 Coding Plan额度更稳适合 Agent 类高频调用。只是临时测试的话API Keys 按量用就够了。接入文档在 TaoToken 的 doc 页面里面有完整的 Base URL 和模型 ID 对照表配置前扫一眼能省很多事。3. 可复制配置Windows11 源码部署与 settings 片段这一节给完整的可复制配置。先装环境再改配置文件最后启动。第一步装 Python 3.10。去 python.org 下载 Windows Installer 64-bit安装时务必勾选Add Python to PATH。装完打开 cmd 验证python --version显示Python 3.10.x即可。如果显示的是 Microsoft Store 的占位提示说明 PATH 没配好重新安装并勾选 PATH。第二步装 Node.js 18。去 nodejs.org 下载 Windows 安装包默认下一步。验证node -v npm -v第三步下载 OpenClaw 源码。用 Git 克隆或者直接下载 ZIP 解压到D:\OpenClaw_Source路径不要有中文和空格。第四步安装依赖。在源码目录新建install_deps.bat内容如下echo off cd /d %~dp0 pip install -r requirements.txt -i https://mirrors.aliyun.com/pypi/simple/ npm install --registryhttps://mirrors.cloud.tencent.com/npm/ echo 依赖安装完成 pause双击运行等出现“依赖安装完成”。第五步配置模型通道。打开源码目录的config.json找到模型相关字段改成{ model: { base_url: https://taotoken.net/api, api_key: 你的TaoToken Key, model_id: claude-sonnet-4-20250514, timeout: 60, max_retries: 3 }, server: { port: 18789, host: 127.0.0.1 } }注意base_url结尾不要加/v1TaoToken 的兼容层会自动处理路径。model_id按你实际要用的填不确定就先去模型对话页面确认。如果你用的是安装包版本配置文件路径通常是D:\OpenClaw\config\settings.json字段名可能略有差异但base_url、api_key、model_id这三个核心字段是一致的。找不到就用记事本打开搜索base_url。第六步启动。新建start.batecho off cd /d %~dp0 python main.py pause双击后终端显示OpenClaw服务启动成功端口18789。浏览器访问http://127.0.0.1:18789能看到对话界面就说明本体跑起来了。这里补一句关于 CC Switch 和 Cline MCP 的配置。如果你同时用 Cline 做 MCP 工具调用Cline 的 MCP 配置里也要填 Base URL、Key、Model ID 三件套Base URL 同样是https://taotoken.net/api。Codex 的auth.json里则是api_base、api_key、model三个字段。三件套缺一不可少一个就会在调用时报 401 或者 model not found。4. 验证请求一条自动化流程确认部署生效配置改完不代表能用必须发一条真实请求验证。打开 OpenClaw 对话界面输入一条会触发本地文件操作的指令比如请读取 D:\OpenClaw_Source\test_data.csv统计行数和列数返回结果。如果模型通道配置正确OpenClaw 会先解析你的意图然后调用本地文件读取工具最后在对话里返回类似“文件共 120 行5 列”的结果。这个过程会连续发至少两次模型请求一次做意图解析一次做结果总结。如果第一次就失败说明 Key 或 Base URL 有问题如果第一次成功第二次失败说明额度或模型 ID 有问题。更完整的验证是跑一条自动化链路。在源码目录建一个test_data.csv随便写几行数据然后输入请分析 D:\OpenClaw_Source\test_data.csv统计每列的非空数量生成一段文字报告保存到 D:\OpenClaw_Source\report.txt。执行成功后打开report.txt应该能看到报告内容。同时在终端里能看到请求日志类似[INFO] POST https://taotoken.net/api/v1/chat/completions [INFO] modelclaude-sonnet-4-20250514 status200 [INFO] tool_call: read_file - test_data.csv [INFO] tool_call: write_file - report.txt看到status200和tool_call两条记录就说明模型通道和本地工具链都通了。这一步是整个部署的验收标准别跳过。如果终端没有日志去config.json里把log_level改成debug重启后再试。日志会告诉你请求发到了哪个地址、返回了什么状态码。5. 本篇常见错排查401、local proxy failed、reading choices部署过程中最容易遇到四类报错逐个说清楚。第一类401 Unauthorized。终端显示401或者invalid api key。原因通常是 Key 复制不完整、Key 前后有空格、或者配置文件里api_key字段名写错。排查方法把 Key 粘贴到模型对话页面测试能返回内容说明 Key 有效然后在config.json里确认字段名是api_key而不是apikey或token。另外注意 JSON 里字符串要用双引号单引号会导致解析失败。第二类local proxy failed。这个报错说明 OpenClaw 尝试走本地代理但没连上。检查config.json里有没有proxy字段如果有删掉或者设为空字符串。TaoToken 的 Base URL 是直连的不需要额外代理配置。另外检查系统环境变量里有没有HTTP_PROXY、HTTPS_PROXY有的话临时清掉再启动。第三类reading choices 失败。报错信息类似error reading choices: unexpected end of JSON input。这通常是模型返回了空响应或者非 JSON 格式。原因可能是model_id填错了TaoToken 找不到对应模型也可能是base_url多写了/v1导致路径重复。确认base_url是https://taotoken.net/apimodel_id在 TaoToken 文档的模型列表里能查到。第四类OAuth 相关报错。如果你在配置里看到了oauth字段说明 OpenClaw 尝试走 OAuth 流程但 TaoToken 用的是 API Key 模式不需要 OAuth。把oauth相关字段删掉只保留api_key。Codex 的auth.json里如果混了 OAuth 配置也要清掉只留api_base、api_key、model。还有一个隐蔽的坑端口占用。如果 18789 被其他程序占了启动会报address already in use。改config.json里的port为 18790 或其他空闲端口重启即可。排查顺序建议先看终端日志的 HTTP 状态码再看配置文件字段名最后用模型对话页面单独测 Key。三步下来基本能定位。6. 长期使用建议与接入入口部署跑通后日常使用有几个实用技巧。第一把start.bat放到桌面快捷方式需要时双击启动不用时关掉终端避免后台常驻占资源。第二自动化任务如果涉及定时触发可以用 Windows 任务计划程序调用start.bat但注意任务计划里的工作目录要设成源码目录否则cd /d %~dp0会失效。第三config.json里的max_retries建议设 3网络抖动时自动重试避免任务中断。如果你要跑长期编码类或 Agent 类任务比如每天自动分析日志、生成报告并推送建议用 Coding Plan额度稳定不会因为按量计费的余额波动导致任务失败。只是偶尔测试的话API Keys 按量用就够。接入入口整理一下API Key 在 API Keys 页面创建接入文档在 doc 页面模型测试在模型对话页面长期编码任务看 Coding Plan。Claude Code 相关的 Anthropic 兼容配置也在文档里有说明Base URL 同样是https://taotoken.net/api。最后提醒一点OpenClaw 的权限较高能读写本地文件、执行脚本。日常使用时以普通用户身份运行不要用管理员权限避免误操作影响系统目录。指令里避免出现删除、格式化这类危险动作模型会严格执行你的每一句话。