onedrive-integration

目标

当用户在 Telegram/WhatsApp 等不便于粘贴长内容的场景中需要获取一份完整文档或大文件时，将该文件（们）复制到 OneDrive，以便用户直接在 OneDrive 中打开或分享。

前提条件

command -v python3
python3 --version

配置（便携式）

机器特定的配置文件与技能代码存放于同一目录下：

• 示例（请勿编辑）：~/.openclaw/skills/onedrive-integration/config.env.example
• 实际使用（机器专属）：~/.openclaw/skills/onedrive-integration/config.env

支持的配置项：

• ONEDRIVE_ROOT（必需）——例如：/mnt/c/Users//OneDrive
• ONEDRIVE_SUBDIR（可选）——默认值为 openclaw

若配置缺失或未设置，请不要自行猜测，而应主动向 Boss 确认正确的 OneDrive 根目录路径，并据此创建/写入 config.env 文件。

初始化 / 安装 / 入门流程

推荐方式（以聊天为先）

由于主要交互界面是聊天（Telegram），推荐的入门流程如下：

1. 请 Boss 确认正确的 OneDrive 根目录路径；
2. 创建真实的配置文件：config.env；
3. 执行一次简易冒烟测试（smoke test），例如复制一个小型临时文件验证功能是否正常。

可选方式（终端交互式）

若您正在真实终端中运行，可使用交互式入门脚本：

~/.openclaw/skills/onedrive-integration/scripts/onboard.sh

工作原理

将用户请求的文件（们）复制到以下路径：

• ${ONEDRIVE_ROOT}/${ONEDRIVE_SUBDIR}/（默认子目录为 openclaw/）

复制过程中会对文件重命名，以包含其原始路径信息，避免同名冲突。

重命名规则

• 将绝对路径转换为安全的文件名：
  • 去除开头的 /
  • 将路径分隔符（/ 和 \）统一替换为 -
  • 全部转为小写
  • 将所有非 [a-z0-9._-] 字符替换为 -
  • 合并连续多个 - 为单个 -

示例：

• /home/miles/folder1/file1.md → wsl-home-miles-folder1-file1.md
• /mnt/c/Users//folder1/file1.md → c-users--folder1-file1.md

实现细节

主程序（规范可执行文件）位于技能目录内：

• ~/.openclaw/skills/onedrive-integration/scripts/copy_to_onedrive.py

运行方式：

~/.openclaw/skills/onedrive-integration/scripts/copy_to_onedrive.py 

（脚本会自动读取 config.env）

可选参数覆盖方式：

• .../copy_to_onedrive.py --onedrive-root "..." --subdir "..."
• .../copy_to_onedrive.py --config /path/to/config.env

该脚本会：

• 如目标目录 ${ONEDRIVE_ROOT}/${ONEDRIVE_SUBDIR}/ 不存在，则自动创建
• 复制文件（保留原始时间戳）
• 输出目标路径（不输出任何敏感信息）

注意事项

• 若请求的是仅存在于浏览器中的文档（无本地对应文件），需先将其下载至临时路径，再执行复制操作。
• 若 ONEDRIVE_ROOT 未设置，请不要自行猜测，务必请求确认。

可执行文件 / bin 目录部署

• 主脚本应保留在技能目录内。
• 可选：软链接至常用 PATH 目录（仅当您希望使用简短命令时）：

mkdir -p ~/.local/bin
ln -sf ~/.openclaw/skills/onedrive-integration/scripts/copy_to_onedrive.py ~/.local/bin/copy-to-onedrive