飞书集成

步骤一：创建飞书应用

1. 登录飞书开放平台，选择已有应用。如果没有自建应用，可以单击“创建企业自建应用”。
   图1 创建企业自建应用
   
   图2 选择已创建的应用
   

2. 在左侧菜单单击“添加应用能力”，在“按能力添加”页签，添加机器人。
   图3 添加机器人
   

3. 配置相关权限，允许机器人拥有获取信息等基础能力。
   1. 选择左侧菜单的权限管理，单击“批量导入/导出权限”。
      图4 配置权限
      
   2. 导入以下权限，并按照飞书页面提示完成权限配置。
      图5 导入权限
      
      导入权限的JSON数据：

      {
        "scopes": {
          "tenant": [
            "application:application:self_manage",
            "cardkit:card:read",
            "cardkit:card:write",
            "contact:contact.base:readonly",
            "docx:document",
            "docx:document.block:convert",
            "docx:document:readonly",
            "drive:drive",
            "drive:drive:readonly",
            "im:app_feed_card:write",
            "im:biz_entity_tag_relation:read",
            "im:biz_entity_tag_relation:write",
            "im:chat",
            "im:chat.access_event.bot_p2p_chat:read",
            "im:chat.announcement:read",
            "im:chat.announcement:write_only",
            "im:chat.chat_pins:read",
            "im:chat.chat_pins:write_only",
            "im:chat.collab_plugins:read",
            "im:chat.collab_plugins:write_only",
            "im:chat.managers:write_only",
            "im:chat.members:bot_access",
            "im:chat.members:read",
            "im:chat.members:write_only",
            "im:chat.menu_tree:read",
            "im:chat.menu_tree:write_only",
            "im:chat.moderation:read",
            "im:chat.tabs:read",
            "im:chat.tabs:write_only",
            "im:chat.top_notice:write_only",
            "im:chat.widgets:read",
            "im:chat.widgets:write_only",
            "im:chat:create",
            "im:chat:delete",
            "im:chat:moderation:write_only",
            "im:chat:operate_as_owner",
            "im:chat:read",
            "im:chat:readonly",
            "im:chat:update",
            "im:datasync.feed_card.time_sensitive:write",
            "im:message",
            "im:message.group_at_msg:readonly",
            "im:message.group_msg",
            "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.urgent",
            "im:message.urgent.status:write",
            "im:message.urgent:phone",
            "im:message.urgent:sms",
            "im:message:readonly",
            "im:message:recall",
            "im:message:send_as_bot",
            "im:message:send_multi_depts",
            "im:message:send_multi_users",
            "im:message:send_sys_msg",
            "im:message:update",
            "im:resource",
            "im:tag:read",
            "im:tag:write",
            "im:url_preview.update",
            "im:user_agent:read",
            "wiki:wiki",
            "wiki:wiki:readonly"
          ],
          "user": [
            "base:app:copy",
            "base:app:create",
            "base:app:read",
            "base:app:update",
            "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",
            "board:whiteboard:node:create",
            "board:whiteboard:node: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",
            "calendar:calendar:read",
            "contact:contact.base:readonly",
            "contact:user.base:readonly",
            "contact:user.employee_id: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",
            "offline_access",
            "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"
          ]
        }
      }

4. 配置事件与回调。单击页面左侧的“事件与回调”，单击将订阅方式配置为“使用长连接接收事件”，并单击“添加事件”将“接收消息”添加到事件。
   图6 配置事件与回调
   

5. 发布版本。单击页面左上方的“创建版本”，填写版本号（如1.0.0）、更新说明，单击“保存”后确认发布。
   图7 发布版本
   

步骤二：在OfficeClaw集成飞书

1. 登录OfficeClaw。
2. 在左侧导航栏中选择“渠道”，在渠道列表中选择“飞书”。
3. 单击生成二维码按钮，等待二维码生成后，使用飞书扫描对接。

步骤三：开始使用

1. 在飞书的搜索框中，输入步骤一中创建的应用名称。
2. 单击机器人，通过聊天窗直接和OfficeClaw对话，如图8所示，OfficeClaw中显示和钉钉的会话信息表示对接成功。
   图8 在飞书中和OfficeClaw对话
   

步骤四：配置个人白名单

当您在飞书群聊中使用OfficeClaw控制本地电脑时，为了防止他人误操作或恶意控制，请务必开启个人白名单功能。

1. 登录OfficeClaw。
2. 在左侧导航栏中选择“渠道”，在渠道列表中选择“飞书”。
3. 在个人白名单区域，如图9所示，填入open_id和对应备注，单击“添加”。

   open_id获取方式：在飞书中@机器人，发送/myid获取open_id。

   图9 配置个人白名单
   

   设置完成后，群聊内只有您本人“@机器人”才会触发回复。其他成员的呼叫将被系统自动忽略，以此确保操作权限的唯一性与安全性。

常用指令

OfficeClaw支持通过特殊前缀指令控制会话，常用指定如下表1所示。