OpenClaw + 飞书

概述

OmniMux 网关统一使用 Base URL：https://api.omnimux.ai（OpenAI 兼容客户端通常填 https://api.omnimux.ai/v1）。控制台为 omnimux.ai/dashboard。文中的模型 ID 仅为示例，请以控制台或 GET /v1/models 为准。

OpenClaw 是一个开源的 AI 智能体 Gateway 网关，充当聊天应用与 AI 智能体之间的桥梁。它通过一个中心化的 Gateway 进程，将 Telegram、WhatsApp、Discord、飞书等聊天平台连接到 AI 编程智能体，实现在聊天窗口中直接与 AI 进行编程交互。通过将 OmniMux API 配置为 OpenClaw 的自定义模型提供商，并接入 飞书机器人，你可以在飞书中直接使用 OmniMux 提供的 Claude 模型（如 Claude 4.6 Opus、Claude 4.5 Sonnet、Claude 4.5 Haiku）进行 AI 辅助编程对话。飞书渠道使用 WebSocket 长连接模式接收消息，无需公网 URL。 本文将介绍：

安装并配置 OpenClaw Gateway
在飞书开放平台创建企业自建应用
将 OmniMux API 配置为自定义模型提供商
验证连接并开始使用

系统环境检查

在开始安装之前，建议先运行环境检查工具，确保你的系统满足 OpenClaw 的运行要求。

下载检查工具

从 GitHub Releases 下载对应平台的检查工具：

平台	文件名
Windows	`openclaw-checker-win-x64.exe`
macOS (Intel)	`openclaw-checker-macos-x64`
macOS (Apple Silicon)	`openclaw-checker-macos-arm64`
Linux	`openclaw-checker-linux-x64`

检查项目

工具会自动检查以下条件：

✅ Node.js 版本（需要 >= 22.12.0）
✅ npm 可用
✅ Git 可用
✅ 网络连通性（github.com、npmjs.org、omnimux.ai）

如果检查未通过，工具会给出具体的修复建议。

使用前准备

在开始配置之前，请确保已完成以下准备工作：

1. 安装 Node.js

OpenClaw 通过 npm 安装，需要先安装 Node.js 22 或更高版本。访问 Node.js 官网,下载 Windows 安装包(.msi 文件),双击运行安装程序。安装完成后,打开 PowerShell 验证:

node --version
npm --version

建议以管理员身份运行 PowerShell,避免后续安装时出现权限问题。 方式 1: 使用安装包 访问 Node.js 官网,下载 macOS 安装包(.pkg 文件),双击运行安装程序。 方式 2: 使用 Homebrew

brew install node

安装完成后,打开终端验证:

node --version
npm --version

如果后续安装时遇到权限问题,可能需要在命令前加 sudo。

2. 获取 OmniMux API Key

登录 OmniMux 控制台
在控制台中找到 API Keys，点击”创建新Key”按钮，然后复制生成的 Key
API Key 通常以 sk- 开头，请妥善保存

3. 准备飞书账号

需要拥有飞书企业账号，用于在飞书开放平台创建应用。

第一步：安装 OpenClaw

在终端中执行：

npm install -g openclaw@latest

安装飞书插件：

openclaw plugins install @openclaw/feishu

第二步：初始化引导

运行新手引导命令，OpenClaw 会引导你完成初始配置并安装后台守护服务：

openclaw onboard --install-daemon

1. 确认安装

系统会提示安装风险说明，确认同意后继续：

2. 选择安装模式

系统会提示选择安装模式，选择 Quickstart 即可：

3. 选择供应商

系统会提示选择模型供应商，这里选择 跳过（Skip），后续我们会手动配置 OmniMux 作为自定义供应商：

4. 选择模型

系统会提示选择要启用的模型，选择 All（全部） 即可：

5. 选择默认模型

系统会提示选择默认模型，选择 Keep current（保持当前） 即可：

