接入 AI Agent

帧知提供标准化 Skill,兼容所有支持 SKILL.md 机制的 AI Agent(Claude Code、Codex、Hermes、OpenClaw 等)。 安装后即可在你的 Agent 对话中直接解析视频链接、查询知识库、基于视频内容问答。

两个技能
🎬framewise-video

提交视频链接解析为知识文档。在对话中发抖音/B站链接即可。

📚framewise-knowledge

查询知识库、阅读文档内容、基于视频内容问答。两个技能共用同一 API Key。

接入流程总览
下载安装 Skill配置帧知 API Key在 Agent 对话中使用

1下载并安装 Skill

仓库地址:https://github.com/zjc151/framewise-skills

克隆仓库

git clone https://github.com/zjc151/framewise-skills.git

复制所需技能到你的 Agent skills 目录

不同 Agent 的 skills 目录不同,按你使用的 Agent 选择对应路径:

AgentSkills 目录配置方式
Claude Code~/.claude/skills/环境变量 FRAMEWISE_API_KEY
Codex~/.codex/skills/环境变量 FRAMEWISE_API_KEY
OpenClaw~/.openclaw/skills/openclaw.json skills.entries
Hermes~/.hermes/skills/环境变量 FRAMEWISE_API_KEY
通用 / 其他~/.<agent>/skills/环境变量 FRAMEWISE_API_KEY
复制命令(按你的 Agent 选择对应行)
# Claude Code
cp -r framewise-skills/skills/framewise-video ~/.claude/skills/
cp -r framewise-skills/skills/framewise-knowledge ~/.claude/skills/

# Codex
cp -r framewise-skills/skills/framewise-video ~/.codex/skills/
cp -r framewise-skills/skills/framewise-knowledge ~/.codex/skills/

# OpenClaw
cp -r framewise-skills/skills/framewise-video ~/.openclaw/skills/
cp -r framewise-skills/skills/framewise-knowledge ~/.openclaw/skills/

# Hermes
cp -r framewise-skills/skills/framewise-video ~/.hermes/skills/
cp -r framewise-skills/skills/framewise-knowledge ~/.hermes/skills/

# 通用 / 其他
cp -r framewise-skills/skills/framewise-video ~/.<agent>/skills/
cp -r framewise-skills/skills/framewise-knowledge ~/.<agent>/skills/

复制完成后重启你的 Agent 网关或重新加载技能。

2配置帧知 API Key

先在 账户设置 -> API 密钥 生成一个 fw_ 开头的密钥(只显示一次)。

方式一:环境变量(通用,推荐)

适用于 Claude Code、Codex、Hermes 等所有通过环境变量注入密钥的 Agent:

# 在你的 Agent 运行环境中设置环境变量
export FRAMEWISE_API_KEY="fw_你的密钥"

方式二:openclaw.json(OpenClaw 专用)

如果你使用 OpenClaw,编辑 ~/.openclaw/openclaw.json,两个技能共用同一密钥:

{
  "skills": {
    "entries": {
      "framewise-video": {
        "enabled": true,
        "apiKey": "fw_你的密钥"
      },
      "framewise-knowledge": {
        "enabled": true,
        "apiKey": "fw_你的密钥"
      }
    }
  }
}

3在 Agent 对话中使用

视频解析

在你的 Agent 对话中发送一个视频链接(抖音/B站),Agent 会自动调用帧知解析并返回知识文档链接。

知识库查询

直接问 Agent 关于已解析视频的内容,例如「之前那个 Python 视频讲了什么」「知识库里有没有关于机器学习的内容」。 Agent 会自动搜索知识库并基于内容回答。

常见问题

  • 提示需要配置 API Key? 检查环境变量 FRAMEWISE_API_KEY 是否已设置,或 openclaw.json 中对应技能的 apiKey 是否已填写。
  • 返回 401 / Invalid API Key? 密钥填错或已撤销,到设置页重新生成。
  • 任务 failed? 常见原因:链接无法下载、视频时长超过账号等级限制、模型不可用。查看返回的 error_msg。
  • 知识库查询返回 429? 限流了,请稍后再试。问答接口限制最严(每用户 5次/分钟 + 每文档 3次/分钟)。
  • 如何卸载? 删除对应 Agent skills 目录下的 framewise-video/ 和 framewise-knowledge/。
  • 不支持我的 Agent? 只要你的 Agent 支持 SKILL.md 技能机制和 shell 脚本调用,就可以使用。技能脚本纯 curl 实现,零依赖。