📄 File-Transfer 安装指南

共 14 页 · 手把手教你配置双向文件传输

01
JEFFCLAW 技能分享 · File-Transfer
🧰

File-Transfer

双向文件传输技能

让 AI 与你的电脑之间，轻松互传文件
（以本机是 MacOS 为例）

Cloud2Local Local2Cloud 零门槛 完全自托管
02
为什么要用 File-Transfer？
❌ 没有它的时候
  • AI 生成了报告，想保存到本地？手动下载！
  • 本地有个文档想让 AI 分析？上传！
  • Mac 没有公网 IP，外网无法直连？麻烦！
  • 用微信文件传输助手？文件混杂不好找！
  • 发邮件？还要打开邮箱，效率低！
✅ 有了它之后
  • "帮我把这份报告发到我的 Mac" → AI 直接推送！
  • "把这个本地文件传到云端" → 一条指令搞定！
  • 即使 Mac 没有公网 IP，SSH 反向隧道照样通！
  • 文件直达桌面 ClawShare 目录，井井有条！
  • 完全自托管，数据不经过任何第三方！
03
它的运作架构是什么？
↑ [上传至云端] ↓ 公网直传 SCP
[你的云端 Claw AI]
Cloud2Local
AI → Mac（隧道推送）
Local2Cloud
Mac → AI（公网直传）
🐔 你的 Mac
SSH 反向隧道 :19999
☁️ 云服务器
Claw AI 所在地
⚠️ 注意：Local2Cloud 不需要隧道，走公网 IP 直接传；只有 AI 主动推送时才需要隧道。
04
安装前 — 需要准备什么？
类型说明示例来源
云服务器 IP云服务器公网 IP 地址150.xx.xx.123云服务器控制台查看
云服务器用户名登录云服务器的用户名root通常为 root
Mac 用户名你的 Mac 登录用户名zwmac终端执行 whoami
云服务器 root 密码用于首次 SCP 传输文件CloudMachPSW云服务器购买时的密码
💡 建议提前把这些信息整理好，安装过程会非常顺畅。如果不确定某个参数，打开终端输入对应命令即可查询。
05
第一步：本机 Mac 应该做什么？
📁 创建 ClawShare 目录

打开 Mac 终端，执行：

mkdir -p ~/Desktop/ClawShare

这个目录专门用来存放你和 AI 传输的文件

🔐 开启远程登录

系统设置 → 通用 → 共享 → 远程登录

  • ① 开启"远程登录"
  • ② 选择"仅这些用户"
  • ③ 添加你的 Mac 用户名

这一步是让云服务器能主动连接你的 Mac

⚠️ 两步都必须完成！AI 给你本机发送文件时，如果没有 ClawShare 目录，AI 会把文件直接放到桌面。
06
第二步：安装 File-Transfer 技能
1
把安装包传到云服务器

在 Mac 终端执行：

scp -o StrictHostKeyChecking=no ~/Desktop/ClawShare/File-Transfer_v1.0.0.tar.gz root@你的云服务器IP:~/
2
在云服务器解压安装
cd /root/.openclaw/workspace/skills && tar -xzf ~/File-Transfer_v1.0.0.tar.gz

确认：ls /root/.openclaw/workspace/skills/File-Transfer/ 能看到 SKILL.md 即成功

3
重启 AI
openclaw gateway restart

重启后告知 AI "我已经准备好了" 即可开始使用

07
第三步：配置 SSH 密钥（一次性）
🔑 密钥是什么？为什么比密码好？
  • 密钥是一串加密字符串，相当于一把"电子钥匙"
  • 配好之后，传输文件不再需要输入密码
  • 密钥无法被暴力猜解，比密码安全得多
  • 一次配置，长期有效，不需要反复更换
⚙️ 具体操作步骤
①
在云服务器生成密钥对
ssh-keygen -t ed25519 -f ~/.ssh/server_mac_key -N ""
②
查看云服务器公钥
cat ~/.ssh/server_mac_key.pub
③
把公钥添加到 Mac
echo "公钥内容" >> ~/.ssh/authorized_keys
⚠️ 这一步只需要做一次，以后一直有效！
08
第四步：建立 SSH 反向隧道
🔗 什么是反向隧道？

正常情况下：电脑主动连接服务器。
反向隧道：让服务器能够主动连接到你的 Mac，从而把文件推送给你。即使你的 Mac 没有公网 IP，隧道也能工作！

