1. 为什么要在 Windows 上折腾 OpenClaw 本地部署
OpenClaw 是一个跑在你自己电脑上的开源 AI 智能体，它能读写本地文件、操作浏览器、调用系统命令，还能通过飞书这类聊天工具接收指令。换句话说，你在外面用手机发一条消息，家里那台 Windows 电脑就开始干活，干完还把结果发回给你。这套「手机远程控制电脑」的玩法，核心检索词就是 Windows 本地部署 OpenClaw 加飞书接入。
适合谁？三类人最值得试：一是经常要处理报表、整理文件的办公族，二是需要批量检索文献的学生和研究者，三是想研究 AI Agent 落地形态的技术爱好者。它不需要你买服务器，一台常年开机的 Windows 机器就够。
但 Windows 上的部署有几个坑特别集中：PowerShell 默认拦截脚本、Node.js 版本不对导致依赖装不上、模型 API 地址配错导致消息一直转圈、飞书事件订阅没走长连接导致收不到消息。这篇就把这些坑一个个填平，从环境准备到飞书打通，再到 10 个能直接复制的案例，全部给到可执行的命令和配置。
我试过在一台 Win11 的旧笔记本上从零跑通整套流程，中间卡在 MiniMax 的 baseUrl 上折腾了半小时，所以第五节会重点讲这个。你跟着做，大概 40 分钟能跑起来。
2. 前置环境：Node.js、Git 与 PowerShell 权限配置
这一节是地基，跳过后面的安装脚本大概率报错。三个东西必须到位：Node.js、Git、PowerShell 执行权限。
先说 Node.js。OpenClaw 是 Node 写的，没有运行时寸步难行。去 Node.js 官网下载 LTS 长期支持版的 Windows 安装包，双击一路 Next。装完打开命令行验证：
node -v npm -v两条命令都能吐出 版本号 就对了。如果提示「不是内部或外部命令」，说明环境变量没生效，重启一下终端或者注销重登。
接着装 Git。OpenClaw 的部分插件和技能依赖 Git 拉取仓库，不装会在安装阶段报错。去 Git 官网下载 Windows 版，安装时保持默认选项即可，尤其是「Adjusting your PATH environment」那一步别乱改。装完验证：
git --version然后是 PowerShell 权限，这是 Windows 上最容易翻车的地方。系统默认禁止运行脚本，而 OpenClaw 的安装脚本正是 .ps1 文件。以管理员身份打开 PowerShell（右键开始菜单选「Windows PowerShell 管理员」），先看当前策略：
Get-ExecutionPolicy -List如果 CurrentUser 那一行显示 Restricted，就得放开。执行：
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUserRemoteSigned 的含义是：本地写的脚本随便跑，从网上下载的脚本需要数字签名。这比 Unrestricted 安全，日常开发够用。改完再查一次，确认变成 RemoteSigned。
最后准备模型 API Key。国产模型里 MiniMax 的接入体验比较顺，去 MiniMax 开放平台注册后，在「用户中心 → 接口密钥」创建一个 Key 复制备用。智谱 GLM、阿里云千问的配置逻辑类似，换个 baseUrl 和 Key 就行。这里先记着，第 4 节初始化时会用到。
注意：API Key 属于敏感凭证，别截图发群里，也别提交到 Git 仓库。后面配置飞书时同理。
3. 安装 OpenClaw 与初始化配置的可复制片段
环境齐了，开始装主体。打开 PowerShell，粘贴官方一键安装脚本：
iwr -useb https://openclaw.ai/install.ps1 | iex这个脚本会自动检测 Node.js、拉取依赖、把 openclaw 命令注册到全局。装完验证：
openclaw --version能输出版本号就说明装好了。接下来跑初始化向导：
openclaw onboard向导会依次问你几个问题。第一步是安全确认，方向键选 Yes 回车。第二步选安装方式，选 QuickStart。第三步选模型提供商，这里选 MiniMax，然后粘贴你准备好的 API Key。第四步配置 Channel，先选 Skip for now，飞书我们后面单独配。第五步 Skills 也先跳过。第六步 Hooks 直接按空格全选再回车。
初始化完成后，OpenClaw 会把配置写到用户目录下的配置文件里。Windows 上路径通常是：
C:\Users\你的用户名\.openclaw\config.json这个文件很关键，后面改模型地址、加飞书凭证都靠它。你可以直接用编辑器打开看，也可以用命令行改。配置文件的结构大致长这样：
{ "models": { "providers": { "minimax": { "apiKey": "你的API Key", "baseUrl": "https://api.minimaxi.com/anthropic", "model": "MiniMax-Text-01" } } }, "channels": { "feishu": { "enabled": false, "connectionMode": "websocket", "appId": "", "appSecret": "" } } }启动主程序：
openclaw gateway看到提示本地地址 http://localhost:18789 就说明 Gateway 起来了。这个窗口别关，它是常驻服务。另开一个 PowerShell 窗口，启动控制台：
openclaw dashboard --no-open浏览器访问 http://localhost:18789，页面显示 health ok 就代表连接正常。
如果你用的是其他模型，把 providers 下的键名和 baseUrl 换掉即可。比如智谱的配置片段：
{ "models": { "providers": { "zhipu": { "apiKey": "你的智谱Key", "baseUrl": "https://open.bigmodel.cn/api/paas/v4", "model": "glm-4-plus" } } } }改完配置记得重启 Gateway 才生效：
openclaw gateway stop openclaw gateway4. 验证请求：从 Dashboard 到飞书手机端打通
配置写完不代表能用，得一步步验证。先在 Dashboard 里测模型通不通。打开 http://localhost:18789，找到对话输入框，发一句「你好，介绍一下你自己」。如果几秒内返回文字，说明模型链路没问题。如果一直转圈或者报错，先别急着怀疑网络，八成是 baseUrl 配错了，第 5 节专门讲这个。
模型通了之后，接飞书。飞书是国内用 OpenClaw 最顺的聊天通道，手机装个飞书 App 就能远程下指令。
第一步，去飞书开放平台创建企业自建应用，填个名字比如 OpenClaw Bot。创建完进「添加应用能力」，把「机器人」加上。
第二步，配权限。左侧「权限管理 → 添加权限」，把消息相关的都勾上，重点是这几个：im:message、im:message:send_as_bot、im:message.p2p_msg:readonly、im:message.group_at_msg:readonly、im:resource。权限少了机器人会收不到消息或者发不出回复。
第三步，拿凭证。左侧「凭证与基础信息」里复制 App ID 和 App Secret。
第四步，第一次发布。左侧「版本管理与发布」，填个版本号 1.0.0，创建版本并提交发布。这一步不能省，没发布的应用事件订阅不生效。
回到 PowerShell，装飞书插件并写配置：
openclaw plugins install @m1heng-clawd/feishu openclaw config set channels.feishu.connectionMode websocket openclaw config set channels.feishu.appId "你的App ID" openclaw config set channels.feishu.appSecret "你的App Secret" openclaw config set channels.feishu.enabled true改完重启：
openclaw gateway stop openclaw gateway第五步，回飞书配事件订阅。左侧「事件与回调」，订阅方式选「使用长连接接收事件」，然后添加事件「接收消息 v2.0」。长连接模式不需要你暴露公网地址，对家用 Windows 机器特别友好。
第六步，第二次发布。再创建一个版本比如 1.0.1，提交发布。两次发布都完成，飞书侧才算配好。
最后测试。手机打开飞书，搜索你创建的应用名，点进去发「你好」。如果收到回复，整条链路就通了。这时候你在外面发消息，家里电脑就会执行并把结果发回来。
5. 常见报错排查：401、转圈、收不到消息怎么解
部署过程里报错集中在几个地方，逐个拆。
报错一：401 Unauthorized 或 invalid api key。这是模型 Key 的问题。先确认 Key 有没有复制全，前后有没有多余空格。然后确认 baseUrl 和 Key 是不是同一家的——拿 MiniMax 的 Key 去请求智谱的地址，必然 401。检查配置文件里的 providers 段，apiKey 和 baseUrl 必须配套。
报错二：消息发出去一直转圈，没有回复。这个在 MiniMax 上特别常见，原因是国内版和海外版的 API 地址不同。国内版要改成：
openclaw config set models.providers.minimax.baseUrl "https://api.minimaxi.com/anthropic"海外版则是：
openclaw config set models.providers.minimax.baseUrl "https://api.minimaxi.io/anthropic"改完必须重启 Gateway。很多人改完不重启，以为没生效，其实是服务还在用旧配置。
报错三：local proxy failed 或连接超时。先看 Gateway 窗口有没有报错日志。如果是端口占用，换个端口启动：
openclaw gateway --port 18790如果是模型请求超时，检查 baseUrl 能不能在浏览器里访问通。
报错四：飞书收不到消息。按顺序排查：应用发布了没（要发布两次）、权限勾全了没、事件订阅是不是选了长连接、Gateway 重启了没。四个都确认还不行，去飞书开放平台的「事件与回调」看有没有报错日志，通常会告诉你具体缺什么。
报错五：reading choices 相关错误。这是模型返回格式和 OpenClaw 预期不匹配，多半是 baseUrl 指向了非 Anthropic 兼容的端点。确认你用的地址带 /anthropic 后缀，或者换成官方文档里标注兼容的地址。
报错六：OAuth 相关报错。如果你接的是需要 OAuth 的通道，检查 token 有没有过期。重新跑一次openclaw channels login走授权流程。
排查时有个通用技巧：Gateway 窗口的日志是第一手信息，报错原文直接搜，比瞎猜快得多。
6. 10 个可复现案例与长期使用建议
配置通了，接下来是让它真正干活。以下案例直接在飞书里发消息就能触发，手机电脑都行。
案例一，自动生成数据报表。发「读取桌面上的财务数据.csv，分析后生成图表和文字报告，保存为 Word 发给我」。适合财务和运营。
案例二，网页信息采集。发「打开招聘网站搜索 AI 产品经理，整理前 20 个结果的公司、薪资、要求，存成 Excel 发我」。
案例三，论文文献检索。发「去 arXiv 下载最近一个月关于 AI Agent 的论文，打包到桌面，写个中文综述 Word 发我」。
案例四，Word 智能排版。发「把刚才的综述排版：标题三号黑体居中，正文小四宋体，行距 23 磅，首行缩进两字符」。
案例五，GitHub 热点追踪。发「查一下 GitHub 今日前十热门 AI 项目，做个 Word 简报发我」。
案例六，智能文件整理。发「帮我整理桌面文件，按类型分类」。
案例七，定时提醒。发「提醒我明天下午 3 点开会，提前 30 分钟再提醒一次」。
案例八，自动写日报。发「根据我今天在电脑上的操作记录，写一份 Word 工作日报发我」。
案例九，竞品监控。发「监控社交平台上关于某产品的讨论，有负面评价立即通知我」。
案例十，批量图片处理。发「把桌面图片文件夹里的图全部压缩到 500KB 以内，重命名后打包发我」。
这些案例能跑起来的前提是模型稳定。如果你打算长期挂着跑定时任务和 Agent 流程，建议用 Coding Plan 这类面向长期编码和 Agent 场景的方案，比按次调用更划算，接入方式在 https://taotoken.net/api 的文档里有说明。模型对话调试可以去 https://taotoken.net/api 对应的对话入口试，API Key 在控制台生成。
日常使用有几个小建议：Gateway 窗口别关，可以设成开机自启；配置文件改完一定重启；飞书权限宁多勿少；定时任务先用短周期测通再拉长。跑顺之后，这台 Windows 机器就真成了你的远程打工人。