介绍在 Windows 本地环境部署 OpenClaw AI 助手的完整流程。通过安装 Node.js 和 OpenClaw 框架，配置 API Key 实现本地 AI 服务。教程涵盖如何连接飞书和企业微信作为交互渠道，集成文件系统、应用控制、联网搜索等技能，使 AI 能操作电脑和处理任务。解决了端口占用、权限审批、API 密钥等常见问题，实现了零成本、隐私安全的个人 AI 助理搭建方案。
OpenClaw 支持三种部署模式，先看这张图快速理解区别：
| 部署方式 |
|---|
| 架构 |
|---|
| 优点 |
|---|
| 缺点 |
|---|
| 本地部署 | 全在本地电脑 | 无需服务器、免费、隐私安全 | 电脑关机 AI 就下线 |
| 云端部署 | 全在云服务器 | 7×24 小时在线、稳定 | 需要付费买服务器 |
| 混合部署 | 云端大脑 + 本地手脚 | 24 小时在线 + 能操作本地电脑 | 架构复杂、需要两台机器 |
本文选择第一种：纯本地部署。虽然电脑关机时 AI 会下线，但对个人使用来说，白天用电脑时 AI 在线完全够用，关键是零成本！
用户消息 -> 交互层 (微信/企业微信/飞书) -> OpenClaw Gateway (AI 大脑)
|
v
本地 Skill (手脚)
|
v
文件系统/桌面应用/联网搜索
这个架构清晰明了：
整个系统全部跑在你的 Windows 电脑上，数据不出门，完全可控。
| 项目 | 最低要求 | 推荐配置 |
|---|---|---|
| 操作系统 | Windows 10 64 位 | Windows 11 |
| CPU | 4 核 | 8 核 |
| 内存 | 8GB | 16GB |
| 硬盘 | 10GB 可用空间 | 20GB SSD |
| 网络 | 普通家庭宽带 | 长期开机（保持运行） |
| 软件 | 版本 | 下载地址 | 说明 |
|---|---|---|---|
| Node.js | 22.x LTS（必须） | nodejs.org | OpenClaw 的运行环境 |
| Git | 最新版 | git-scm.com | 可选，用于下载 Skill |
| 微信/企业微信 | 最新版 | 官网下载 | 用于消息接入 |
| 飞书 | 最新版 | 官网下载 | 用于消息接入 |
⚠️ 特别提醒：Node.js 必须安装22.x 或更高版本，低版本会报错。
| 账号 | 用途 | 获取方式 | 费用 |
|---|---|---|---|
| Anthropic API Key | 调用 Claude 模型 | console.anthropic.com | 付费（按量计费） |
| 或：DeepSeek API Key | 替代 Claude | platform.deepseek.com | 更便宜 |
| 或：智谱 API Key | 替代 Claude | open.bigmodel.cn | 有免费额度 |
| 飞书开发者账号 | 创建飞书应用 | open.feishu.cn | 免费 |
| 企业微信账号 | 创建企业微信应用 | work.weixin.qq.com | 免费 |
安装完成后，打开 PowerShell 验证：
node --version # 应该显示 v22.x.x
npm --version # 应该显示 10.x.x
方式 1：npm 全局安装（推荐）
npm install -g openclaw@latest
方式 2：pnpm 安装（更快）
npm install -g pnpm
pnpm add -g openclaw@latest
验证安装：
openclaw --version # 应该显示 2026.2.x 或更高
# 启动新手引导
openclaw onboard --install-daemon
跟着交互式向导完成：
C:\Users\你的用户名\.openclaw，不用改完成后，OpenClaw 的 Gateway 服务已经在后台运行了。
# 查看 Gateway 状态
openclaw gateway status # 应该显示：running
# 查看监听端口
netstat -an | findstr 18789 # 应该看到 LISTENING 状态
登录令牌在哪？
打开文件 C:\Users\你的用户名\.openclaw\openclaw.json，搜索 "token"，复制那一长串值，粘贴到登录页面即可进入 Web 聊天界面。
进入「权限管理」，开启以下权限：
| 权限代码 | 说明 |
|---|---|
docx:document | 查看、编辑和管理文档 |
docx:document:readonly | 查看文档（只读） |
drive:drive | 访问云空间文件 |
contact:user.base:readonly | 获取用户基本信息 |
开启后，点击「创建版本」→「提交审核」。审核通过后，点击「发布版本」。
OpenClaw 通过 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」即可。
编辑 ~/.openclaw/openclaw.json，在 skills 字段添加：
{
"skills": {
"feishu": {
"path": "C:/Users/你的用户名/.openclaw/workspace/skill-feishu",
"enabled": true
}
}
}
重启 Gateway：
openclaw gateway restart
在飞书应用后台，进入「事件订阅」：
http://你的局域网 IP:18789/api/feishu/webhook
ipconfig，找到 IPv4 地址（如 192.168.1.100）⚠️ 注意：如果 Windows 防火墙弹窗，记得允许访问。
在飞书里给机器人发一条消息，比如'你好'。如果配置正确，你应该能在 OpenClaw 的日志里看到消息记录。
| 渠道 | 难度 | 稳定性 | 说明 |
|---|---|---|---|
| 企业微信 | ⭐⭐ | 稳定 | 有官方 API，推荐 |
| 个人微信 | ⭐⭐⭐⭐⭐ | 不稳定 | 无官方 API，有封号风险 |
强烈推荐使用企业微信。个人微信只能用第三方库模拟操作，容易被封。
在应用详情页，点击「接收消息」→「设置 API 接收」：
http://你的局域网 IP:18789/api/wechat/webhookmywechattoken123使用 MCP（Model Context Protocol）可以快速接入企业微信：
# 全局安装
npm install -g wechat-enterprise-mcp
创建配置文件 ~/.claude/wechat-config.json：
{
"corpId": "你的企业 ID",
"agentId": "你的应用 AgentId",
"secret": "你的应用 Secret",
"token": "你设置的 Token",
"encodingAESKey": "你设置的 EncodingAESKey"
}
在 ~/.openclaw/openclaw.json 的 mcpServers 字段添加：
{
"mcpServers": {
"wechat": {
"command": "wechat-enterprise-mcp",
"args": [],
"env": {
"WECHAT_CONFIG": "C:/Users/你的用户名/.claude/wechat-config.json"
}
}
}
}
重启 Gateway：
openclaw gateway restart
在企业微信里给应用发一条消息。如果配置正确，AI 应该会回复你。
光能收发消息还不够，要让 AI 真正帮你干活，需要配置一些核心 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"
让 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"
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 注册即可。
让 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 * * *",
"skill": "filesystem",
"action": "read",
"params": {
"path": "C:/Users/你的用户名/Documents/日报模板.md"
}
}
}
}
编辑 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 使所有配置生效。
在飞书上说：'帮我打开记事本'
期望结果：你的 Windows 电脑上自动弹出记事本窗口。
'帮我看看桌面上那个 test.txt 文件写了什么'
AI 会读取文件内容并发回给你。
'帮我搜一下英伟达最新财报，总结给我'
AI 会调用 Tavily 搜索，整理结果后回复。
配置好 cron 后，每天早上 8 点 AI 会自动检查你指定的任务，把结果推送到飞书。
症状：安装时报错或运行时报'不支持'
解决方案：必须用 Node.js 22.x 或更高。去官网下载 LTS 版本重装。
症状：openclaw gateway start 报错'端口已被占用'
解决方案：找到占用进程并关闭，或修改配置文件换端口：
netstat -ano | findstr 18789
taskkill /PID 进程号 /F
症状：{"code":1770001,"msg":"invalid param"}
根本原因：飞书 API 限制，文档根节点只接受纯文本块，不接受标题、列表等格式化内容。
解决方案：使用优化版工具，或让 AI 先创建纯文本，再逐步添加格式。
症状：Windows 上加了白名单，服务器端还是报'approval required'
原因：Gateway 端也有安全策略，两边都得放行。
解决：在 openclaw.json 中设置 "security": "full"（仅限个人电脑，注意安全）。
症状：用 cmd 执行命令，返回的中文全是乱码
解决方案：用 PowerShell 代替 cmd，并设置编码：
[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
这不是坑，是本地部署的特点。想要 24 小时在线，需要：
重要提醒：Anthropic 已禁止 OpenClaw 使用 Claude 账号的 OAuth Token，必须直连 API（需要付费）。
替代方案：用 DeepSeek、智谱等国内 API，便宜且稳定。
当你把 AI 部署成本地服务，打通 IM 和本地操作之后，它就从一个'聊天机器人'真正进化成了24 小时在线的虚拟员工——能聊天、能干活、能搜东西、能操作电脑，随叫随到。
而这一切的成本，就是一台你本来就有的 Windows 电脑。
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online
基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online
查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具，Keycode 信息在线工具，online
JavaScript 字符串转义/反转义；Java 风格 \uXXXX（Native2Ascii）编码与解码。 在线工具，Escape 与 Native 编解码在线工具，online
使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具，JavaScript / HTML 格式化在线工具，online
Terser 压缩、变量名混淆，或 javascript-obfuscator 高强度混淆（体积会增大）。 在线工具，JavaScript 压缩与混淆在线工具，online