> ## Documentation Index
> Fetch the complete documentation index at: https://docs.evolink.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# OpenClaw + 飞书

> 将 OpenClaw 通过飞书连接到 EvoLink.AI

## 概述

OpenClaw 是一个开源的 AI 智能体 Gateway 网关，充当聊天应用与 AI 智能体之间的桥梁。它通过一个中心化的 Gateway 进程，将 Telegram、WhatsApp、Discord、飞书等聊天平台连接到 AI 编程智能体，实现在聊天窗口中直接与 AI 进行编程交互。

通过将 **EvoLink API** 配置为 OpenClaw 的自定义模型提供商，并接入 **飞书机器人**，你可以在飞书中直接使用 EvoLink 提供的 Claude 模型（如 **Claude 4.6 Opus**、**Claude 4.5 Sonnet**、**Claude 4.5 Haiku**）进行 AI 辅助编程对话。

飞书渠道使用 **WebSocket 长连接**模式接收消息，无需公网 URL。

**本文将介绍：**

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

## 系统环境检查

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

### 下载检查工具

从 [GitHub Releases](https://github.com/suuuuuu-1/openclaw-env-checker/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、evolink.ai）

<img src="https://mintcdn.com/muyutechnology/nIFIx0gxdF53THw8/images/OpenClaw-Checker/check-success.png?fit=max&auto=format&n=nIFIx0gxdF53THw8&q=85&s=46f1fdbec3263845e35158b104fa5091" alt="检查成功示例" width="1778" height="1742" data-path="images/OpenClaw-Checker/check-success.png" />

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

## 使用前准备

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

### 1. 安装 Node.js

OpenClaw 通过 npm 安装，需要先安装 Node.js 22 或更高版本。

<Tabs>
  <Tab title="Windows">
    访问 [Node.js 官网](https://nodejs.org/zh-cn/download),下载 Windows 安装包(.msi 文件),双击运行安装程序。

    安装完成后,打开 PowerShell 验证:

    ```bash theme={null}
    node --version
    npm --version
    ```

    <Note>
      建议以管理员身份运行 PowerShell,避免后续安装时出现权限问题。
    </Note>
  </Tab>

  <Tab title="macOS">
    **方式 1: 使用安装包**

    访问 [Node.js 官网](https://nodejs.org/zh-cn/download),下载 macOS 安装包(.pkg 文件),双击运行安装程序。

    **方式 2: 使用 Homebrew**

    ```bash theme={null}
    brew install node
    ```

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

    ```bash theme={null}
    node --version
    npm --version
    ```

    <Note>
      如果后续安装时遇到权限问题,可能需要在命令前加 `sudo`。
    </Note>
  </Tab>
</Tabs>

### 2. 获取 EvoLink API Key

* 登录 [EvoLink 控制台](https://evolink.ai/dashboard)
* 在控制台中找到 API Keys，点击"创建新Key"按钮，然后复制生成的 Key
* API Key 通常以 `sk-` 开头，请妥善保存

### 3. 准备飞书账号

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

## 第一步：安装 OpenClaw

在终端中执行：

```bash theme={null}
npm install -g openclaw@latest
```

安装飞书插件：

```bash theme={null}
openclaw plugins install @openclaw/feishu
```

## 第二步：初始化引导

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

```bash theme={null}
openclaw onboard --install-daemon
```

### 1. 确认安装

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

<img src="https://mintcdn.com/muyutechnology/9zwrwFbHVtE0nZ-d/images/OpenClaw-Telegram/ScreenShot_2026-02-08_011629_241.png?fit=max&auto=format&n=9zwrwFbHVtE0nZ-d&q=85&s=fce0ba49fe04129dc943e6f63353595e" alt="确认安装" width="1488" height="1420" data-path="images/OpenClaw-Telegram/ScreenShot_2026-02-08_011629_241.png" />

### 2. 选择安装模式

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

<img src="https://mintcdn.com/muyutechnology/9zwrwFbHVtE0nZ-d/images/OpenClaw-Telegram/ScreenShot_2026-02-08_011705_241.png?fit=max&auto=format&n=9zwrwFbHVtE0nZ-d&q=85&s=24fbf84b590649d1fc1d515d2ee50609" alt="选择 Quickstart" width="1738" height="1540" data-path="images/OpenClaw-Telegram/ScreenShot_2026-02-08_011705_241.png" />

### 3. 选择供应商

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

<img src="https://mintcdn.com/muyutechnology/9zwrwFbHVtE0nZ-d/images/OpenClaw-Telegram/ScreenShot_2026-02-08_011742_033.png?fit=max&auto=format&n=9zwrwFbHVtE0nZ-d&q=85&s=a4f74b3bb72312ba426ea37179232576" alt="跳过供应商选择" width="1398" height="1272" data-path="images/OpenClaw-Telegram/ScreenShot_2026-02-08_011742_033.png" />

### 4. 选择模型

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

<img src="https://mintcdn.com/muyutechnology/9zwrwFbHVtE0nZ-d/images/OpenClaw-Telegram/ScreenShot_2026-02-08_011808_857.png?fit=max&auto=format&n=9zwrwFbHVtE0nZ-d&q=85&s=701f58ca7164b7830cef3bfb713d911b" alt="选择所有模型" width="1380" height="1528" data-path="images/OpenClaw-Telegram/ScreenShot_2026-02-08_011808_857.png" />

### 5. 选择默认模型

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

<img src="https://mintcdn.com/muyutechnology/9zwrwFbHVtE0nZ-d/images/OpenClaw-Telegram/ScreenShot_2026-02-08_011825_375.png?fit=max&auto=format&n=9zwrwFbHVtE0nZ-d&q=85&s=5ded0a9c44fd991865dbe84195862563" alt="保持当前模型" width="1334" height="1792" data-path="images/OpenClaw-Telegram/ScreenShot_2026-02-08_011825_375.png" />

## 第三步：创建飞书应用

### 1. 登录飞书开放平台

访问 [飞书开放平台](https://open.feishu.cn/app)，使用飞书账号登录。

<Note>
  Lark（国际版）请使用 [https://open.larksuite.com/app](https://open.larksuite.com/app)，并在后续配置中设置 `domain: "lark"`。
</Note>

### 2. 创建应用

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

<img src="https://mintcdn.com/muyutechnology/PB79kA5Vjr8LP50j/images/OpenClaw-Feishu/create-app.avif?fit=max&auto=format&n=PB79kA5Vjr8LP50j&q=85&s=68f3383cc4e84f804832d50b0a619b26" alt="创建应用" width="1650" height="611" data-path="images/OpenClaw-Feishu/create-app.avif" />

### 3. 获取应用凭证

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

* **App ID**（格式如 `cli_xxx`）
* **App Secret**

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

<img src="https://mintcdn.com/muyutechnology/PB79kA5Vjr8LP50j/images/OpenClaw-Feishu/get-credentials.avif?fit=max&auto=format&n=PB79kA5Vjr8LP50j&q=85&s=8b1539f0f9fd1f382304c00aaafd4471" alt="获取应用凭证" width="1650" height="728" data-path="images/OpenClaw-Feishu/get-credentials.avif" />

### 4. 配置应用权限

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

```json theme={null}
{
  "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"
    ]
  }
}
```

<img src="https://mintcdn.com/muyutechnology/PB79kA5Vjr8LP50j/images/OpenClaw-Feishu/configure-permissions.avif?fit=max&auto=format&n=PB79kA5Vjr8LP50j&q=85&s=b586b4d4778a5af577cbc188cd0f196a" alt="配置应用权限" width="1650" height="755" data-path="images/OpenClaw-Feishu/configure-permissions.avif" />

### 5. 启用机器人能力

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

<img src="https://mintcdn.com/muyutechnology/RDciMG4Sfzhb_HtY/images/OpenClaw-Feishu/enable-bot.png?fit=max&auto=format&n=RDciMG4Sfzhb_HtY&q=85&s=4acd5043b50c2a799eff3516390e6e39" alt="启用机器人能力" width="2888" height="1386" data-path="images/OpenClaw-Feishu/enable-bot.png" />

### 6. 配置事件订阅

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

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

在 **事件订阅** 页面：

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

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

<img src="https://mintcdn.com/muyutechnology/PB79kA5Vjr8LP50j/images/OpenClaw-Feishu/event-subscription.avif?fit=max&auto=format&n=PB79kA5Vjr8LP50j&q=85&s=9cbb8f9f6d35b90981908f1bcd70b8ad" alt="配置事件订阅" width="1650" height="851" data-path="images/OpenClaw-Feishu/event-subscription.avif" />

### 7. 发布应用

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

## 第四步：配置 OpenClaw

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

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

### 1. 添加飞书渠道

<Tabs>
  <Tab title="手动编辑配置">
    打开 `~/.openclaw/openclaw.json`：

    启用飞书插件（`plugins.entries`）：

    ```json theme={null}
    "plugins": {
      "entries": {
        "feishu": {
          "enabled": true
        }
      }
    }
    ```

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

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

    <Warning>
      飞书凭证必须放在 `channels.feishu.accounts` 下，而不是 `plugins.entries.feishu` 中。如果放错位置会报 `Unrecognized key` 错误。
    </Warning>

    也可以通过环境变量配置：

    ```bash theme={null}
    export FEISHU_APP_ID="cli_xxx"
    export FEISHU_APP_SECRET="xxx"
    ```
  </Tab>

  <Tab title="命令行添加">
    运行以下命令，根据提示选择 Feishu 并输入 App ID 和 App Secret：

    ```bash theme={null}
    openclaw channels add
    ```

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

### 2. 配置 EvoLink API

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

```json theme={null}
"models": {
  "providers": {
    "evolink-anthropic": {
      "api": "anthropic-messages",
      "baseUrl": "https://direct.evolink.ai",
      "apiKey": "你的EvoLink API Key",
      "models": [
        { "id": "claude-fable-5", "name": "Claude Fable 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-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" }
      ]
    },
    "evolink-google": {
      "api": "google-generative-ai",
      "baseUrl": "https://direct.evolink.ai/v1beta",
      "apiKey": "你的EvoLink 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" }
      ]
    },
    "evolink-openai": {
      "api": "openai-completions",
      "baseUrl": "https://direct.evolink.ai/v1",
      "apiKey": "你的EvoLink 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" }
      ]
    }
  }
}
```

<Warning>
  将 `"你的EvoLink API Key"` 替换为你在 [EvoLink 控制台](https://evolink.ai/dashboard) 获取的实际 API Key。
</Warning>

### 3. 配置默认模型

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

```json theme={null}
"model": {
  "primary": "evolink-anthropic/claude-opus-4-6"
}
```

### 4. 重启网关

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

```bash theme={null}
openclaw gateway restart
```

<Warning>
  请使用 `openclaw gateway restart` 而不是手动再起一个进程，否则会因端口占用而报错。
</Warning>

可通过以下命令确认配置是否正确加载：

```bash theme={null}
openclaw gateway status
```

## 第五步：验证连接

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

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

### 2. 获取配对码

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

### 3. 完成配对

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

```bash theme={null}
openclaw pairing approve feishu <配对码>
```

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

### 4. 测试对话

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

```
你好，请介绍一下你自己
```

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

## 访问控制

### 私聊访问

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

```bash theme={null}
openclaw pairing list feishu        # 查看待审批列表
openclaw pairing approve feishu <CODE>  # 批准
```

也可以通过 `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` |