二、飞书应用配置

1. 账号说明

飞书 个人账号无法创建机器人应用。
需要使用 企业 / 组织身份，但个人用户也可以免费创建。

创建方式（桌面端）：

飞书左下角「⋯」 → 登录更多账号

选择 创建新账户

 角色选择 企业或组织负责人

2. 创建企业自建应用

1.  打开 https://open.feishu.cn/app?lang=zh-CN

2. 登录企业 / 组织账号

3. 点击 创建企业自建应用

4.  填写应用名称与描述（图标可选）

3. 启用机器人能力

左侧菜单进入 添加应用能力

添加 机器人 能力

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",
      "contact:contact.base:readonly",
      "contact:user.employee_id:readonly",
      "corehr:file:download",
      "event:ip_list",
      "im:chat.access_event.bot_p2p_chat:read",
      "im:chat.members:bot_access",
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.p2p_msg:readonly",
      "im:message:readonly",
      "im:message:send_as_bot",
      "im:resource"
    ],
    "user": [
      "aily:file:read",
      "aily:file:write",
      "im:chat.access_event.bot_p2p_chat:read"
    ]
  }
}

提交权限申请：

权限变更后必须创建并发布新版本，否则不生效。

记录 App ID / App Secret：

飞书侧还有一项配置，需要在接入 OpenClaw 后进行，后文说明。

三、安装并配置 OpenClaw

1. 一键安装

curl -fsSL https://openclaw.ai/install.sh | bash

2. 交互式配置向导

Model/Auth Provider

选择 Custom Provider (Any OpenAI or Anthropic compatible endpoint)

填写 GPUStack 的 API Base URL / API Key

 Channel 选择 Feishu / Lark

填写 App ID / App Secret，
Group chat policy 建议选择：

Open - respond in all groups (requires mention)

3. 手动调整上下文窗口（必做）

OpenClaw 默认上下文长度为 4096，需手动修改。

vim ~/.openclaw/openclaw.json

重启网关：

openclaw gateway restart

4. 设置飞书事件订阅方式（关键）

将 事件订阅方式 设置为 长连接，并添加 接收消息 事件：

修改后需 创建并发布新版本，否则机器人无法接收消息。