Windows纯本地部署OpenClaude:从零搭建你的7×24小时AI助理,打通微信/飞书

无需云服务器,一台Windows电脑就能让AI助手24小时在线,还能通过手机随时指挥它干活

前言

之前写过一篇用云服务器部署OpenClaude的教程,不少读者反馈:“一定要买服务器吗?我只有一台Windows电脑行不行?”

答案是:当然可以!

OpenClaude本来就是完全支持本地部署的开源AI助手框架。你只需要一台Windows电脑,就能跑起一个完整的AI服务,而且可以通过微信、飞书随时随地指挥它——查文件、开软件、管理电脑,甚至让它在你睡觉的时候帮你处理任务。

这篇文章将手把手教你在Windows环境纯本地部署OpenClaude,并打通飞书和企业微信,全程不需要买云服务器


一、先搞懂:三种部署方式,你选哪个?

OpenClaude支持三种部署模式,先看这张图快速理解区别:

部署方式架构优点缺点
本地部署全在本地电脑无需服务器、免费、隐私安全电脑关机AI就下线
云端部署全在云服务器7×24小时在线、稳定需要付费买服务器
混合部署云端大脑+本地手脚24小时在线+能操作本地电脑架构复杂、需要两台机器

本文选择第一种:纯本地部署。虽然电脑关机时AI会下线,但对个人使用来说,白天用电脑时AI在线完全够用,关键是零成本


二、整体架构:你的AI助理如何工作?

你的Windows电脑

交互层

用户消息

用户消息

用户消息

调用

操作

操作

回复消息

回复消息

回复消息

微信/企业微信

飞书

Telegram

OpenClaude Gateway
(AI大脑)

本地Skill
(手脚)

文件系统

桌面应用

这个架构清晰明了:

  • Gateway:AI的“大脑”,运行在本地,负责理解消息、调用模型、路由指令
  • Skill:AI的“手脚”,封装具体能力(读文件、开软件、联网搜索等)
  • IM渠道:微信/飞书作为“耳朵和嘴巴”,让你用手机和AI对话

整个系统全部跑在你的Windows电脑上,数据不出门,完全可控。


三、准备工作

3.1 硬件要求

项目最低要求推荐配置
操作系统Windows 10 64位Windows 11
CPU4核8核
内存8GB16GB
硬盘10GB可用空间20GB SSD
网络普通家庭宽带长期开机(保持运行)

3.2 需要安装的软件

软件版本下载地址说明
Node.js22.x LTS(必须)nodejs.orgOpenClaude的运行环境
Git最新版git-scm.com可选,用于下载Skill
微信/企业微信最新版官网下载用于消息接入
飞书最新版官网下载用于消息接入

⚠️ 特别提醒:Node.js必须安装22.x或更高版本,低版本会报错。

3.3 需要准备的账号

账号用途获取方式费用
Anthropic API Key调用Claude模型console.anthropic.com付费(按量计费)
或:DeepSeek API Key替代Claudeplatform.deepseek.com更便宜
或:智谱API Key替代Claudeopen.bigmodel.cn有免费额度
飞书开发者账号创建飞书应用open.feishu.cn免费
企业微信账号创建企业微信应用work.weixin.qq.com免费

四、Step 1:安装OpenClaude

4.1 安装Node.js

  1. 访问 nodejs.org,下载22.x LTS版本
  2. 双击安装,一路下一步,务必勾选“Add to PATH”

安装完成后,打开PowerShell验证:

node --version # 应该显示 v22.x.x npm --version # 应该显示 10.x.x

4.2 安装OpenClaude(二选一)

方式1:npm全局安装(推荐)

npm install -g openclaw@latest 

方式2:pnpm安装(更快)

npm install -g pnpm pnpm add -g openclaw@latest 

验证安装:

openclaw --version # 应该显示 2026.2.x 或更高

4.3 初始化配置

# 启动新手引导 openclaw onboard --install-daemon

跟着交互式向导完成:

  1. 选择模型:选你准备好的API(Anthropic/DeepSeek/智谱等)
  2. 输入API Key:粘贴你的密钥
  3. 工作区路径:默认C:\Users\你的用户名\.openclaw,不用改
  4. 安装守护进程:选Yes,让OpenClaw开机自启

完成后,OpenClaw的Gateway服务已经在后台运行了。

