ocft：通过消息通道在智能体之间进行 P2P 文件传输

git · 2026-02-09 09:36:27 · 3 次点击 · 0 条评论

名称： ocft
描述： 通过消息通道在 AI 代理之间进行 P2P 文件传输。支持分块传输、大文件 IPFS 回退以及可信节点管理。
主页： https://github.com/stormixus/ocft

OCFT - OpenClaw 文件传输协议

通过消息通道在 AI 代理之间进行点对点文件传输。

使用场景

在以下情况下使用此技能：
- 通过聊天通道在 AI 代理之间传输文件
- 与可信代理建立点对点文件共享
- 通过 Telegram、Discord、Slack 或任何基于文本的通道发送文件
- 需要带有完整性验证的分块传输
- 使用 IPFS 回退传输大文件

安装

npm install -g ocft

快速开始

# 初始化你的节点（生成唯一 ID 和密钥）
ocft init

# 查看节点状态
ocft status

# 导出连接信息以与对等节点共享
ocft export

# 添加一个可信对等节点
ocft add-peer <nodeId> <secret> --name "朋友"

# 或者从 URI 导入
ocft import ocft://eyJub2RlSWQ...

CLI 命令

核心命令

命令	描述
`ocft init`	使用唯一 ID 和密钥初始化节点
`ocft status`	显示节点状态和配置
`ocft show-secret`	显示完整密钥（小心！）
`ocft export`	以 URI 格式导出连接信息
`ocft import <uri>`	从 ocft:// URI 导入对等节点
`ocft verify <secret>`	验证密钥是否与你的匹配

节点管理

命令	描述
`ocft add-peer <id> <secret>`	添加可信对等节点
`ocft remove-peer <id>`	移除可信对等节点
`ocft list-peers`	列出所有可信对等节点
`ocft extend-peer <nodeId> <hours>`	延长对等节点的信任有效期
`ocft set-ttl <hours>`	设置默认密钥生存时间（0 = 永不过期）

配置

命令	描述
`ocft set-download <dir>`	设置下载目录
`ocft set-max-size <size>`	设置最大文件大小（例如 `100MB`、`1GB`）

IPFS 回退（用于大文件）

命令	描述
`ocft ipfs-enable`	为大文件启用 IPFS 回退
`ocft ipfs-disable`	禁用 IPFS 回退
`ocft set-ipfs-provider <provider>`	设置提供商：`pinata`、`filebase`、`kubo`
`ocft set-ipfs-key <key>`	设置 IPFS API 密钥
`ocft set-kubo-url <url>`	设置 Kubo 节点 API URL
`ocft set-ipfs-threshold <size>`	使用 IPFS 的大小阈值（例如 `50MB`）
`ocft set-ipfs-gateway <url>`	设置自定义公共 IPFS 网关

特性

🔗 基于消息：通过现有聊天通道传输文件
📦 分块传输：将大文件分割成小块（48KB 块）
✅ 完整性验证：对块和文件使用 SHA-256 哈希
🤝 请求/接受：显式接受或自动接受策略
🔒 安全性：带有密钥的可信节点白名单
⏰ 密钥生存时间：设置信任关系的过期时间
🔄 断点续传：从最后一个块恢复中断的传输
🌐 IPFS 回退：对超过分块阈值的文件使用 IPFS

协议

OCFT 消息使用 🔗OCFT: 前缀和 Base64 编码的 JSON，允许通过任何基于文本的通道进行文件传输。

限制

块大小：48KB（适合 Base64 编码在消息中）
默认最大文件大小：100MB（可通过 set-max-size 配置）
专为基于文本的通道设计
IPFS 回退需要提供商设置（Pinata、Filebase 或本地 Kubo）

链接

GitHub: https://github.com/stormixus/ocft
npm: https://www.npmjs.com/package/ocft

技能包地址：https://github.com/openclaw/skills/tree/main/skills/stormixus/ocft/SKILL.md

3 次点击 ∙ 0 人收藏

登录后收藏

目前尚无回复

0 条回复