OpenClaw 本地部署与飞书机器人接入指南

第二阶段：添加机器人能力

在应用详情页找到添加应用能力，选择并添加机器人。这一步是为了让应用拥有发送消息的权限。

第三阶段：配置权限

进入权限管理页面，开通以下即时通讯相关权限：

• 获取与发送单聊、群组消息
• 读取用户基本信息
• 获取通讯录基本信息

第四阶段：发布应用

1. 在版本管理中创建新版本。
2. 提交发布，状态变为在线应用。
3. 前往飞书客户端完成审批流程。

第五阶段：安装插件

回到 PowerShell，执行以下命令安装飞书插件：

openclaw plugins install @m1heng-clawd/feishu

第六阶段：配置插件

安装完成后，新开一个 PowerShell 窗口，执行配置命令：

openclaw config

按向导依次操作：

配置完成后需要重启服务使配置生效：

openclaw gateway stop
openclaw gateway start

第七阶段：事件回调设置

1. 回到飞书开放平台 → 应用详情 → 事件订阅。
2. 选择使用长连接接收事件。
3. 点击添加事件，勾选接收消息事件。
4. 重新发布版本（同上）。

第八阶段：开始使用

打开飞书客户端，找到你创建的机器人，直接发消息即可指挥 OpenClaw 干活！

常用命令速查

常见问题排查

Q：安装飞书插件提示 spawn npm ENOENT

这是 Windows 上的已知兼容性问题。需要修改底层执行逻辑：

1. 找到以下路径的文件： C:\Users\你的用户名\AppData\Roaming\fnm\node-versions\v22.x.x\installation\node_modules\openclaw\dist\process\exec.js
2. 找到 runCommandWithTimeout 函数中的 spawn 调用。
3. 在其前面添加 Windows npm 兼容处理代码：

let command = argv[0];
let useShell = false;
if (process.platform === "win32" && path.basename(command) === "npm") {
    useShell = true;
}
const child = spawn(command, argv.slice(1), {
    stdio,
    cwd,
    env: resolvedEnv,
    shell: useShell,
});

Q：提示 "openclaw 命令找不到"

关闭所有 PowerShell 窗口，重新打开后重试。如果还不行，重启电脑刷新环境变量。

Q：安装卡住不动

按 Ctrl+C 中断，执行 openclaw doctor 检查问题，同时确认防火墙是否阻止了网络请求。

Q：端口 18789 被占用

换用其他端口启动服务：

openclaw gateway --port 18790

费用说明

• 软件本身：完全免费
• 主要费用：AI 模型 API 调用（推荐使用智谱 GLM 等国内模型，成本更低）