1. 为什么 Win11 上跑 OpenClaw 总卡在“部署”这一步OpenClaw 是一个能在本地执行文件整理、浏览器操作、键鼠模拟的智能体框架适合想把重复办公动作交给程序自动跑的人。它和普通聊天工具最大的区别是模型输出不只是文字还会转成真实的本机操作指令。所以部署环节比一般 Python 项目更挑剔——环境、权限、模型通道三者缺一个界面就会停在 Gateway 离线。我在 Win11 上前后装过三台机器踩过的坑集中在三块一是依赖装完但服务起不来二是配置文件路径找错导致 Key 没被读取三是模型通道没通日志里反复刷连接失败。前两个属于本地环境问题第三个才是真正影响“能不能用”的关键。这篇就按从零到跑通的顺序写把可复制的配置片段和验证动作都给出来模型接入统一走 TaoToken 的 Key/API 通道省去到处找不同厂商 Key 的麻烦。适合谁看手里是 Win11、想本地跑一个能操作电脑的智能体、又不想在模型接入上反复折腾的人。全程不需要你懂太多底层照着命令和配置改就行。下面从环境准备开始每一步都给出验证方式跑不通就对照第 5 节的报错排查。2. TaoToken 统一 Key 接入前的准备工作OpenClaw 本身不带模型它需要一个兼容 OpenAI 协议的接口来发请求。TaoToken 提供的就是这样一个统一入口你拿一个 Key就能在 OpenClaw 里调用多个模型不用为每个模型单独配一套地址和密钥。官网在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 注册后在控制台生成 Key 即可。先明确三件套后面配置里反复用到项目值说明Base URLhttps://taotoken.net/api不加 UTM直接填这个API Key控制台生成形如 sk- 开头的一串Model ID按需选例如 claude-sonnet 系列、gpt 系列拿 Key 的路径进入控制台 → API Keys → 新建 → 复制保存。这个 Key 只显示一次丢了就重建。如果你打算长期跑编码类 Agent可以顺带看下 Coding Plan 页面额度模型和按量计费不一样选之前先想清楚用途。环境侧要准备的东西不多但版本要对Windows 11 22H2 及以上保证有较新的 PowerShell。Python 3.10 或 3.11别用 3.12 早期版本部分依赖轮子还没跟上。Git用于拉取源码或更新。一个纯英文、无空格的安装目录比如D:\OpenClaw。先验证 Python 和 Git 是否就位打开 PowerShell 执行python --version git --version正常会分别输出Python 3.11.x和git version 2.x。如果 python 提示找不到命令说明没加进 PATH重装时勾选“Add Python to PATH”。这一步别跳过后面虚拟环境建不起来多半是这里的问题。注意安装目录千万别用中文或空格。D:\软件\OpenClaw这种路径在依赖编译阶段会报编码错误改成D:\OpenClaw最省事。3. 可复制的 OpenClaw 配置片段与依赖安装环境确认后先建目录再拉代码。我习惯把项目和虚拟环境放同一层方便管理mkdir D:\OpenClaw cd D:\OpenClaw git clone https://github.com/openclaw/openclaw.git app cd app python -m venv .venv .\.venv\Scripts\Activate.ps1激活后命令行前面会出现(.venv)。如果提示“无法加载文件因为在此系统上禁止运行脚本”用管理员 PowerShell 执行一次Set-ExecutionPolicy RemoteSigned再重试。接着装依赖。项目根目录一般有requirements.txtpip install -r requirements.txt装完验证关键包pip show openai能显示版本号就说明基础依赖 OK。OpenClaw 读取配置的位置通常在项目根目录的config文件夹或者用户目录下的.openclaw。以项目内配置为例新建config/settings.json把三件套填进去{ gateway: { host: 127.0.0.1, port: 8765 }, model: { provider: openai-compatible, base_url: https://taotoken.net/api, api_key: sk-你的Key, model_id: claude-sonnet-4-20250514, timeout: 60 }, agent: { allow_file_ops: true, allow_browser_ops: true, workspace: D:\\OpenClaw\\workspace } }几个字段说明一下base_url必须是https://taotoken.net/api结尾不要多加/v1OpenClaw 内部会自己拼路径model_id换成你在控制台看到的实际模型名workspace是智能体读写文件的根目录单独划一个盘符目录更安全。如果你用的是 Codex 那套认证方式配置会落在auth.json结构类似{ base_url: https://taotoken.net/api, api_key: sk-你的Key, model: claude-sonnet-4-20250514 }三件套 Base URL、Key、Model ID 一个都不能少缺哪个都会在启动时报认证或模型不存在。填完保存别用记事本存成带 BOM 的 UTF-8用 VS Code 存普通 UTF-8 更稳。4. 启动 OpenClaw 并验证请求是否成功配置就位后启动服务。在激活的虚拟环境里执行python -m openclaw start或者项目提供了启动脚本的话.\start.ps1启动过程会打印监听地址和 Gateway 状态。看到类似下面的输出就说明服务起来了[INFO] Gateway listening on http://127.0.0.1:8765 [INFO] Model provider: openai-compatible [INFO] Gateway status: online界面右上角显示“Gateway 在线”是最终目标。如果显示离线先别急着改配置用一条最小请求单独验证模型通道是否通。新开一个 PowerShell 窗口执行curl.exe https://taotoken.net/api/v1/chat/completions -H Authorization: Bearer sk-你的Key -H Content-Type: application/json -d {\model\:\claude-sonnet-4-20250514\,\messages\:[{\role\:\user\,\content\:\ping\}]}返回里带choices字段和一段回复内容就证明 Key、地址、模型名三者都对。这一步能把“本地服务问题”和“模型通道问题”彻底分开curl 通但界面离线是 OpenClaw 配置没读到curl 不通是 Key 或地址的问题。curl 通过后回到 OpenClaw 界面在底部输入框发一条简单指令比如“列出 workspace 目录下的文件”。智能体执行完返回结果说明整条链路打通。第一次执行会慢一点因为要初始化运行环境等 1 到 3 分钟属正常。5. 常见报错排查401、local proxy failed 与 reading choices部署阶段的高频报错就那么几个对照着改基本能解决。401 UnauthorizedKey 错了或没被读到。先确认settings.json里的api_key和 curl 用的是同一个再检查有没有多余空格或换行。如果 Key 是从网页复制的注意别把前后空白带进去。还有一种情况是配置文件路径不对OpenClaw 读的是另一份旧配置用python -m openclaw config show打印当前生效配置核对。local proxy failed / connection refused本地代理或端口冲突。检查gateway.port是否被别的程序占用换一个端口比如 8766 再试。如果系统里设过全局代理环境变量先临时清掉$env:HTTP_PROXY $env:HTTPS_PROXY然后重启 OpenClaw。代理残留会让请求发到错误地址表现就是连不上。reading choices 报错 / 返回体解析失败通常是模型名写错或者接口返回的不是标准结构。先用第 4 节的 curl 确认模型名有效再检查base_url有没有多写/v1多写会导致路径拼成/v1/v1/chat/completions返回 404 或非 JSON 内容解析自然失败。OAuth 相关报错如果你走的是需要 OAuth 的认证方式token 过期会报这个。重新在控制台生成 Key或按文档刷新凭证。用 TaoToken 的 Key 方式一般不涉及 OAuth遇到就说明配置里混进了别的认证字段删掉多余的再启动。Gateway 一直离线按顺序查——安装路径是否纯英文、配置文件是否被正确读取、curl 是否通、端口是否被占。四个都过一遍基本能定位。排障时建议开一个日志窗口python -m openclaw start --log-level debugdebug 日志会把请求地址、返回码都打出来比猜快得多。6. 把 Key 管好让 OpenClaw 长期稳定跑下去跑通只是开始长期用要注意两件事Key 管理和额度规划。Key 别硬编码在会提交到 Git 的文件里用环境变量或单独的本地配置文件并加进.gitignore。OpenClaw 支持从环境变量读 Key 的话优先用这种方式$env:TAOTOKEN_API_KEYsk-你的Key配置里对应字段留空或写占位符启动时自动注入。额度方面日常轻量使用按量计费就够如果打算让它长时间跑编码或 Agent 任务提前看下 Coding Plan 的额度模型避免跑到一半断掉。模型对话页面可以用来快速验证某个模型是否可用不用每次都启动 OpenClaw。需要复查 Key 或新建时直接进 API Keys 页面接入细节和字段说明看接入文档。把这几处存成书签下次换机器或重装时照着走一遍十分钟内能重新跑起来。