OpenClaw 本地部署及飞书集成配置教程

暂时选择 No，后续可通过 Web UI 界面灵活配置。

7. Hooks 设置

根据需求开启 Hooks，通常保持默认或按需勾选。

8. 启动服务

配置完成后，服务会自动启动。等待约 30 秒后，在向导中选择 Open the Web UI 打开管理界面。

浏览器将自动跳转至控制面板，格式通常为 http://127.0.0.1:18789。

接入飞书机器人

若需使用飞书指挥 OpenClaw，需先在飞书开放平台创建应用。

1. 创建应用

访问飞书开放平台 https://open.feishu.cn，点击右上角进入开发者后台，创建新应用。

2. 填写信息

按指引填写应用名称、描述等信息，获取 AppID 和 AppSecret。

3. 添加机器人

在应用开发页面添加机器人组件，并配置所需权限（如消息接收、通讯录读取等）。

4. 发布审批

提交版本并发布，等待企业审批通过。

5. 安装飞书插件

回到 PowerShell，安装飞书插件：

openclaw plugins install @m1heng-clawd/feishu

6. 配置插件

新建命令窗口，输入 openclaw config，按向导选择渠道为飞书，填入 AppID 和 AppSecret，域名选择中国区。

7. 设置事件回调

返回飞书开发者后台，找到应用详情，配置事件订阅。

• 选择 使用长连接接收事件
• 添加 消息接收 事件
• 重新发布版本

8. 重启服务

配置完成后重启 OpenClaw 服务，即可在飞书中与 AI 助手对话。

常用命令速查

常见问题解答

Q1: 安装飞书插件提示 spawn npm ENOENT

原因：Windows 下 npm 调用可能存在兼容性问题。

解决：修改源码中的 exec.js 文件。

路径示例：C:\Users\Administrator\AppData\Roaming\fnm\node-versions\v22.14.0\installation\node_modules\openclaw\dist\process\exec.js

找到 spawn 调用处，增加 shell: true 参数：

const child = spawn(command, argv.slice(1), {
    stdio,
    cwd,
    env: resolvedEnv,
    shell: true // Windows 下必须启用 shell
});

Q2: 提示'openclaw 命令找不到'

解决：

1. 关闭所有终端窗口
2. 重新打开 PowerShell
3. 若无效，尝试执行 exec bash 或重启电脑刷新环境变量

Q3: 端口 18789 被占用

解决：指定其他端口启动：

openclaw gateway --port 18790

结语

OpenClaw 将 AI 从'聊天工具'进化为'执行工具'。虽然初期配置有一定门槛，但一旦部署成功，它将是一个 24/7 待命的超级助理。