进阶 / 08

08. Agent 接入（AI 工具联动）

预计耗时：15 分钟配置 | 适用：Claude Code、Cursor、OpenClaw 等支持 MCP 的 AI 工具

这是什么

DouFlow 桌面客户端在本机提供 Agent API（默认 http://127.0.0.1:38767），让 AI 助手代替你执行：

  • 下载抖音视频
  • 提取字幕
  • 采集博主数据
  • 准备各平台发布草稿
  • 一键成片（成本型生成需足够积分）

适合「用自然语言让 AI 操作 DouFlow」的高阶用户。

订阅与积分：各有效订阅档位的 Agent 功能范围相同。Agent 中的下载、字幕或本地操作按对应独立额度执行；数字人、AI 画面等成本型任务使用订阅或体验积分。

前置条件

  1. DouFlow 桌面客户端已打开且已登录
  2. 设置 → Agent / Skills 接入 中开启 「Agent 侦听」
  3. 勾选需要开放的 Skill（下载、字幕、采集、发布、成片等）
  4. 本机已安装 Node.js 18+

配置步骤

1. 开启侦听

  1. 打开 设置 → Agent / Skills 接入
  2. 打开 Agent 侦听 开关
  3. 按需勾选 Skill

Agent 接入设置

2. 复制 MCP 配置

在同一页面点击 「复制 MCP 配置」，粘贴到你的 AI 工具 MCP 设置中，例如：

  • Cursor → Settings → MCP
  • Claude Code → MCP 配置
  • OpenClaw → mcp.json

MCP 使用 DouFlow 内置脚本，会自动读取本机 agent_config.json，无需手动填写 Token。

3. 复制 Skill 说明给 AI

点击 「复制给 AI 的 Skill 说明」，发送给 AI 助手，让其安装 douflow-agent Skill（持久化到 skills 目录）。

仓库内模板：docs/agent-integration/douflow-agent.SKILL.md

4. 自检

让 AI 依次调用：

  1. douflow_health_check — 确认 agent_enabled=true
  2. douflow_list_skills — 确认目标 Skill 已启用

常用能力示例

下载视频

请用 DouFlow 下载这个抖音链接：https://v.douyin.com/xxxx/

提取字幕

请提取这条视频的字幕并告诉我文本内容

发布草稿（需扫码）

请把这个 MP4 上传到抖音草稿，标题是 xxx

若返回 waiting_user，需你在 电脑 Chrome 中扫码确认。

一键成片（成本型生成）

请用 DouFlow 把这个链接做成数字人口播成片

会按实际配置校验积分和服务端报价；超时可能较长（建议 15 分钟以内等待）。如返回余额或报价错误，请在客户端中核对当前配置后再提交。

错误码速查

错误含义
agent_disabled未开启 Agent 侦听
auth_required未登录或 Token 无效
skill_disabled该 Skill 未勾选
subscription_required当前账号订阅无效；若账户有可用体验积分，成本型任务仍应按对应入口的报价流程校验
insufficient_credits创作积分不足；本地编辑和预览不受影响
quote_expired报价过期或配置已改变，需重新获取报价
quota_exceeded字幕免费额度用尽
waiting_user需浏览器扫码/确认
automation_in_progress已有任务在运行

完整说明见 docs/agent-integration/README.md。

安全说明

  • Agent 仅监听 127.0.0.1，外网无法直接访问（除非自行做隧道）
  • 发布类 Skill 默认准备发布页或草稿；如调用中显式要求自动提交，仍应先人工核对账号、内容与平台状态
  • 勿将 MCP 配置中的本机路径或 Token 提交到公开仓库

下一篇

→ 10-故障排查
→ 03-路径A-一键成片