第三步：创建飞书应用

1. 登录飞书开放平台

访问飞书开放平台，使用飞书账号登录。 Lark（国际版）请使用 https://open.larksuite.com/app，并在后续配置中设置 domain: "lark"。

2. 创建应用

点击 创建企业自建应用，填写应用名称和描述，选择应用图标。

3. 获取应用凭证

在应用的 凭证与基础信息 页面，复制：

App ID（格式如 cli_xxx）
App Secret

请妥善保管 App Secret，不要分享给他人。

4. 配置应用权限

在 权限管理 页面，点击 批量导入 按钮，粘贴以下 JSON 配置一键导入所需权限：

{
"scopes": {
"tenant": [
"aily:file:read",
"aily:file:write",
"application:application.app_message_stats.overview:readonly",
"application:application:self_manage",
"application:bot.menu:write",
"cardkit:card:write",
"contact:contact.base:readonly",
"contact:user.employee_id:readonly",
"corehr:file:download",
"docs:document.content:read",
"event:ip_list",
"im:chat",
"im:chat.access_event.bot_p2p_chat:read",
"im:chat.members:bot_access",
"im:message",
"im:message.group_at_msg:readonly",
"im:message.group_msg",
"im:message.p2p_msg:readonly",
"im:message:readonly",
"im:message:send_as_bot",
"im:resource",
"sheets:spreadsheet",
"wiki:wiki:readonly"
],
"user": [
"aily:file:read",
"aily:file:write",
"im:chat.access_event.bot_p2p_chat:read"
]
}
}

5. 启用机器人能力

在左侧导航栏点击 应用能力，找到 机器人 卡片，点击 开启菜单状态。开启后填写机器人名称和描述，用户在飞书中搜索或对话时会看到这些信息。

6. 配置事件订阅

在配置事件订阅前，请确保已完成以下步骤：

已完成飞书渠道配置（见第四步）
网关处于启动状态（可通过 openclaw gateway status 检查）

在 事件订阅 页面：

选择 使用长连接接收事件（WebSocket 模式）
添加事件：im.message.receive_v1（接收消息）

如果网关未启动或渠道未添加，长连接设置将保存失败。

7. 发布应用

在 版本管理与发布 页面创建版本，提交审核并发布。企业自建应用通常自动通过审批。

第四步：配置 OpenClaw

OpenClaw 的配置集中在 ~/.openclaw/openclaw.json 文件中。你需要理解三个关键配置域：

plugins.entries.* — 控制加载哪个插件
channels.* — 控制渠道连接方式和账号凭据
models.providers.* — 控制模型提供商

1. 添加飞书渠道

打开 ~/.openclaw/openclaw.json：启用飞书插件（plugins.entries）：

"plugins": {
"entries": {
"feishu": {
"enabled": true
}
}
}

配置飞书渠道凭证（channels.feishu）：

"channels": {
"feishu": {
"enabled": true,
"dmPolicy": "pairing",
"accounts": {
"main": {
"appId": "cli_xxx",
"appSecret": "你的App Secret",
"botName": "我的AI助手"
}
}
}
}

飞书凭证必须放在 channels.feishu.accounts 下，而不是 plugins.entries.feishu 中。如果放错位置会报 Unrecognized key 错误。也可以通过环境变量配置：

export FEISHU_APP_ID="cli_xxx"
export FEISHU_APP_SECRET="xxx"

运行以下命令，根据提示选择 Feishu 并输入 App ID 和 App Secret：

openclaw channels add

较新版本的 OpenClaw 使用此命令可能会出现配置冲突，建议优先使用手动编辑配置的方式。

2. 配置 OmniMux API

在同一个 openclaw.json 中，找到 models 字段，添加 OmniMux 作为自定义模型提供商：

