跳到主要内容
Windows 本地部署 OpenClaw:搭建 AI 助理并打通微信飞书 | 极客日志
JavaScript Node.js WeChat AI
Windows 本地部署 OpenClaw:搭建 AI 助理并打通微信飞书 介绍在 Windows 本地环境部署 OpenClaw AI 助手的完整流程。无需云服务器,仅需一台电脑即可运行。内容包括 Node.js 环境配置、API Key 申请、飞书与企业微信接入、Skill 功能扩展(文件操作、应用控制、联网搜索)以及常见问题排查。旨在帮助用户构建零成本、隐私安全的本地 AI 工作流。
无尘 发布于 2026/4/5 更新于 2026/5/21 19 浏览前言
之前写过一篇用云服务器部署 OpenClaw 的教程,不少读者反馈:'一定要买服务器吗?我只有一台 Windows 电脑行不行?'
答案是:当然可以!
OpenClaw 本来就是完全支持本地部署 的开源 AI 助手框架。你只需要一台 Windows 电脑,就能跑起一个完整的 AI 服务,而且可以通过微信、飞书 随时随地指挥它——查文件、开软件、管理电脑,甚至让它在你睡觉的时候帮你处理任务。
这篇文章将手把手教你在Windows 环境纯本地部署 OpenClaw ,并打通飞书和企业微信,全程不需要买云服务器 。
一、先搞懂:三种部署方式,你选哪个?
OpenClaw 支持三种部署模式,先看这张图快速理解区别:
部署方式 架构 优点 缺点 本地部署 全在本地电脑 无需服务器、免费、隐私安全 电脑关机 AI 就下线 云端部署 全在云服务器 7×24 小时在线、稳定 需要付费买服务器 混合部署 云端大脑 + 本地手脚 24 小时在线 + 能操作本地电脑 架构复杂、需要两台机器
本文选择第一种:纯本地部署 。虽然电脑关机时 AI 会下线,但对个人使用来说,白天用电脑时 AI 在线完全够用,关键是零成本 !
二、整体架构:你的 AI 助理如何工作?
你的 Windows 电脑
交互层
用户消息
用户消息
用户消息
调用
操作
操作
回复消息
回复消息
回复消息
微信/企业微信
飞书
Telegram
OpenClaw Gateway
(AI 大脑)
本地 Skill
(手脚)
文件系统
桌面应用
这个架构清晰明了:
Gateway :AI 的'大脑',运行在本地,负责理解消息、调用模型、路由指令
Skill :AI 的'手脚',封装具体能力(读文件、开软件、联网搜索等)
IM 渠道 :微信/飞书作为'耳朵和嘴巴',让你用手机和 AI 对话
整个系统全部跑在你的 Windows 电脑上,数据不出门,完全可控。
三、准备工作
3.1 硬件要求
项目 最低要求 推荐配置 操作系统 Windows 10 64 位 Windows 11 CPU 4 核 8 核 内存 8GB
3.2 需要安装的软件 软件 版本 下载地址 说明 Node.js 22.x LTS (必须)nodejs.org OpenClaw 的运行环境 Git 最新版 git-scm.com 可选,用于下载 Skill 微信/企业微信 最新版 官网下载 用于消息接入 飞书 最新版 官网下载 用于消息接入
⚠️ 特别提醒 :Node.js 必须安装22.x 或更高版本 ,低版本会报错。
3.3 需要准备的账号
四、Step 1:安装 OpenClaw
4.1 安装 Node.js
访问 nodejs.org ,下载22.x LTS 版本
双击安装,一路下一步,务必勾选'Add to PATH'
node --version
npm --version
4.2 安装 OpenClaw(二选一) npm install -g openclaw@latest
npm install -g pnpm && pnpm add -g openclaw@latest
4.3 初始化配置
openclaw onboard --install-daemon
选择模型 :选你准备好的 API(Anthropic/DeepSeek/智谱等)
输入 API Key :粘贴你的密钥
工作区路径 :默认 C:\Users\你的用户名\.openclaw,不用改
安装守护进程 :选 Yes,让 OpenClaw 开机自启
完成后,OpenClaw 的 Gateway 服务已经在后台运行了。
4.4 验证 Gateway 状态
openclaw gateway status
netstat -an | findstr 18789
登录令牌在哪?
打开文件 C:\Users\你的用户名\.openclaw\openclaw.json,搜索 "token",复制那一长串值,粘贴到登录页面即可进入 Web 聊天界面。
五、Step 2:打通飞书
5.1 创建飞书应用
访问 飞书开放平台 ,点击「创建企业自建应用」
应用名称:比如「我的 AI 助理」
创建成功后,记录App ID 和App Secret (非常重要!)
5.2 配置应用权限 权限代码 说明 docx:document查看、编辑和管理文档 docx:document:readonly查看文档(只读) drive:drive访问云空间文件 contact:user.base:readonly获取用户基本信息
开启后,点击「创建版本」→「提交审核」。审核通过后,点击「发布版本」。
5.3 在 OpenClaw 中配置飞书 Skill OpenClaw 通过 Skill 机制扩展功能。安装官方飞书 Skill:
cd ~/.openclaw/workspace
git clone https://github.com/openclaw/skill-feishu.git
cd skill-feishu
npm install
创建配置文件 ~/.claude/feishu-config.env:
FEISHU_APP_ID="你的 App_ID"
FEISHU_APP_SECRET="你的 App_Secret"
FEISHU_API_DOMAIN="https://open.feishu.cn"
FEISHU_AUTO_COLLABORATOR_ID="你的飞书 ID" # 可选,让 AI 创建的文档自动分享给你
⚠️ 如何获取飞书 ID :在飞书客户端,点击头像→「复制用户 ID」即可。
5.4 配置 Gateway 加载 Skill 编辑 ~/.openclaw/openclaw.json,在 skills 字段添加:
"skills" : { "feishu" : { "path" : "C:/Users/你的用户名/.openclaw/workspace/skill-feishu" , "enabled" : true } }
5.5 配置飞书事件回调(让飞书主动接收消息)
请求地址 :http://你的局域网 IP:18789/api/feishu/webhook
如何查 IP?PowerShell 执行 ipconfig,找到 IPv4 地址(如 192.168.1.100)
订阅事件 :添加「接收消息」
保存后,飞书会把用户发的消息转发给你的 OpenClaw
⚠️ 注意 :如果 Windows 防火墙弹窗,记得允许访问。
5.6 测试飞书连通性 在飞书里给机器人发一条消息,比如'你好'。如果配置正确,你应该能在 OpenClaw 的日志里看到消息记录。
六、Step 3:打通企业微信/微信
6.1 方案对比 渠道 难度 稳定性 说明 企业微信 ⭐⭐ 稳定 有官方 API,推荐 个人微信 ⭐⭐⭐⭐⭐ 不稳定 无官方 API,有封号风险
强烈推荐使用企业微信 。个人微信只能用第三方库模拟操作,容易被封。
6.2 创建企业微信自建应用
登录 企业微信管理后台
进入「应用管理」→「自建」→「创建应用」
填写应用信息,上传头像
创建成功后,记录AgentId 和Secret
6.3 配置接收消息 在应用详情页,点击「接收消息」→「设置 API 接收」:
URL :http://你的局域网 IP:18789/api/wechat/webhook
Token :自定义一串字符,比如 mywechattoken123
EncodingAESKey :随机生成
6.4 安装企业微信 MCP 工具 使用 MCP(Model Context Protocol)可以快速接入企业微信:
npm install -g wechat-enterprise-mcp
创建配置文件 ~/.claude/wechat-config.json:
{ "corpId" : "你的企业 ID" , "agentId" : "你的应用 AgentId" , "secret" : "你的应用 Secret" , "token" : "你设置的 Token" , "encodingAESKey" : "你设置的 EncodingAESKey" }
6.5 配置 Gateway 加载 MCP 工具 在 ~/.openclaw/openclaw.json 的 mcpServers 字段添加:
"mcpServers" : { "wechat" : { "command" : "wechat-enterprise-mcp" , "args" : [ ] , "env" : { "WECHAT_CONFIG" : "C:/Users/你的用户名/.claude/wechat-config.json" } } }
6.6 测试企业微信连通性 在企业微信里给应用发一条消息。如果配置正确,AI 应该会回复你。
七、高级配置:让 AI 真正能干活的 Skill 光能收发消息还不够,要让 AI 真正帮你干活,需要配置一些核心 Skill。
7.1 文件操作 Skill cd ~/.openclaw/workspace
git clone https://github.com/openclaw/skill-filesystem.git
cd skill-filesystem
npm install
openclaw approvals allowlist add "C:/Users/你的用户名/Documents"
openclaw approvals allowlist add "C:/Users/你的用户名/Desktop"
7.2 应用控制 Skill cd ~/.openclaw/workspace
git clone https://github.com/openclaw/skill-appcontrol.git
cd skill-appcontrol
npm install
openclaw approvals allowlist add "notepad.exe"
openclaw approvals allowlist add "calc.exe"
openclaw approvals allowlist add "explorer.exe"
openclaw approvals allowlist add "chrome.exe"
7.3 联网搜索 Skill(替代 Claude 的联网功能) Claude 本身不支持联网,可以用第三方 MCP 服务:
npm install -g @tavily/mcp
"mcpServers" : { "tavily" : { "command" : "npx" , "args" : [ "-y" , "@tavily/mcp" ] , "env" : { "TAVILY_API_KEY" : "你的 Tavily API Key" } } }
7.4 定时任务 Skill 让 AI 能定时执行任务,比如每天早上 8 点给你发日报:
cd ~/.openclaw/workspace
git clone https://github.com/openclaw/skill-cron.git
cd skill-cron
npm install
"cron" : { "daily_report" : { "schedule" : "0 8 * * *" ,
7.5 配置所有 Skill 生效 编辑 openclaw.json,把所有启用的 Skill 加进去:
"skills" : { "feishu" : { "path" : "C:/Users/你的用户名/.openclaw/workspace/skill-feishu" , "enabled" : true } , "filesystem" : { "path" : "C:/Users/你的用户名/.openclaw/workspace/skill-filesystem" , "enabled" : true } , "appcontrol" : { "path" : "C:/Users/你的用户名/.openclaw/workspace/skill-appcontrol" , "enabled" : true } , "cron" : { "path" : "C:/Users/你的用户名/.openclaw/workspace/skill-cron" , "enabled" : true } } , "mcpServers" : { "tavily" : { "command" : "npx" , "args" : [ "-y" , "@tavily/mcp" ] , "env" : { "TAVILY_API_KEY" : "你的 Tavily API Key" } } }
八、实战测试:让你的 AI 真正动起来
场景 1:手机指挥电脑干活 期望结果:你的 Windows 电脑上自动弹出记事本窗口。
场景 2:远程查文件 '帮我看看桌面上那个 test.txt 文件写了什么'
场景 3:自动搜索 AI 会调用 Tavily 搜索,整理结果后回复。
场景 4:定时任务 配置好 cron 后,每天早上 8 点 AI 会自动检查你指定的任务,把结果推送到飞书。
九、踩坑记录(血泪经验)
坑 1:Node.js 版本太低 解决方案 :必须用 Node.js 22.x 或更高 。去官网下载 LTS 版本重装。
坑 2:Gateway 启动失败,端口被占用 症状 :openclaw gateway start 报错'端口已被占用'
解决方案 :找到占用进程并关闭,或修改配置文件换端口:
netstat -ano | findstr 18789
taskkill /PID 进程号 /F
坑 3:飞书 API 返回 400 错误 症状 :{"code":1770001,"msg":"invalid param"}
根本原因 :飞书 API 限制,文档根节点只接受纯文本块,不接受标题、列表等格式化内容。
解决方案 :使用优化版工具,或让 AI 先创建纯文本,再逐步添加格式。
坑 4:权限审批卡死 症状 :Windows 上加了白名单,服务器端还是报'approval required'
原因 :Gateway 端也有安全策略,两边都得放行。
解决 :在 openclaw.json 中设置 "security": "full"(仅限个人电脑,注意安全)。
坑 5:中文乱码 解决方案 :用 PowerShell 代替 cmd,并设置编码:
[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
坑 6:电脑关机后 AI 没了 这不是坑,是本地部署的特点 。想要 24 小时在线,需要:
电脑不关机(睡眠模式也行)
或者用云服务器部署(见本文开头对比)
坑 7:Claude 账号 OAuth 不能用 重要提醒 :Anthropic 已禁止 OpenClaw 使用 Claude 账号的 OAuth Token,必须直连 API(需要付费)。
替代方案 :用 DeepSeek、智谱等国内 API,便宜且稳定。
十、总结:这套架构到底有多爽? 1. 远程查文件
出门在外,突然想看电脑上的某个文档,直接飞书问 AI:'帮我看看桌面上那个 txt 文件写了啥'。它直接把内容读出来发给我。不用远程桌面,不用 VPN,不用开电脑。
2. 自动运营监控
每天早上 8 点,AI 自动检查指定公司的最新财报,把汇总表推送到飞书群。我只需要看结果,不用手动搜。
3. 代码辅助
写代码时懒得切窗口,直接在飞书问 AI:'这段代码怎么优化',它分析完直接发回建议。
4. 文档自动化
跟 AI 说'把昨天写的周报整理成飞书文档',它自动读取文件、创建文档、填充内容,最后分享给我。
当你把 AI 部署成本地服务,打通 IM 和本地操作之后,它就从一个'聊天机器人'真正进化成了24 小时在线的虚拟员工 ——能聊天、能干活、能搜东西、能操作电脑,随叫随到。
而这一切的成本,就是一台你本来就有的 Windows 电脑。
十一、下一步可以做什么?
开发自己的 Skill :把重复工作封装成 AI 能调用的技能
接入更多数据源 :数据库、API、企业内部系统
配置更精细的权限 :实现多人协作,每人权限不同
尝试混合部署 :如果确实需要 24 小时在线,可以加一台便宜云服务器做大脑,本地电脑做手脚
OpenClaw 官方文档
飞书开放平台 API 文档
企业微信开发文档
MCP 协议官方文档
相关免费在线工具 RSA密钥对生成器 生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online
Mermaid 预览与可视化编辑 基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online
随机西班牙地址生成器 随机生成西班牙地址(支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选),支持数量快捷选择、显示全部与下载。 在线工具,随机西班牙地址生成器在线工具,online
Keycode 信息 查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具,Keycode 信息在线工具,online
Escape 与 Native 编解码 JavaScript 字符串转义/反转义;Java 风格 \uXXXX(Native2Ascii)编码与解码。 在线工具,Escape 与 Native 编解码在线工具,online
JavaScript / HTML 格式化 使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具,JavaScript / HTML 格式化在线工具,online