接入 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 选择对应路径:
| Agent | Skills 目录 | 配置方式 |
|---|---|---|
| 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 实现,零依赖。