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 机器就真成了你的远程打工人。