4.4 验证Gateway状态

# 查看Gateway状态 openclaw gateway status # 应该显示:running# 查看监听端口 netstat -an | findstr 18789 # 应该看到 LISTENING 状态

浏览器访问 http://127.0.0.1:18789/,应该能看到登录页面。

登录令牌在哪?
打开文件 C:\Users\你的用户名\.openclaw\openclaw.json,搜索 "token",复制那一长串值,粘贴到登录页面即可进入Web聊天界面。


五、Step 2:打通飞书

5.1 创建飞书应用

  1. 访问 飞书开放平台,点击「创建企业自建应用」
  2. 应用名称:比如「我的AI助理」
  3. 创建成功后,记录App IDApp Secret(非常重要!)

5.2 配置应用权限

进入「权限管理」,开启以下权限:

权限代码说明
docx:document查看、编辑和管理文档
docx:document:readonly查看文档(只读)
drive:drive访问云空间文件
contact:user.base:readonly获取用户基本信息

开启后,点击「创建版本」→「提交审核」。审核通过后,点击「发布版本」。

5.3 在OpenClaude中配置飞书Skill

OpenClaude通过Skill机制扩展功能。安装官方飞书Skill:

# 进入工作区 cd ~/.openclaw/workspace # 克隆飞书Skill仓库 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}}

重启Gateway:

openclaw gateway restart 

5.5 配置飞书事件回调(让飞书主动接收消息)

在飞书应用后台,进入「事件订阅」:

  1. 请求地址http://你的局域网IP:18789/api/feishu/webhook
    • 如何查IP?PowerShell执行 ipconfig,找到IPv4地址(如192.168.1.100)
  2. 订阅事件:添加「接收消息」
  3. 保存后,飞书会把用户发的消息转发给你的OpenClaude

⚠️ 注意:如果Windows防火墙弹窗,记得允许访问。

5.6 测试飞书连通性

在飞书里给机器人发一条消息,比如“你好”。如果配置正确,你应该能在OpenClaude的日志里看到消息记录。


六、Step 3:打通企业微信/微信

6.1 方案对比

渠道难度稳定性说明
企业微信⭐⭐稳定有官方API,推荐
个人微信⭐⭐⭐⭐⭐不稳定无官方API,有封号风险

强烈推荐使用企业微信。个人微信只能用第三方库模拟操作,容易被封。

6.2 创建企业微信自建应用

  1. 登录 企业微信管理后台
  2. 进入「应用管理」→「自建」→「创建应用」
  3. 填写应用信息,上传头像
  4. 创建成功后,记录AgentIdSecret

6.3 配置接收消息

在应用详情页,点击「接收消息」→「设置API接收」:

  • URLhttp://你的局域网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.jsonmcpServers 字段添加:

"mcpServers":{"wechat":{"command":"wechat-enterprise-mcp","args":[],"env":{"WECHAT_CONFIG":"C:/Users/你的用户名/.claude/wechat-config.json"}}}

重启Gateway:

openclaw gateway restart 

6.6 测试企业微信连通性

在企业微信里给应用发一条消息。如果配置正确,AI应该会回复你。


七、高级配置:让AI真正能干活的Skill

光能收发消息还不够,要让AI真正帮你干活,需要配置一些核心Skill。

7.1 文件操作Skill

让AI能读写你的文件:

cd ~/.openclaw/workspace git clone https://github.com/openclaw/skill-filesystem.git cd skill-filesystem npm install 

配置权限(非常重要!):

# 允许AI访问特定目录 openclaw approvals allowlist add "C:/Users/你的用户名/Documents" openclaw approvals allowlist add "C:/Users/你的用户名/Desktop"

7.2 应用控制Skill

让AI能打开关闭程序:

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服务:

# 安装Tavily MCP(免费版无需绑卡) npm install -g @tavily/mcp 

配置到Gateway:

"mcpServers":{"tavily":{"command":"npx","args":["-y","@tavily/mcp"],"env":{"TAVILY_API_KEY":"你的Tavily API Key"}}}

获取免费API Key:访问 app.tavily.com 注册即可。

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 * * *",// 每天早上8点"skill":"filesystem","action":"read","params":{"path":"C:/Users/你的用户名/Documents/日报模板.md"}}}

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"}}}

重启Gateway使所有配置生效。


八、实战测试:让你的AI真正动起来

