Windows 本地部署 OpenClaw：打通飞书与企业微信实现 AI 助理

3.2 需要安装的软件

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

3.3 需要准备的账号

四、Step 1：安装 OpenClaw

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 安装 OpenClaw（二选一）

方式 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 ID和App Secret（非常重要！）

5.2 配置应用权限

进入「权限管理」，开启以下权限：

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

5.3 在 OpenClaw 中配置飞书 Skill

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」即可。

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. 保存后，飞书会把用户发的消息转发给你的 OpenClaw

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

5.6 测试飞书连通性

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

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

6.1 方案对比

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

6.2 创建企业微信自建应用

1. 登录 企业微信管理后台
2. 进入「应用管理」→「自建」→「创建应用」
3. 填写应用信息，上传头像
4. 创建成功后，记录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"
      }
    }
  }
}

重启 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 * * *",
      "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 协议官方文档