"models": {
"providers": {
"omnimux-anthropic": {
"api": "anthropic-messages",
"baseUrl": "https://api.omnimux.ai",
"apiKey": "你的 OmniMux API Key",
"models": [
{ "id": "claude-fable-5", "name": "Claude Fable 5" },
{ "id": "claude-opus-5", "name": "Claude Opus 5" },
{ "id": "claude-opus-4-8", "name": "Claude Opus 4.8" },
{ "id": "claude-opus-4-7", "name": "Claude Opus 4.7" },
{ "id": "claude-opus-4-6", "name": "Claude Opus 4.6" },
{ "id": "claude-sonnet-4-6", "name": "Claude Sonnet 4.6" },
{ "id": "claude-sonnet-5", "name": "Claude Sonnet 5" },
{ "id": "claude-opus-4-5-20251101", "name": "Claude Opus 4.5" },
{ "id": "claude-sonnet-4-5-20250929", "name": "Claude Sonnet 4.5" },
{ "id": "claude-haiku-4-5-20251001", "name": "Claude Haiku 4.5" }
]
},
"omnimux-google": {
"api": "google-generative-ai",
"baseUrl": "https://api.omnimux.ai/v1beta",
"apiKey": "你的 OmniMux API Key",
"models": [
{ "id": "gemini-3.1-flash-lite-preview", "name": "Gemini 3.1 Flash Lite" },
{ "id": "gemini-3.1-pro-preview", "name": "Gemini 3.1 Pro" },
{ "id": "gemini-2.5-pro", "name": "Gemini 2.5 Pro" },
{ "id": "gemini-2.5-flash", "name": "Gemini 2.5 Flash" },
{ "id": "gemini-3-pro-preview", "name": "Gemini 3.0 Pro" },
{ "id": "gemini-3-flash-preview", "name": "Gemini 3.0 Flash" }
]
},
"omnimux-openai": {
"api": "openai-completions",
"baseUrl": "https://api.omnimux.ai/v1",
"apiKey": "你的 OmniMux API Key",
"models": [
{ "id": "gpt-5.4", "name": "GPT-5.4" },
{ "id": "gpt-5.2", "name": "GPT-5.2" },
{ "id": "gpt-5.1", "name": "GPT-5.1" },
{ "id": "gpt-5.1-chat", "name": "GPT-5.1 Chat" },
{ "id": "gpt-5.1-thinking", "name": "GPT-5.1 Thinking" },
{ "id": "gemini-2.5-pro", "name": "Gemini 2.5 Pro (OpenAI SDK)" },
{ "id": "gemini-2.5-flash", "name": "Gemini 2.5 Flash (OpenAI SDK)" },
{ "id": "gemini-3-pro-preview", "name": "Gemini 3.0 Pro (OpenAI SDK)" },
{ "id": "gemini-3-flash-preview", "name": "Gemini 3.0 Flash (OpenAI SDK)" },
{ "id": "doubao-seed-2.0-pro", "name": "Doubao Seed 2.0 Pro" },
{ "id": "doubao-seed-2.0-lite", "name": "Doubao Seed 2.0 Lite" },
{ "id": "doubao-seed-2.0-mini", "name": "Doubao Seed 2.0 Mini" },
{ "id": "doubao-seed-2.0-code", "name": "Doubao Seed 2.0 Code" },
{ "id": "kimi-k2-thinking", "name": "Kimi K2 Thinking" },
{ "id": "kimi-k2-thinking-turbo", "name": "Kimi K2 Thinking Turbo" }
]
}
}
}

将 "你的 OmniMux API Key" 替换为你在 OmniMux 控制台获取的实际 API Key。

3. 配置默认模型

在 agents 字段中配置默认使用的模型：

"model": {
"primary": "omnimux-anthropic/claude-opus-5"
}

4. 重启网关

配置完成后，重启 OpenClaw Gateway 使配置生效：

openclaw gateway restart

请使用 openclaw gateway restart 而不是手动再起一个进程，否则会因端口占用而报错。可通过以下命令确认配置是否正确加载：