⚠️ 这个终端窗口必须一直保持开着，窗口关闭 = 隧道断开 = 无法接收文件。
⌨️ 建立隧道（Mac 终端执行）
ssh -N -R 19999:localhost:22 root@你的云服务器IP

提示密码时输入你的 Mac 登录密码（不是云服务器密码）。

✅ 隧道建立后，告诉 AI："我已经建立好隧道了"
⚠️ Mac 重启、睡眠、关机后，隧道会自动断开，需要重新执行这条命令。
09
第五步：安装完毕，如何测试？
⬆️ 测试一：本地文件 → 云服务器

对 AI 说：

"帮我把这个文件传到云端：~/Desktop/test.txt"

在 Mac 终端执行 AI 给的指令后告诉 AI "好了"，AI 验证文件是否到达。

✅ 验证：ls ~/ClawShare/ 能看到文件即为成功
⬇️ 测试二：AI 生成 → 推送到 Mac

先确保 Mac 终端隧道命令窗口开着，然后对 AI 说：

"生成一份今日科技新闻汇总，发到我的 Mac"

AI 会自动完成：创建目录 → 推送文件 → 告知存放位置

✅ 验证：Finder → 桌面 → ClawShare 目录查看
10
使用起来安全吗？
🔐 远程登录是受控的

只有你自己 Mac 上的指定用户可以登录，没有授权的人无法访问。

🗝️ 密钥更安全

SSH 密钥使用 256 位加密，无法被暴力猜解。

🔒 传输全程加密

SSH 隧道和 SCP 传输全程加密，任何网络窃听者都无法获取文件内容。

✅ 完全自托管，数据不经过任何第三方服务器，隐私完全自己掌控。
⚠️ 密钥文件 ~/.ssh/server_mac_key 相当于你的密码，请妥善保管，不要随意分享。
11
使用限制与注意事项
⚠️ 使用注意事项
  • 隧：Mac 重启、睡眠、关机后需重新建立
  • 文：优先放 ClawShare 目录；不存在则放桌面
  • 传：建议单文件不超过 100MB
  • 大：超过 100MB 建议压缩后再传
  • 断：SCP 不支持断点续传，中断后需重传
🎯 最佳实践
  • 把隧道命令窗口放到不显眼的位置，保持开机运行
  • Mac 睡眠前/重启后，记得重新建立隧道
  • 定期清理 ClawShare 目录，避免文件堆积
  • 如果隧道断了，AI 会提示你，重新执行隧道命令即可
💡 对于日常小文件传输，体验非常流畅——说一句话，文件就到桌面了。
12
常见问题与处理
报错信息原因解决办法
Connection refusedSSH 隧道断了重新在 Mac 终端执行隧道命令
Permission denied (publickey)Mac 上没有正确添加云服务器公钥检查 ~/.ssh/authorized_keys 是否包含云服务器公钥
Connection reset by peerMac 上的"远程登录"被关闭了重新在系统设置 → 共享里开启"远程登录"
No such file or directory云服务器上没有 ClawShare 目录告诉 AI "帮我创建 ~/ClawShare 目录"
remote port forwarding failed云服务器未开启 GatewayPorts在 /etc/ssh/sshd_config 加入 GatewayPorts yes 后重启 sshd
SCP 大文件卡住不动之前 SCP 进程卡在端口 19999在云服务器执行：kill -9 $(fuser 19999/tcp 2>/dev/null)
13
File-Transfer 与其他方式对比
产品传输方式对方是否需安装数据托管方适合场景
File-Transfer（我们）SSH 反向隧道 + SCPMac 需开启远程登录完全自托管，无第三方日常使用，隐私敏感场景
Perkoon-transferP2P 直连（WebRTC）只需浏览器链接P2P 直连，可选 Perkoon 中转临时分享给任意人，零门槛
OCFTAI 间 P2P 文件传输AI 对 AIP2P / IPFS两个 AI 代理之间互传
微信文件传输助手微信服务器中转微信即可腾讯服务器临时用，但文件混杂
云盘直链分享云盘服务器存储链接即可云盘服务商大文件、长期分享
💡 临时对外分享推荐 Perkoon-transfer，零门槛，浏览器打开链接即可下载。
14
File-Transfer · 让 AI 与你的电脑，随心所欲
🧰

File-Transfer

让 AI 与你的电脑之间，随心所欲互传文件

2
条 SCP 指令走完整个流程
0
第三方数据经过
∞
密钥长期有效无需更换
零门槛 完全自托管 Cloud2Local Local2Cloud
© 2026 Jeff · itonline.cloud · File-Transfer v1.0.0