ArkClaw x 飞书，唤醒你的龙虾助理

本文主要介绍如何开通火山引擎ArkClaw，并且通过飞书使用ArkClaw，完成基本的对话任务

• Step 1 ｜ 开通并创建ArkClaw
• Step 2 ｜ 创建飞书企业自建应用
• Step 3 ｜ 配置ArkClaw 消息渠道
• Step 4 ｜ 订阅事件与发布应用
• Step 5 ｜ 与飞书完成配对，通过飞书控制ArkClaw

Step 1｜开通并创建 ArkClaw

1. 进入火山引擎官网

打开火山引擎官网 点击进入 ArkClaw 飞书专属活动页

2. 订阅 ArkClaw 套餐

下划找到“即刻解锁 ArkClaw” ，点击 “立即体验”， 选择方案进行订阅，进行注册实名认证后购买

• Lite Plan：首月 ￥9.9， 适合个人或轻量化开发场景
• Pro Plan： 首月 ￥49.9，更高的调用次数，适合企业或重度使用用户

3. 创建 ArkClaw

购买后，点击回到体验中心 ，点击 “立即创建”， 这一步大约需要 1-2 分钟

4. 🎉 出现下方界面即说明完成创建！

Step 2｜创建飞书企业自建应用

后续我们将提供一键创建机器人的能力，敬请期待

1. 创建企业自建应用

1. 登陆开发者后台：开发者后台 - 飞书开放平台，创建企业自建应用
2. 在弹出的创建窗口中，填写以下信息：

配置项	填写内容（后续都可以随意修改）	说明
应用名称	（内容随便写）	自定义名称
应用描述	（内容随便写）	简单描述用途
应用图标	可以暂时不传

3. 填写完成后，点击 “创建” 按钮
4. 应用创建成功后，会自动跳转到应用详情页

2. 添加应用能力

在能力列表中，找到 “机器人” 能力卡片，点击卡片上的 “添加” 按钮

3.批量导入应用权限（最关键步骤）

‼️这是最容易出错的步骤，必须严格按要求操作！

1. 在应用详情页左侧目录树，找到 权限管理 > 批量导入 / 导出权限

2. 在弹出的窗口中，默认是 “导入” 页签，清空输入框内的所有内容，将下方代码块内容完整复制进来，点击 “确定新增权限” 完成权限导入

{
  "scopes": {
    "tenant": [
      "contact:contact.base:readonly",
      "docx:document:readonly",
      "im:chat:read",
      "im:chat:update",
      "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:recall",
      "im:message:send_as_bot",
      "im:message:send_multi_users",
      "im:message:send_sys_msg",
      "im:message:update",
      "im:resource",
      "application:application:self_manage",
      "cardkit:card:write",
      "cardkit:card:read"
    ],
    "user": [
      "contact:user.employee_id:readonly",
      "offline_access","base:app:copy",
      "base:field:create",
      "base:field:delete",
      "base:field:read",
      "base:field:update",
      "base:record:create",
      "base:record:delete",
      "base:record:retrieve",
      "base:record:update",
      "base:table:create",
      "base:table:delete",
      "base:table:read",
      "base:table:update",
      "base:view:read",
      "base:view:write_only",
      "base:app:create",
      "base:app:update",
      "base:app:read",
      "board:whiteboard:node:create",
      "board:whiteboard:node:read",
      "calendar:calendar:read",
      "calendar:calendar.event:create",
      "calendar:calendar.event:delete",
      "calendar:calendar.event:read",
      "calendar:calendar.event:reply",
      "calendar:calendar.event:update",
      "calendar:calendar.free_busy:read",
      "contact:contact.base:readonly",
      "contact:user.base:readonly",
      "contact:user:search",
      "docs:document.comment:create",
      "docs:document.comment:read",
      "docs:document.comment:update",
      "docs:document.media:download",
      "docs:document:copy",
      "docx:document:create",
      "docx:document:readonly",
      "docx:document:write_only",
      "drive:drive.metadata:readonly",
      "drive:file:download",
      "drive:file:upload",
      "im:chat.members:read",
      "im:chat:read",
      "im:message",
      "im:message.group_msg:get_as_user",
      "im:message.p2p_msg:get_as_user",
      "im:message:readonly",
      "search:docs:read",
      "search:message",
      "space:document:delete",
      "space:document:move",
      "space:document:retrieve",
      "task:comment:read",
      "task:comment:write",
      "task:task:read",
      "task:task:write",
      "task:task:writeonly",
      "task:tasklist:read",
      "task:tasklist:write",
      "wiki:node:copy",
      "wiki:node:create",
      "wiki:node:move",
      "wiki:node:read",
      "wiki:node:retrieve",
      "wiki:space:read",
      "wiki:space:retrieve",
      "wiki:space:write_only"
    ]
  }
}

3. 等待几秒钟，页面会显示权限已添加

4.获取应用凭证（⚠️ 请对自己的这两个信息严格保密！)

1. 在应用详情页左侧目录，找到 “凭证与基础信息” ，点击进入
2. 在页面中，您会看到以下两项重要信息，请务必完整复制并妥善保存：

凭证名称	格式说明	用途
App ID	格式如 cli_xxxxxxxxxxxx	飞书应用唯一标识
App Secret	一串长字符串	应用安全密钥，不可泄露

Step 3｜配置 ArkClaw 消息渠道

1. 点击 “消息渠道” ，将上一步获取 App ID 和 App Secret 粘贴进来，点击 “确定” 。

2. 等待飞书渠道配置成功即可

Step 4｜订阅事件与发布应用

1. 订阅机器人长链接 接收事件和卡片回调

这一步的作用是让 OpenClaw 具有在飞书内收发消息的能力

1. 进入飞书开放平台，找到刚刚创建的应用，配置 “事件与回调”
2. 进入 事件配置 > 订阅方式 > 使用 长链接 接受事件 > 保存

3. 添加 “接收消息” 事件

4. 进行 “回调配置”

进入 “回调配置” ，搜索并添加 “卡片回传交互” ，点击 “确认添加”

2. 发布应用

应用必须发布后，才能在飞书中使用！

1. 点击上方 “创建版本”

2. 在弹出的窗口中：

   1. 填写版本号（如：1.0.0）
   2. 填写版本描述（如：首次发布，集成 OpenClaw）

3. 点击 “确定” 创建版本

4. 创建成功后，点击版本右侧的 “发布” 按钮

5. 等待管理员审批即可

Step 5｜与飞书完成配对

1. 在飞书里找到你刚创建的机器人

![picture.image](https://p3-volc-community-sign.byteimg.com/tos-cn-i-tlddhu82om/1d008bf5bf6c4d11b044cb3b58f317ba~tplv-tlddhu82om-image.image?=&rk3s=8031ce6d&x-expires=1773320358&x-signature=RKO%2FInrCn%2Btx2i9zwnjiy3bqjZs%3D)

**“开发者小助手”** 会将审批通过的应用推送到你的消息界面，点击 **“打开应用”**

2. 在应用内随意发送一条消息，比如“你好👋”

1. 会收到一条配对信息，复制配对码并在系统中输入即可

2. 机器人回复了就说明与飞书完成配对 🎉

3. 批量权限授权

直接在聊天框里发送：/feishu auth 即可批量完成权限授权

4. 一句话开启 “ 流式输出 ”

直接在聊天框里复制下方代码发送：

将飞书消息设置为流式输出：openclaw config set channels.feishu.streaming true

开启耗时

openclaw config set channels.feishu.footer.elapsed true  // 开启耗时

开启状态展示

openclaw config set channels.feishu.footer.status true  // 开启状态展示
> ```