如果你最近在关注本地 AI 助手、Agent、自动化助手这一类项目，那大概率已经刷到过 OpenClaw。OpenClaw 官方把它定义为一款“运行在你自己设备上的个人 AI 助手”，它可以接入你已经在用的聊天平台，比如 Telegram、Slack、Discord、Signal、Google Chat、Feishu 等，并通过 Gateway 统一调度消息、模型、技能和工具能力。官方还强调，真正的产品不是单纯的网关，而是“你的个人 AI 助手”本身。
一、OpenClaw 为什么会这么火？
OpenClaw 之所以突然热起来，不是因为名字有梗，而是因为它刚好踩中了几个技术热点：
第一，它把“大模型 + 多渠道消息 + 本地执行能力”这三件事串起来了。
第二，它不是纯云端 SaaS，而是强调你自己部署、自己掌控。
第三，它支持的聊天渠道非常多，飞书也已经在官方文档中作为支持渠道列出。
更关键的是，官方现在已经把安装路径做得更标准化了：推荐用安装脚本或 openclaw onboard 启动向导来做初始化，Feishu 也有单独的渠道文档，最近版本更新里还专门修了 Feishu 插件接入和发现缓存相关的问题，说明这个生态确实在持续迭代。
| 维度 | OpenClaw 的能力 | 能解决什么问题 |
|---|---|---|
| 本地化部署 | 支持在自己的设备上运行个人 AI 助手 | 降低对第三方平台的依赖，数据和运行环境更可控 |
| 多渠道接入 | 可连接 Telegram、Slack、Discord、Feishu 等聊天平台 | 不用每次都开网页，可以直接在常用 IM 工具里跟 AI 协作 |
| Gateway 统一管理 | 通过网关管理消息、配置、路由和扩展能力 | 让多模型、多渠道、多 Agent 统一运转 |
| Dashboard 控制台 | 可直接在浏览器打开控制界面进行测试和管理 | 适合部署后本地验证、排障和日常管理 |
| 向导式安装 | 官方推荐 openclaw onboard 进行初始化 | 新手不必全靠手改配置，部署门槛明显下降 |
| Feishu WebSocket 接入 | 飞书支持通过 WebSocket 长连接收消息，无需公网 webhook | 公司内网、个人电脑、本地测试场景更友好 |
| macOS 原生增强 | 官方有 macOS Companion，能接入更多 macOS 能力 | 对 Mac 用户来说，和系统能力结合更深 |
| 插件/技能扩展 | 支持插件安装、技能扩展、插件诊断 | 后续可以持续加能力，不只是一个静态机器人 |
二、部署前先搞明白：Windows 和 Mac 的推荐思路
在开始这篇 openclaw部署教程 之前，你要先记住一个核心结论：
Windows 推荐 WSL2 方案，Mac 可以直接本机安装。
这是官方安装文档明确写出来的。OpenClaw 虽然支持 Windows，但官方在安装页中强调：在 Windows 上，强烈建议运行在 WSL2 之下。原因很简单，很多 AI Agent 和 Node 工具链在 Linux/Unix 环境下更稳定，路径、服务管理、依赖安装也更顺手。
而 Mac 则天然适合本机部署。官方不仅支持常规 CLI 安装，还有专门的 macOS Companion 应用，用于管理权限、连接本地或远程 Gateway，并暴露更多 Mac 系统能力。
部署前准备项
无论你走 Windows 还是 Mac，建议先准备下面这些东西：
- 一台能联网的电脑
- Node.js 22 或更高版本
- 能正常执行终端命令
- 一个可用的大模型配置环境
- 如果要接飞书，准备好飞书开放平台账号和企业应用创建权限
三、Windows 版 openclaw部署教程：安装与启动
这一部分是很多人最关心的。因为搜 openclaw部署教程 的用户里，Windows 用户通常最多。
方案选择
从技术实践角度，我建议这样理解：
- 最稳方案：Windows + WSL2
- 可用方案：Windows PowerShell 直接安装
- 对新手更友好：先装 CLI，再跑
openclaw onboard --install-daemon
官方给出的快速安装方式包括 PowerShell 安装脚本，同时安装文档也明确建议 Windows 使用 WSL2。
第1步：确认 Node 版本
node --version如果版本低于 22，先升级。官方系统要求就是 Node 22+。
第2步：安装 OpenClaw
执行npm 安装命令。
npm install -g openclaw@latest第3步：运行初始化向导
openclaw onboard --install-daemon第4步：检查 Gateway 状态
openclaw gateway status第5步：打开控制台
openclaw dashboard如果 Gateway 正常工作，可以在本机浏览器打开控制 UI，默认也可以访问 http://127.0.0.1:18789/ 进行验证。
四、Windows 版飞书整合
既然这篇是完整的 openclaw部署教程，飞书接入就不能只说一句“支持飞书”。
OpenClaw 官方 Feishu 文档已经明确：Feishu 渠道通过 WebSocket 长连接接入，可以在不暴露公网 Webhook 的情况下接收消息。对很多本地部署、公司内网测试场景来说，这一点非常实用。
接飞书的流程如下：
- 安装 OpenClaw
- 执行
openclaw channels add - 选择 Feishu
- 填入 App ID / App Secret
- 在飞书开放平台启用 Bot 能力
- 事件订阅选择 WebSocket
- 添加
im.message.receive_v1事件 - 发布应用
- 用
openclaw logs --follow查看日志 - 首次私聊后完成 pairing 审批