一、 基础安装步骤
在开始之前，请务必熟读 官方文档。
-
核心环境：
Node.js >= 22 -
一键安装（推荐）： 以管理员身份打开 PowerShell，执行以下命令：
PowerShelliwr -useb https://openclaw.ai/install.ps1 | iex -
初始化验证： 执行以下命令检查环境依赖是否完整：
PowerShellopenclaw doctor
二、 系统启动与核心配置
1. 手动启动网关
由于 Windows 计划任务 (schtasks) 在某些环境下可能创建失败，建议采用手动启动方式：
-
启动命令： 在 PowerShell 中执行
openclaw gateway。 -
【重要】： 必须保持该 PowerShell 窗口开启。若窗口关闭，本地 Web 仪表盘及飞书机器人将同步失效。
2. AI 模型 (Provider) 配置
可通过本地仪表盘 http://127.0.0.1:18789 或命令行进行配置。
-
核心参数：
-
API Key: 填入申请的模型密钥。
-
Model ID: 例如
gemini-2.0-flash。
-
-
快速配置命令：
PowerShellopenclaw configure --section model执行后按提示完成设置即可。
三、 飞书集成与授权（免 Webhook 模式）
1. 飞书开放平台配置
-
启用机器人： 在应用后台开启机器人功能。
-
权限开通： 必须勾选对应权限。
-
版本发布【关键】： 权限修改后，必须进入“版本管理与发布”创建并启用新版本，否则权限无法生效。
-
![image]()
2. 配置 AppId & AppSecret
在 OpenClaw 配置界面填入飞书应用的 App ID 和 App Secret。
3. 管理员配对 (Pairing)
由于使用 WebSocket 长连接，机器人会自动连接飞书服务器。首次发消息时，机器人会提示 access not configured 并给出配对码。
-
操作： 在 PowerShell 中根据提示输入以下命令完成授权：
PowerShellopenclaw pairing approve feishu <你的配对码>
四、 运行注意事项 ⚠️
1. 插件路径冲突
若日志出现 duplicate plugin id detected: plugin feishu 警告，是因为 C 盘用户目录与 D 盘程序目录同时存在飞书插件。
-
处理建议： 执行以下命令删除 C 盘残留，确保指向 D 盘最新源码：
PowerShellRemove-Item -Recurse -Force "$HOME\.openclaw\extensions\feishu"
2. 日志状态辨析
| 日志关键字 | 含义说明 |
| warn | 非致命警告（如表情处理缺失），通常不影响核心对话。 |
| dispatch complete | 代表消息处理成功并已回传回复。 |
| permission error | 说明飞书后台权限未正确开通或未发布新版本。 |
五、 成功标记
详细链接：https://mp.weixin.qq.com/s/8Fsm_QGRZeKu4VzWmqVjAA