OpenClaw 是一个强大的开源 AI Agent 框架，与飞书结合能显著提升办公自动化效率。本文基于实测环境，梳理在 Windows 系统上部署 OpenClaw 并对接飞书机器人的完整流程，包含关键配置细节与常见坑点排查。
隐私与安全建议
由于自动化工具涉及系统与数据访问权限，若本地存有敏感商业或个人信息，建议使用独立备用机或云端虚拟机（VPS）运行服务，既能隔离风险也能避免环境冲突。
环境准备
Node.js 版本管理
OpenClaw 依赖 Node.js 22.x 及以上版本。推荐使用 nvm 管理版本以避免冲突。
- 前往 nvm-windows GitHub 发布页下载
nvm-setup.exe安装包。 - 按向导完成安装。
- 以管理员身份打开 PowerShell，执行以下命令：
# 安装指定版本
nvm install 22
# 切换至该版本
nvm use 22.22.0
看到 Now using node v22.22.0 提示即表示成功。若下载受阻，可直接从 Node.js 官网获取安装包。
验证安装：
node --version
npm --version
安装 OpenClaw
一键部署脚本
在管理员 PowerShell 中执行官方安装脚本。如遇执行策略报错，先解除限制：
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
随后运行安装命令（优先使用官方源）：
iwr -UseBasicParsing https://openclaw.ai/install.ps1 | iex
安装过程会自动拉取核心文件及依赖，耗时约 5-10 分钟。
初始化配置
安装完成后若未自动进入配置流程，可手动执行：
openclaw onboard --flow quickstart
交互步骤说明：
- 风险提示：输入
Yes确认理解潜在风险。 - 初始化模式：直接回车选择
QuickStart。 - 模型提供商：建议选
Skip for now，后续单独配置。 - 通讯渠道：选
Skip for now，飞书稍后处理。 - 技能配置：选
No跳过，按需扩展。
注意：若执行
openclaw提示无法识别，请关闭当前窗口重新以管理员身份打开，环境变量刷新需要时间。
启动与验证
# 启动网关
openclaw gateway start
# 打开控制台
openclaw dashboard
浏览器将自动跳转至 http://127.0.0.1:18789/。发送测试消息收到回复即代表服务正常。
配置大模型 API
OpenClaw 的核心能力依赖大模型，需预先配置密钥。此处以阿里云百炼为例：
- 登录阿里云百炼控制台，创建 API-Key 并复制。
- 在 OpenClaw 中配置：
# 设置 API Key（替换实际值）
openclaw config set models.providers.bailian.apiKey "你的百炼 API-Key"
# 设置默认模型
openclaw config set agents.defaults.model.primary "bailian/qwen3-plus"
# 重启生效
openclaw gateway restart
接入飞书机器人
插件安装
openclaw plugins install @m1heng-clawd/feishu
此步骤可与后续飞书平台配置并行进行。
飞书开放平台配置
- 创建应用：登录飞书开放平台，创建企业自建应用，填写名称与描述。
- 添加能力：在应用详情页左侧导航栏添加'机器人'能力。
- 获取凭证：进入'凭证与基础信息'，记录 App ID 和 App Secret。
- 权限配置：在'权限管理'页面批量导入以下 JSON 权限：
{"scopes":{"tenant":["aily:file:read","aily:file:write","contact:user.employee_id:readonly","im:chat.access_event.bot_p2p_chat:read","im:chat.members:bot_access","im:message","im:message.group_at_msg:readonly","im:message.p2p_msg:readonly","im:message:readonly","im:message:send_as_bot","im:resource"],"user":["aily:file:read","aily:file:write","im:chat.access_event.bot_p2p_chat:read"]}}
- 事件订阅：
- 选择'使用长连接接收事件'并保存。
- 点击'添加事件'，搜索并勾选
im.message.receive_v1。 -
注意：若报错'未建立长连接'，请检查 OpenClaw 网关状态并等待 1-2 分钟重试。
凭证绑定
方式一：命令行配置
openclaw config set channels.feishu.appId "cli_xxxxx"
openclaw config set channels.feishu.appSecret "your_app_secret"
openclaw gateway restart
方式二：Web UI 配置
访问控制台 http://127.0.0.1:18789/，在通道设置中填入上述凭证。
发布与配对
- 在飞书开放平台提交应用版本审批。
- 在飞书客户端添加机器人，发送任意消息获取配对码。
- 在 OpenClaw 控制台或命令行执行配对：
openclaw pairing approve feishu 配对码
配对成功后，即可在群聊或私聊中与机器人交互。
常用排错命令
遇到异常时，优先使用以下命令自查：
| 命令 | 作用 |
|---|---|
openclaw gateway status | 查看网关运行状态 |
openclaw gateway restart | 重启网关（配置修改后必须执行） |
openclaw doctor | 诊断环境并提供修复建议 |
openclaw logs follow | 实时日志监控，定位 Bug 首选 |
openclaw config | 交互式修改配置 |
openclaw --version | 验证安装版本 |
常见问题
插件安装失败？
先重启网关 openclaw gateway restart，再查看日志 openclaw logs follow 定位原因。
飞书显示未建立长连接？
通常因网关未启动或端口被防火墙拦截。确认 openclaw gateway status 为运行中，并检查 18789 端口。
收不到消息？
检查三点：是否添加了 im.message.receive_v1 事件、应用版本是否发布、是否完成配对。
Node.js 版本不兼容？
确保版本为 22+，执行 node --version 核对，低版本可通过 nvm 切换。
进阶技巧：发送图片
OpenClaw 默认工具在飞书发送本地图片时可能仅返回路径。可通过 TOOLS.md 机制扩展能力：在工作区 TOOLS.md 文件中加入自然语言指令，指导 AI 调用 curl 分步获取 token、上传图片并发送。每次启动时 AI 会读取该文件更新技能集。