OpenClaw 本地部署与飞书集成实战

选择快速启动模式即可。

3. 配置 AI 模型 API Key

OpenClaw 需要连接到大语言模型才能工作。由于国外模型成本高、门槛高，这里建议选择国内的智谱 GLM 系列。

如果没有 API Key，需自行注册账号获取：https://www.bigmodel.cn/glm-coding

输入自己的 API Key 并保存。

4. 选择 AI 模型

默认选择 GLM 4.7，这是智谱当前的旗舰模型，效果较好。

5. 连接即时通讯平台

配置完 AI 模型后，OpenClaw 会询问要连接哪个通讯平台。

原生支持的海外平台主要是 WhatsApp、Telegram、Discord 等。国内用户建议使用飞书或钉钉。这里我们先选择跳过，后续通过 UI 界面单独配置飞书插件。

6. 选择 Skills

选择 No，暂不配置，后续通过 UI 界面进行更灵活的管理。

7. 是否开启 Hooks

操作步骤：先敲 空格 选中当前项，再敲回车键确认。

8. 启动服务并打开 UI 界面

此时会自动打开一个新的命令窗口来启动服务，这个过程可能需要等待几十秒。

回到刚才的设置窗口，选择 Open the Web UI，浏览器会自动打开 OpenClaw 的 Web 管理界面。

9. 测试一下

在 Web 界面中输入指令，验证 AI 是否能正常响应。

五、接入飞书机器人

我们需要先到飞书平台创建自己的机器人来接入 OpenClaw。

1. 来到飞书开发者后台

访问飞书开放平台地址：https://open.feishu.cn

点击右上角进入 开发者后台。

2. 创建应用

点击 创建应用，选择 企业自建应用。

3. 填写应用信息

按照指引填写应用名称、图标等信息。

4. 获取应用凭证

在应用详情页面，获取 App ID 和 App Secret。

5. 给应用添加机器人

在应用开发页面，找到 机器人 模块，添加机器人并配置权限。

6. 配置权限

把即时通讯相关的权限全部开通，确保能接收消息和发送消息。

7. 创建版本并发布

提交审核并发布版本。发布后需要在飞书客户端进行审批，审批通过后应用才可用。

8. 安装飞书插件

打开 PowerShell，输入以下命令安装飞书插件：

openclaw plugins install @m1heng-clawd/feishu 

安装成功后，再打开一个新的命令窗口，开始配置飞书插件：

输入命令：openclaw config

选择渠道为飞书，然后选择配置链接。

输入飞书的 App ID 和 App Secret。

域名选择中国的区域。

接受群组聊天权限。

选择完成并确认开启。

重启服务，使配置生效。控制台可以看到飞书插件已经配置成功。

9. 回到飞书后台设置事件回调

在飞书开发者后台，选择 使用长连接接收事件。

添加接收消息事件。

给应用开通获取通讯录基本信息的权限。

重新发布版本，发布为在线应用即可。

现在可以在飞书中与 AI 助手对话了！

10. 在飞书中与 OpenClaw 对话

打开飞书客户端或者手机飞书 APP，找到创建的机器人，发送消息进行测试。

六、访问 Web 控制面板

配置完成后，PowerShell 窗口底部会显示控制面板链接，格式类似：

Control UI: http://127.0.0.1:18789 

1. 复制完整链接
2. 在浏览器中打开
3. 即可看到可视化 UI 管理界面

七、常用命令速查

八、常见问题解答

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

问题原因： 这可能是 OpenClaw 的一个 bug，可以等官方更新，也可以去官方仓库提 issue。

解决步骤：

定位问题代码，文件路径通常在：

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

修改 runCommandWithTimeout 函数中的 spawn 调用。

修改前：

const stdio = resolveCommandStdio({ hasInput, preferInherit: true });
const child = spawn(argv[0], argv.slice(1), { stdio, cwd, env: resolvedEnv, windowsVerbatimArguments });

修改后：

const stdio = resolveCommandStdio({ hasInput, preferInherit: true });
// On Windows, npm must be spawned with shell: true or use .cmd extension
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 });

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

解决方法：

1. 关闭所有 PowerShell 窗口
2. 重新打开 PowerShell
3. 如果还不行，执行 exec bash 或重启电脑

Q3: 安装卡住不动

解决方法：

1. 按 Ctrl + C 中断当前操作
2. 执行：openclaw doctor 检查问题
3. 如提示网络问题，检查防火墙设置

Q4: API Key 配置错误

解决方法：

1. 执行：openclaw onboard
2. 选择重新配置 API Key
3. 确保密钥格式正确

Q5: 端口 18789 被占用

解决方法：

openclaw gateway --port 18790 

使用其他端口启动服务。

九、成本说明

OpenClaw 软件本身完全免费，主要成本来自 AI 模型 API 调用，可选择国产大模型以降低使用成本。

结语

OpenClaw 代表了个人 AI 助理的未来趋势——从'聊天工具'进化为'执行工具'。虽然目前的配置过程对新手用户有一定门槛，但一旦完成设置，您将拥有一个 24/7 待命的超级助手。