/install solo-file-transfer
file-transfer 📤
docx→md + IMA上传。二合一。
模块 A：docx → Markdown
将Word文档(.docx)转换为Markdown格式，提取图片。
import sys
sys.path.insert(0, '\x3Cskill_dir>/scripts')
from docx_to_md import docx_to_md
docx_to_md('文件.docx', '输出目录')
转换规则： 标题(#)→列表(-/1.)→表格→图片(![])
模块 B：IMA知识库上传
向指定知识库上传文件，完整流程：check_repeated_names → create_media → COS上传 → add_knowledge。
SKILL_DIR=\x3Cskill_dir>
OPTS=$(printf '{"clientId":"%s","apiKey":"***"}' "$IMA_OPENAPI_CLIENTID" "$IMA_OPENAPI_APIKEY")
node "$SKILL_DIR/scripts/ima_api.cjs" "\x3Capi_path>" '\x3Cjson_body>' "$OPTS"
核心API路径：
| 操作 | api_path | 关键参数 |
|---|---|---|
| 搜索知识库 | openapi/wiki/v1/search_knowledge_base |
query, cursor |
| 获取知识库信息 | openapi/wiki/v1/get_knowledge_base |
ids |
| 创建媒体 | openapi/wiki/v1/create_media |
file_name, file_size, knowledge_base_id |
| COS上传 | scripts/cos-upload.cjs |
--file --secret-id --secret-key --token --bucket --region --cos-key |
| 添加知识 | openapi/wiki/v1/add_knowledge |
media_type, media_id, title, knowledge_base_id |
| 添加网页 | openapi/wiki/v1/import_urls |
urls, knowledge_base_id |
| 浏览知识库 | openapi/wiki/v1/get_knowledge_list |
knowledge_base_id, cursor |
上传文件流程：
check_repeated_names— 检查重名create_media— 获取上传凭证scripts/cos-upload.cjs— COS上传 ⚠️ 非零退出=停止add_knowledge— 添加知识 ⚠️ title必须等于file_name
模块 C：链式操作
docx → md → IMA上传一体：
① docx_to_md.py 转换 → 得到 .md + images/
② ima_api.cjs create_media → COS upload → add_knowledge
③ 返回知识库链接
依赖
- Python 3.7+, python-docx
- Node.js（ima_api.cjs）
- 环境变量:
IMA_OPENAPI_CLIENTID,IMA_OPENAPI_APIKEY
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install solo-file-transfer - After installation, invoke the skill by name or use
/solo-file-transfer - Provide required inputs per the skill's parameter spec and get structured output
What is Solo File Transfer?
文件传输技能 — 合并docx-to-md + ima-knowledge-upload。 (1) Word文档(.docx)转Markdown并提取图片 (2) 上传文件/网页/笔记到IMA知识库 (3) 链式操作：docx→md→IMA一键上传 Use when: 用户需要文档格式转换、文件上传到知识库、Wo... It is an AI Agent Skill for Claude Code / OpenClaw, with 37 downloads so far.
How do I install Solo File Transfer?
Run "/install solo-file-transfer" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Solo File Transfer free?
Yes, Solo File Transfer is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Solo File Transfer support?
Solo File Transfer is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Solo File Transfer?
It is built and maintained by Meta-Evo (@meta-evo-creator); the current version is v1.0.0.