cube-ai/dsh-feishu-client ↗★ 1

@cubeai/dsh-feishu-client

DSH飞书客户端:1)用户(人)通过本插件提供UI访问远端智能体;2)本地DSH通过调用本插件提供工具访问远端智能体。支持的远端智能体包括且不限于:DSH、OpenClaw、WorkBuddy、Weknora等等。

Package
@cubeai/dsh-feishu-client
Compatibility
Unverified
Version
0.1.2
License
Apache-2.0
Last updated
Nov 11, 2026

Install

$npx -p @deepseek-ai/dsh dsh plugin --profile web add @cubeai/dsh-feishu-client

第一次使用

A. 远端智能体准备(以 DSH 为例)

1. 安装飞书频道插件

在目标 DSH 安装并启用 @cubeai/dsh-feishu-channels 插件 :

dsh plugin --profile web add @cubeai/dsh-feishu-channels

刷新 DSH,侧边栏出现 任务 | 飞书频道。

2. 添加飞书频道

在目标 DSH 的「飞书频道」页签中:

  1. 点击「添加飞书频道」;
  2. 填写频道名称;
  3. 扫码创建飞书机器人应用。

插件会自动开通所需权限并写入重定向 URL,通常不需要再进入飞书开发者后台进行操作。

B. 本地智能体操作

1. 在本地添加机器人
  1. 点击本地 DSH 左侧边栏的「DSH飞书客户端」;
  2. 点击「+ 添加飞书机器人」;
  3. 填写名称、App ID、App Secret。可从目标 DSH 的「飞书频道」设置中复制;
  4. 保存后进入授权页。
2. 授权并绑定单聊

点击「授权并绑定单聊」,在手机飞书App中扫码/登录并同意。授权成功后插件会自动让机器人发一条设置消息。

绑定成功后,左侧出现机器人,在右侧对话界面直接发消息即可。

本插件必须使用目标智能体正在使用的同一个飞书机器人应用。一个飞书机器人应用只对应一个单聊。

日常使用

机器人列表

  • 点击左侧机器人切换对话;
  • 列表显示名称、最后一条消息、状态点和时间;
  • 点击「+ 添加飞书机器人」可添加新的机器人。

聊天页

  • 右上角「刷新」重新拉取消息和授权状态;
  • 右上角「设置」进入设置页;
  • 输入框支持文字、附件、粘贴图片/文件;
  • 消息区支持 Markdown、代码块、图片灯箱、文件卡片和审批按钮。

设置页

设置页分为两张卡片:

  • 基本信息:名称、能力描述、标签,修改后点「保存修改」;
  • 连接与授权:查看授权和单聊绑定状态,执行授权、重新绑定、重新授权、测试应用、删除机器人。

右上角「返回」回到对话。删除机器人只删除本插件记录,不会删除飞书机器人应用,也不影响飞书侧聊天记录。

Agent 工具用法

  • 先让智能体调用 feishu_client_list 选择远端;
  • 再调用 feishu_client_ask 提交任务;
  • 返回 pending、needs_approval 或 needs_answer 时,用 feishu_client_continue 继续;
  • 同一远端同时只允许一个请求,第二个请求会返回 busy。

使用限制

  • 当前一个飞书机器人应用只对应一个单聊;
  • 聊天页加载最近 50 条消息,暂不支持分页;
  • 远端飞书频道当前按文本、图片、文件和富文本处理消息,原生语音/视频按文件发送;
  • UI 目前为中文,插件元数据提供中英文。