Skip to Content
数字员工服务概览

数字员工服务

FunClaw 提供平台级数字员工。独立应用和第三方系统登记为应用后，以应用自己的服务身份 caller 调用获授权员工，提交任务并读取结果。

应用保留自己的数据库、用户角色和业务流程。FunClaw 负责应用身份、员工使用授权、任务派发、执行状态和结果交付。

开始接入

  1. 快速接入：在 Console 配置授权，用应用后端跑通第一个任务。
  2. 调用接口：查看身份、员工列表、提交、查询、结果和取消接口。
  3. 输入与结果：约定任务内容、结果格式和业务回调。
  4. 接入示例与排错：参考素材采集、AI 打标及状态同步的实际接法。

调用链路

应用后端（应用服务凭证）
  → FunClaw 校验应用身份与员工使用授权
  → 创建 Assignment
  → 员工的 Adapter 领取并执行
  → 保存任务结果，完成 Assignment
  → 应用后端查询、校验结果，处理业务入库

应用提交任务使用 POST /api/open/v1/applications/me/tasks。任务 ID 与 Assignment ID 相同。内部独立应用和外部第三方使用同一套接口。

身份与归属

对象含义
平台数字员工平台维护，按授权提供给组织或应用使用；同一员工通过自己的 Adapter 执行任务。
应用 caller从应用服务凭证解析的调用者，形如 {"type":"APPLICATION","id":"应用 UUID"}。
应用任务归属调用应用，复用 Assignment、Run、并发控制、取消和完成机制。
组织 / 空间用户访问应用、读取组织资产等资源操作的上下文，按对应接口单独校验。

调用员工无需为第三方建立虚拟组织，也无需创建 Workbench 私聊。应用任务接口从凭证确定应用身份，不接收组织、空间或用户作为任务归属。

能力授权

授权配置位置作用
应用使用员工Console → 应用管理 → 应用详情 → 员工授权指定应用可调用哪些员工、有效期和操作范围。创建任务需要 TASK_CREATE，查询与结果读取需要 READ。
员工执行工具Console → 数字员工 → 执行能力配置员工执行任务时可使用的工具，例如 TikHub；应用无需重复取得员工工具授权。
应用直接调用平台服务Console → 应用管理 → 应用详情 → 平台能力应用后端直接使用获授权的平台服务，与委托员工执行任务分别配置。

应用服务凭证保存在应用后端。它识别应用，不能替代用户的 FunClaw 登录身份或组织/空间访问资格。组织/空间型应用的访问资格仍由 FunClaw 校验，应用内部业务权限由应用自己管理。

平台完成与业务完成

COMPLETED 表示员工执行结束且平台已保存结构化结果。应用仍需校验 output、确认业务回执并完成自己的入库、审核或结算；例如 AI 打标结果可以进入待人工审核状态。

平台通用接口支持 JSON 输入与 JSON 结果。大文件、完整业务数据和图片可由应用自己的接口承接，平台结果保留可校验的摘要。详细约定见输入与结果。

相关文档

Last updated on
TikHub（REST）快速接入