1. Windows 本地部署 OpenClaw 到底难在哪从安装到飞书联调的完整链路如果你最近在搜 Windows 本地部署 OpenClaw 教程大概率已经踩过几个坑PowerShell 脚本跑一半卡住、onboard 配置里模型地址填错、飞书机器人配对码不知道去哪输入。OpenClaw 本身是一个把本地网关、模型 API、聊天渠道串起来的框架它不是一个开箱即用的桌面软件所以每一步配置都会影响后面能不能跑通。我这次的目标很明确在 Windows 上把 OpenClaw 跑起来模型走云端 API聊天渠道接飞书最后实现飞书里发消息、机器人正常回复。整条链路涉及四个环节——安装 OpenClaw、配置模型提供商、配置飞书渠道、验证消息收发。任何一个环节的 Base URL、Key 或 Model ID 填错都会表现为机器人不回复或者报 401。这篇文章适合谁适合已经在 Windows 上装过 Node 环境、想用飞书做个人助理或团队机器人的开发者也适合之前用其他方式接过模型 API、现在想换成统一 Key 管理的人。我会把每一步的命令、配置文件片段、飞书后台填写位置都写清楚你跟着做就能完成端到端自检。需要提前说明的是OpenClaw 的安装脚本和 onboard 交互界面会随版本更新本文以我实际操作的流程为准遇到界面差异时以官方文档为准。模型侧我使用的是 TaoToken 的统一 Key它的 Base URL 和 OpenAI 兼容格式一致配置起来比较直接。下面从安装开始。2. TaoToken 统一 Key 前置准备Base URL、auth.json 与模型 ID 怎么填在开始配置 OpenClaw 之前先把模型侧的凭证准备好。TaoToken 提供的是 OpenAI 兼容接口也就是说你拿到的 Key 可以像调用 OpenAI 一样使用Base URL 固定为https://taotoken.net/api。这个地址在 OpenClaw 的 Custom Provider 配置里要填对填错会直接导致验证失败。你需要准备三样东西Base URL、API Key、Model ID。Base URL 就是上面那个API Key 在控制台的 API Keys 页面创建格式一般是sk-开头Model ID 取决于你想用哪个模型比如deepseek-v3、gpt-4o这类具体以你账号里可用的模型列表为准。这三样在 OpenClaw 的 onboard 流程里会依次让你输入。如果你用的是 Claude Code 或者 Codex 这类工具TaoToken 也支持通过auth.json或环境变量的方式接入。以 Codex 的auth.json为例配置结构大致如下{ base_url: https://taotoken.net/api, api_key: sk-你的Key, model: deepseek-v3 }这个文件一般放在用户目录下的.codex或对应工具的配置目录里具体路径以工具文档为准。OpenClaw 本身不走auth.json它是在 onboard 交互里直接填 Base URL 和 Key但如果你同时用 Codex 或 Claude Code可以共用同一个 Key省得管理多套凭证。这里有个容易忽略的点TaoToken 的 Base URL 不要加/v1后缀OpenClaw 和大多数 OpenAI 兼容客户端会自动补全路径。如果你填了https://taotoken.net/api/v1可能会出现 404 或路径重复的问题。我实测下来填https://taotoken.net/api就能正常验证通过。另外Model ID 要和你在 TaoToken 控制台里看到的模型名称一致。OpenClaw 在 onboard 时会做一次验证请求如果 Model ID 写错它会提示你重新输入。验证成功后你还需要给这个模型起一个别名比如DeepSeek-V3这个别名只是本地显示用不影响实际调用。准备好这三样之后就可以进入 OpenClaw 的安装和配置环节了。如果你还没有 Key可以先到 TaoToken 控制台创建一个创建时注意保存好页面关闭后不会再显示完整 Key。3. 可复制配置OpenClaw onboard 全流程与 openclaw.json 关键字段安装 OpenClaw 的第一步是用管理员方式打开 PowerShell然后执行官方安装脚本iwr -useb https://openclaw.ai/install.ps1 | iex等待脚本执行完成出现OK和版本号就说明安装成功了。如果中途报错多半是网络问题或者 PowerShell 执行策略限制可以先执行Set-ExecutionPolicy RemoteSigned -Scope CurrentUser再重试。安装完成后输入openclaw onboard进入配置向导。第一个界面会让你选择 QuickStart 还是 Manual我建议选 QuickStart它会自动引导你完成核心配置。如果你之前配置过会出现 Use existing values、Update values、Reset 三个选项按需选择即可。接下来是网关模式选择本地部署选Local gateway (this machine)。然后是工作区目录默认即可。到了模型提供商选择界面这里很关键如果你用 TaoToken 这类第三方模型必须选Custom Provider不要选 OpenAI 或 Anthropic 预设。选完 Custom Provider 后依次输入供应商地址https://taotoken.net/apiAPI Key你的sk-开头密钥模型名称比如deepseek-v3模型别名比如DeepSeek-V3输入模型名称后 OpenClaw 会发一次验证请求成功就直接回车进入下一步。网关端口默认不要改保持默认即可。绑定地址建议选LAN (0.0.0.0)因为飞书需要通过局域网访问网关。Tailscale 暴露选Off除非你有内网穿透需求。聊天渠道配置选Yes然后选Feishu/Lark (飞书)。如果插件下载报错可以跳过后面手动执行openclaw plugins install openclaw/feishu安装成功后会出现Enter App Secret提示直接回车进入飞书配置环节。这里需要你先去飞书开放平台注册应用拿到 App ID 和 App Secret然后粘贴进来。连接方式选长连接 WebSocket (default)群聊策略我选的是Disabled只做单聊。配置完成后OpenClaw 会生成openclaw.json配置文件。你可以用记事本或 VS Code 打开它检查关键字段{ gateway: { host: 0.0.0.0, port: 18789 }, providers: { custom: { baseUrl: https://taotoken.net/api, apiKey: sk-你的Key, model: deepseek-v3 } }, channels: { feishu: { appId: cli_xxxxxx, appSecret: xxxxxx, connectionMode: websocket } } }这个文件里的baseUrl、apiKey、model三件套必须和你在 onboard 里填的一致。如果后面机器人不回复优先检查这三个字段。飞书部分的appId和appSecret也要和开放平台后台一致。配置完成后选择是否安装为系统服务。我选了 Yes这样网关会开机自启。运行时环境选Node (recommended)不要选 Bun。如果提示网关已安装选Restart重启即可。4. 验证请求与成功结果飞书配对码、消息收发与网关自检配置完成后先别急着去飞书发消息先在本地验证网关是否正常。打开浏览器访问http://127.0.0.1:18789这是 OpenClaw 的本地网关地址。页面会要求输入令牌这个令牌在openclaw.json里或者启动日志里能找到。输入后如果能看到聊天界面说明网关和模型侧已经通了。在浏览器里发一条测试消息比如“你好”如果模型正常回复说明 Base URL、Key、Model ID 三件套没问题。如果报 401检查 Key 是否复制完整如果报 model not found检查 Model ID 是否和 TaoToken 控制台一致。本地验证通过后进入飞书。找到你创建的机器人随便发一句话机器人会回复一个配对码格式一般是六位数字或字母。这个配对码是用来绑定用户身份的防止陌生人调用你的机器人。拿到配对码后回到 PowerShell执行openclaw pairing approve feishu XXXXXX把XXXXXX换成你收到的配对码回车。看到成功提示后再回飞书发消息机器人就会正常回复了。如果机器人还是不回复检查飞书开放平台后台的权限配置确保机器人有接收消息和发送消息的权限并且事件订阅里配置了正确的回调地址或长连接。还有一个常见问题是网关绑定地址。如果你在 onboard 时选了Loopback (127.0.0.1)飞书的长连接可能无法正常建立因为飞书服务需要访问你的网关。建议改成LAN (0.0.0.0)然后重启网关openclaw gateway restart重启后再试一次飞书消息。如果还是不行查看网关日志openclaw gateway logs日志里会显示飞书连接状态和消息处理记录根据报错信息定位问题。常见的报错包括local proxy failed网关没启动或端口被占用、reading choices模型返回格式异常检查 Base URL 是否多了/v1、OAuth飞书凭证过期或权限不足。5. 本篇常见错排查401、local proxy failed、reading choices 与 OAuth这一节把我遇到的和读者反馈最多的报错整理出来对照排查能省不少时间。401 Unauthorized最常见的原因是 API Key 填错或过期。检查openclaw.json里的apiKey字段确认没有多余空格确认 Key 没有在控制台被删除。如果你用的是 TaoToken可以到控制台的 API Keys 页面重新创建一个然后更新配置文件并重启网关。local proxy failed这个报错通常出现在飞书消息发送时说明 OpenClaw 网关没有正常监听或者端口被占用。先执行openclaw gateway status查看网关状态如果没运行就执行openclaw gateway start。如果端口被占用检查openclaw.json里的port字段换一个空闲端口然后同步更新飞书后台的回调地址如果用 WebSocket 长连接则不需要改回调。reading choices这个报错说明模型返回的数据结构不符合预期OpenClaw 在解析choices字段时失败了。最常见的原因是 Base URL 填成了https://taotoken.net/api/v1导致请求路径变成/api/v1/chat/completions之外的多余路径。改成https://taotoken.net/api即可。另一个可能是 Model ID 写错模型返回了错误信息而不是正常的 completion 结构。OAuth 相关报错飞书渠道出现 OAuth 报错一般是 App ID 或 App Secret 填错或者飞书应用没有发布版本。到飞书开放平台检查应用凭证确认应用已经创建版本并发布。如果是长连接模式还要确认事件订阅里选择了“使用长连接接收事件”。配对码无效执行openclaw pairing approve feishu XXXXXX时提示配对码无效可能是配对码过期了。重新在飞书里给机器人发消息获取新的配对码然后尽快执行命令。另外确认命令里的渠道名是feishu不是lark或其他拼写。网关重启后飞书掉线如果你把网关安装成了系统服务重启后飞书长连接应该会自动恢复。如果没有恢复检查服务状态或者手动执行openclaw gateway restart。另外确认openclaw.json里的飞书配置没有被重置。排查时建议按顺序来先确认网关运行状态再确认模型侧连通性最后确认飞书渠道配置。每一步都有对应的命令和日志可以看不要跳步。6. 接入文档与 API Keys完成端到端自检后的下一步走到这里你应该已经在飞书里和机器人正常对话了。回顾整条链路Windows 上安装 OpenClaw、onboard 里选 Custom Provider 填 TaoToken 的 Base URL 和 Key、配置飞书应用凭证、本地网关验证、飞书配对码绑定。每一步都跑通之后端到端自检就算完成了。如果你在配置过程中需要重新生成 Key 或查看可用模型列表可以到 TaoToken 控制台的 API Keys 页面操作。接入文档里有更详细的参数说明和示例请求遇到不确定的字段可以先查文档再改配置。对于长期在本地跑编码任务或 Agent 的场景可以考虑用 Coding Plan 来管理调用额度避免频繁创建和切换 Key。如果你只是想先验证模型对话是否正常可以直接在模型对话页面发几条消息测试确认 Base URL 和 Model ID 没问题之后再回到 OpenClaw 配置。最后提醒一点openclaw.json里保存了你的 API Key 和飞书 App Secret不要把这个文件提交到公开仓库。如果多人共用一台机器建议把配置文件权限设置为仅当前用户可读。飞书后台的 App Secret 如果泄露及时在开放平台重置。