onedrive-integration

Goal

When the user needs a full document / long file in Telegram/WhatsApp (where pasting is awkward), copy the file(s) into OneDrive so the user can open/share from there.

Prerequisites

command -v python3
python3 --version

Configuration (portable)

Machine-specific config lives alongside the skill:

• Example (do not edit): ~/.openclaw/skills/onedrive-integration/config.env.example
• Real (machine-specific): ~/.openclaw/skills/onedrive-integration/config.env

Keys:

• ONEDRIVE_ROOT (required) — e.g. /mnt/c/Users//OneDrive
• ONEDRIVE_SUBDIR (optional) — default openclaw

If config is missing/unset, do not guess—ask Boss to confirm the correct OneDrive folder, then write config.env.

Initialization / installation / onboarding

Preferred (chat-first)

Because the primary interface is chat (Telegram), the preferred onboarding flow is:

1. Ask Boss to confirm the correct OneDrive root folder.
2. Write the real config file: config.env.
3. Run a smoke test by copying a small temp file.

Optional (terminal)

If you are running in a real terminal, you can use the interactive onboarding script:

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

How it works

Copy requested file(s) into:

• ${ONEDRIVE_ROOT}/${ONEDRIVE_SUBDIR}/ (defaults to openclaw/)

During copy, rename files to include their source path to avoid collisions.

Rename rules

• Convert absolute path into a safe filename:
• strip leading /
• replace path separators (/ and \\) with -
• lowercase
• replace any non [a-z0-9._-] with -
• collapse multiple -

Examples:

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

Implementation

Canonical executable lives inside the skill folder:

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

Run:

~/.openclaw/skills/onedrive-integration/scripts/copy_to_onedrive.py <paths...>

(Reads config.env automatically.)

Optional overrides:

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

The script:

• creates ${ONEDRIVE_ROOT}/${ONEDRIVE_SUBDIR}/ if missing
• copies files (preserve timestamps)
• prints the destination paths (no secrets)

Notes

• If the request is a browser-only document (no local file), download it to a temp path first, then copy.
• If ONEDRIVE_ROOT is unset, do not guess—ask for confirmation.

Executables / bin placement

• Keep the canonical script inside the skill folder.
• Optional: symlink into a common PATH dir (only if you want a short command):

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