场景1:手机指挥电脑干活

在飞书上说:“帮我打开记事本”

期望结果:你的Windows电脑上自动弹出记事本窗口。

场景2:远程查文件

“帮我看看桌面上那个test.txt文件写了什么”

AI会读取文件内容并发回给你。

场景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:中文乱码

症状:用cmd执行命令,返回的中文全是乱码

解决方案:用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电脑。


十一、下一步可以做什么?

  1. 开发自己的Skill:把重复工作封装成AI能调用的技能
  2. 接入更多数据源:数据库、API、企业内部系统
  3. 配置更精细的权限:实现多人协作,每人权限不同
  4. 尝试混合部署:如果确实需要24小时在线,可以加一台便宜云服务器做大脑,本地电脑做手脚

参考资料

  1. OpenClaw官方文档
  2. 飞书开放平台API文档
  3. 企业微信开发文档
  4. MCP协议官方文档

本文为原创内容,发布于ZEEKLOG。欢迎转发,转载请保留出处。

Read more

FileVibe全攻略(四):前端模块化与事件通信实战

FileVibe全攻略(四):前端模块化与事件通信实战

各位开发者,今天我们来聊聊FileVibe前端架构中最巧妙的设计——用CustomEvent实现跨模块通信。当你打开一张图片,AI聊天模块自动知道该分析这张图;当你在文件列表点击,预览模块自动响应——这些看似“魔法”的联动,背后就是事件通信在起作用。 下图是FileVibe的界面布局,左侧文件列表、中间预览区、右侧聊天区,三个模块各自独立却又默契配合: 这三个区域分别由三个独立的模块管理: * 左侧:list.js - 只负责显示文件和文件夹 * 中间:preview.js - 只负责预览文件内容 * 右侧:chat.js - 只负责AI对话和图片解读 它们各司其职,但需要协同工作——比如点击左侧的图片,中间要显示,右侧要准备分析。怎么让它们配合得既紧密又松耦合?这就是今天要讲的事件通信。 获取源代码:Gitee FileVibe(已获得Gitee推荐) 一、先想清楚:我们面临的需求是什么? 在开始写代码之前,我们先停下来想一想:我们到底要解决什么问题? 1.

前端vue3解析上传的视频编码格式,同时判断是否可以在当前浏览器播放

前端vue3解析上传的视频编码格式,同时判断是否可以在当前浏览器播放

技术栈:vue3、JavaScript、vite 依赖库:mediainfo.js: "^0.2.2"、 file-type: "^21.1.1"; 前言         这段时间有接触一个在线聊天的前端项目,其中可以发送图片视频之类的。随后,便发现了一些问题:其中与本文章有关的,就是上传的视频,在当前浏览器有可能无法播放(直接无法播放、或者点击播放,有声音,但无画面)。         经过排查,最后发现,是视频编码问题,部分浏览器不支持H265编码(HEVC)格式的视频播放,导致原生video组件播放异常。         怎么处理呢?一开始想让后台帮忙处理,检测视频格式,并将其转换为H264的编码格式(AVC)。嗯,虽然从结果来说,完全可行,但对服务器资源的消耗还是挺大的,因此不太建议这么做。         那么直接让前端来处理呢?有没有什么豪的方法?有的,

别再用 Electron 了!教你用 WebView2 实现 3MB 极致轻量化 Web 打包方案(附神器)

别再用 Electron 了!教你用 WebView2 实现 3MB 极致轻量化 Web 打包方案(附神器)

文章摘要:         你还在忍受 Electron 打包后动辄 100MB+ 的体积吗?你还在为本地 HTML 跨域(CORS)、源码保护、机器码授权而头秃吗?本文将带你体验微软新一代 WebView2 技术,并分享一款支持实时预览、全全局拖拽交互的打包神器。3MB 体积,1.5GB 大文件秒开,彻底解放前端生产力! 😱 为什么 2026 年了,我们还要逃离 Electron? 做前端桌面化开发,Electron 确实是老大哥,但它的缺点和优点一样明显: * 太胖了: 一个最简单的 Hello World,打包出来都要 150MB 起步。 * 太吃内存: 每个窗口都是一个 Chrome 进程,老爷机直接卡死。 * 开发繁琐: 想要实现“老板键”、“机器码授权”、“关机重启”,需要写大量的