开放平台

接入 Agent 教程

1. 安装 Agent

接入前,您需要先安装一款支持 Skill 的 Agent。夸克扫描王已适配 OpenClaw、QoderWork、WorkBuddy 等主流 Agent,您可以任选其一,选择本地安装或通过第三方云端安装。

  • 本地安装: 您可以根据所选 Agent 的官方安装教程进行安装(以 OpenClaw 为例,详见 [OpenClaw 官方教程],QoderWork、WorkBuddy 等同理)。
  • 云端安装: 您也可以选择在轻量应用服务器上部署并使用 Agent 服务,建议选择阿里云服务进行安装(以 OpenClaw 为例,详见 [阿里云 OpenClaw 安装教程])。

2. 安装扫描王 Skill

Agent 安装完成以后,您可以进行夸克扫描王相关 Skill 安装。

夸克扫描王目前上线 1 套集成能力 + 4 项 Skill 能力,具体如下:

  • 夸克扫描王(全部能力): 集合 OCR 识别、文件扫描、多格式文档转换、证件照生成全品类能力,一键配置,自动匹配最优处理方案。(建议优先安装此技能,如需求场景简单明确,也可安装对应的 OCR 识别、文件扫描、转 Office、证件照生成单个能力)
  • OCR 识别能力: 集合通用文档、手写文稿、表格表单、身份证证照等多类型文本识别能力,一键配置,自动选择最优识别能力。
  • 文件扫描能力: 集合普通文档、证件票据、合同卷宗等素材智能扫描增强能力,输出高清规整扫描件,一键配置,自动选择最优处理能力。
  • 转 Office 能力: 集成转 Word、转 Excel、转 PDF 三大格式转换能力,一键配置,自动选择最优解析转换能力。
  • 证件照生成能力: 依托大型模型视觉处理实现人像证件照标准化制作,支持人脸矫正、底色替换与画质精修,一键配置,自动选择最优生成能力。

选择您需要的 Skill 后,我们提供三种安装方式,您可以根据需要选择:

方案 1:通过对话发送 Prompt 直接安装:

  • 打开您需要安装的 Skill 说明页面。
  • 在页面右侧选择「我是 Agent」,然后点击「复制 Prompt」。
  • 打开 Agent 对话窗口,将复制的 Prompt 发送即可自动完成安装。

方案 2:下载 Skill 包,本地安装:

  • 打开您需要安装的 Skill 说明页面。
  • 在页面右侧选择「我是 Human」,然后点击下载 Skill 安装包。
  • 将其解压到对应 Agent 的 skills 目录(以 OpenClaw 为例,目录为 .openclaw/workspace/skills)。
  • 重启 Agent 或开启新会话即可使用。

方案 3:进入 ClawHub 一键安装:

  • 访问夸克扫描王 ClawHub页面。
  • 在页面中选择您需要的 Skill,按提示一键安装到您的 Agent。

3.​ ​登录开放平台,获取 API Key

  1. 在开放平台官网右上角点击【开发者后台】 按钮,通过手机号完成登录。

  2. 您可在开发者后台查看自己的 API Key 信息,接入 OpenClaw、QoderWork、Hermes 等主流 Agent 及 CLI、MCP,请使用 AI Agent 的 API Key,参照官方开发文档完成接口对接配置。

    密钥管理截图
  3. 点击 【复制】 按钮即可快速复制到剪贴板,将 API Key 通过对话发送给 OpenClaw 即可。

  4. 建议妥善保存,用于后续 API 调用的身份认证。

4.​ ​操作建议

  1. 建议在正式接入前,先阅读完整的开发文档,并参考代码示例进行测试。
  2. 如有疑问或需要技术支持,请联系我们的客服团队或通过平台提交工单。

备注:API Key 使用说明

  • API Key ID:用于标识您的应用或项目,不可修改。
  • API Key:用于身份鉴权,具有唯一性,请勿泄露。