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

输入你的 API Key 后回车。

4. 选择 AI 模型

默认选择 GLM 4.7 即可，这是智谱当前的旗舰模型。

5. 连接通讯平台

配置完模型后，系统会询问连接哪个平台。原生支持 WhatsApp、Telegram 等，国内用户可选择跳过，稍后单独配置飞书。

此处选择跳过，后续通过 UI 界面补充配置。

6. 选择 Skills 与 Hooks

• Skills：暂不配置，后续通过 Web UI 管理
• Hooks：按空格选中，回车确认开启

7. 启动服务

系统会自动打开新窗口启动服务，等待约 30 秒后，回到设置窗口选择 Open the Web UI 打开管理界面。

浏览器将自动跳转至 Web UI 首页，此时可进行基础测试。

五、接入飞书机器人

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

1. 创建开发者应用

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

点击右上角进入 开发者后台，选择 创建应用。

2. 填写应用信息

按照指引填写应用名称、描述等信息，保存后获取应用凭证（App ID 和 App Secret）。

3. 添加机器人并配置权限

在应用详情页添加机器人，并开通即时通讯相关权限，确保能接收和发送消息。

4. 发布应用

创建版本并发布为在线应用，提交审批。审批通过后，应用方可生效。

5. 安装飞书插件

回到 PowerShell 窗口，安装飞书插件：

openclaw plugins install @m1heng-clawd/feishu 

安装成功后，新建一个命令窗口运行配置命令：

openclaw config

按提示选择渠道，输入之前获取的飞书 AppID 和 AppSecret，域名选择中国区，并根据需求勾选群组聊天权限。

6. 配置事件回调

返回飞书开发者后台，找到应用的事件订阅设置：

1. 选择 使用长连接接收事件
2. 添加 接收消息事件
3. 开通获取通讯录基本信息的权限
4. 重新发布版本

7. 验证连接

配置完成后重启服务。打开飞书客户端或手机 App，向机器人发送消息，观察是否能收到回复。

六、Web 控制面板

配置完成后，PowerShell 底部会显示控制面板链接，例如：

Control UI: http://127.0.0.1:18789 

复制该链接在浏览器打开，即可查看可视化 UI 管理界面，进行更详细的参数调整。

七、常用命令速查

八、常见问题解答

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

原因：Windows 环境下 npm 调用可能存在路径解析问题。

解决：修改源码中的 spawn 配置。

定位文件：

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

找到 runCommandWithTimeout 函数，修改如下：

修改前：

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 });
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 命令找不到'

解决：关闭所有终端窗口，重新打开 PowerShell。如仍无效，尝试执行 exec bash 或重启电脑刷新环境变量。

Q3: 安装卡住不动

解决：按 Ctrl + C 中断，执行 openclaw doctor 检查网络或防火墙设置。

Q4: API Key 配置错误

解决：执行 openclaw onboard 重新配置，确保密钥格式无误且未包含多余空格。

Q5: 端口 18789 被占用

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

openclaw gateway --port 18790 

九、成本说明

软件本身免费，主要成本来自 AI 模型 API 调用。建议选择性价比高的国产大模型以降低开销。

结语

OpenClaw 将 AI 从单纯的对话工具进化为执行工具。虽然初期配置有一定门槛，但一旦搭建完成，它将是一个 24/7 待命的自动化助手。