openclaw gateway status

第五步：验证连接

1. 在飞书中找到机器人

打开飞书，搜索你创建的机器人名称，开始对话。

2. 获取配对码

向机器人发送任意消息，机器人会返回一个配对码（Pairing Code）。

3. 完成配对

新开一个终端窗口，运行以下命令完成配对：

openclaw pairing approve feishu <配对码>

将 <配对码> 替换为机器人返回的实际配对码，注意去掉两边的尖括号 <>。

4. 测试对话

配对成功后，在飞书中向机器人发送消息测试：

你好，请介绍一下你自己

如果收到 AI 回复，说明接入已完成。

访问控制

私聊访问

默认 dmPolicy: "pairing"，陌生用户会收到配对码，需要管理员批准：

openclaw pairing list feishu        # 查看待审批列表
openclaw pairing approve feishu   # 批准

也可以通过 channels.feishu.allowFrom 配置白名单用户 Open ID。

群组访问

群组策略通过 channels.feishu.groupPolicy 控制：

"open" — 允许群组中所有人（默认）
"allowlist" — 仅允许 groupAllowFrom 中的用户
"disabled" — 禁用群组消息

默认需要 @机器人才会响应（requireMention: true）。

常用命令

命令	说明
`openclaw gateway status`	查看网关运行状态
`openclaw gateway restart`	重启网关服务
`openclaw logs --follow`	实时查看日志输出
`openclaw pairing list feishu`	查看待审批配对列表
`openclaw plugins list`	查看已安装插件

故障排除

问题	排查方法
机器人在群组中不响应	检查是否已 @机器人；检查 `groupPolicy` 是否为 `"disabled"`
机器人收不到消息	检查应用是否已发布审批；检查事件订阅是否配置了 `im.message.receive_v1`；确认选择了长连接模式
App Secret 泄露	在飞书开放平台重置 App Secret，更新配置文件，重启网关
发送消息失败	检查是否有 `im:message:send_as_bot` 权限；查看日志 `openclaw logs --follow`

​概述

​系统环境检查

​下载检查工具

​检查项目

​使用前准备

​1. 安装 Node.js

​2. 获取 OmniMux API Key

​3. 准备飞书账号

​第一步：安装 OpenClaw

​第二步：初始化引导

​1. 确认安装

​2. 选择安装模式

​3. 选择供应商

​4. 选择模型

​5. 选择默认模型

​第三步：创建飞书应用

​1. 登录飞书开放平台

​2. 创建应用

​3. 获取应用凭证

​4. 配置应用权限

​5. 启用机器人能力

​6. 配置事件订阅

​7. 发布应用

​第四步：配置 OpenClaw

​1. 添加飞书渠道

​2. 配置 OmniMux API

​3. 配置默认模型

​4. 重启网关

​第五步：验证连接

​1. 在飞书中找到机器人

​2. 获取配对码

​3. 完成配对

​4. 测试对话

​访问控制

​私聊访问

​群组访问

​常用命令

​故障排除

概述

系统环境检查

下载检查工具

检查项目

使用前准备

1. 安装 Node.js

2. 获取 OmniMux API Key

3. 准备飞书账号

第一步：安装 OpenClaw

第二步：初始化引导

1. 确认安装

2. 选择安装模式

3. 选择供应商

4. 选择模型

5. 选择默认模型

第三步：创建飞书应用

1. 登录飞书开放平台

2. 创建应用

3. 获取应用凭证

4. 配置应用权限

5. 启用机器人能力

6. 配置事件订阅

7. 发布应用

第四步：配置 OpenClaw

1. 添加飞书渠道

2. 配置 OmniMux API

3. 配置默认模型

4. 重启网关

第五步：验证连接

1. 在飞书中找到机器人

2. 获取配对码

3. 完成配对

4. 测试对话

访问控制

私聊访问

群组访问

常用命令

故障排除