在 WispTerm 里完成 Agent 工作

第 1 步：创建企业自建应用

进入 https://open.feishu.cn/app 创建企业自建应用，例如 WispTerm-Lab。国际版 Lark 对应接口域名为 https://open.larksuite.com。

第 2 步：添加机器人能力

在添加应用能力里选择机器人。WispTerm 使用机器人能力收发消息、卡片和交互回调。

第 3 步：导入权限

在权限管理里选择批量导入/导出权限，切到导入，粘贴下面的 JSON：

{
  "scopes": {
    "tenant": [
      "application:application:self_manage",
      "application:bot.basic_info:read",
      "application:bot.menu:write",
      "cardkit:card:read",
      "cardkit:card:write",
      "contact:contact.base:readonly",
      "docs:document.comment:create",
      "docs:document.comment:delete",
      "docs:document.comment:read",
      "docs:document.comment:update",
      "docs:document.comment:write_only",
      "docx:document.block:convert",
      "docx:document:readonly",
      "docx:document:write_only",
      "drive:drive.metadata:readonly",
      "im:chat.members:bot_access",
      "im:chat:create",
      "im:chat:read",
      "im:chat:update",
      "im:message.group_at_msg.include_bot:readonly",
      "im:message.group_at_msg:readonly",
      "im:message.p2p_msg:readonly",
      "im:message.pins:read",
      "im:message.pins:write_only",
      "im:message.reactions:read",
      "im:message.reactions:write_only",
      "im:message:readonly",
      "im:message:send_as_bot",
      "im:message:send_multi_users",
      "im:message:send_sys_msg",
      "im:message:update",
      "im:resource",
      "wiki:node:read"
    ],
    "user": [
      "offline_access"
    ]
  }
}

第 4 步：配置长连接事件

进入事件与回调 → 事件配置，选择长连接模式，然后添加 im.message.receive_v1。WispTerm 配好凭证前显示连接失败是正常的。

第 5 步：发布应用

创建版本 1.0.0，移动端默认能力和桌面端默认能力都选机器人，更新说明随意填写，然后提交发布。飞书个人版通常免审核，提交后立即可用。

第 6 步：把凭证填到 WispTerm

应用发布后，从飞书复制 App ID 和 App Secret。

第 7 步：在 WispTerm 中配置

1. 按 CtrlShiftP（macOS 上 CmdShiftP）打开命令中心。
2. 输入 feishu。
3. 运行 Feishu: Configure。
4. 填写 App ID 和 App Secret，然后保存。
5. 重启 WispTerm。

配置文件回退

也可以设置 feishu-enabled、feishu-app-id、feishu-app-secret，以及可选的 feishu-allowed-user。ID/secret 留空时会回退读取 FEISHU_APP_ID 和 FEISHU_APP_SECRET。