Secure Google Drive Access for OpenClaw by PortEden

---

name: porteden-drive description: Secure Google Drive Mnagement - list, search, upload, create folders, rename, move, share, and permissions (porteden secure alternative). homepage: https://porteden.com metadata: {"openclaw":{"emoji":"📂","requires":{"bins":["porteden"],"env":["PE_API_KEY"]},"primaryEnv":"PE_API_KEY","install":[{"id":"brew","kind":"brew","formula":"porteden/tap/porteden","bins":["porteden"],"label":"Install porteden (brew)"},{"id":"go","kind":"go","module":"github.com/porteden/cli/cmd/porteden@latest","bins":["porteden"],"label":"Install porteden (go)"}]}}

---

porteden drive

Use porteden drive for Google Drive file and folder management. Use -jc flags for AI-optimized output.

If porteden is not installed: brew install porteden/tap/porteden (or go install github.com/porteden/cli/cmd/porteden@latest).

Setup (once)

Browser login (recommended): porteden auth login — opens browser, credentials stored in system keyring

Direct token: porteden auth login --token — stored in system keyring

Verify: porteden auth status

If PE_API_KEY is set in the environment, the CLI uses it automatically (no login needed).

Drive access requires a token with driveAccessEnabled: true and a connected Google account with Drive scopes.

Drive commands (porteden drive)

List files: porteden drive files -jc

Search by keyword: porteden drive files -q "budget report" -jc

Filter by folder: porteden drive files --folder google:0B7_FOLDER_ID -jc

Filter by MIME type: porteden drive files --mime-type application/pdf -jc

Filter by name: porteden drive files --name "Q1" -jc

Shared with me: porteden drive files --shared-with-me -jc

Modified in range: porteden drive files --modified-after 2026-01-01 --modified-before 2026-02-01 -jc

All files (auto-paginate): porteden drive files --all -jc

Get file metadata: porteden drive file google:FILEID -jc

Get view/download links: porteden drive download google:FILEID -jc

List permissions: porteden drive permissions google:FILEID -jc

Upload file: porteden drive upload --file ./report.pdf --name "Q1 Report.pdf"

Upload to folder: porteden drive upload --file ./data.csv --name "Data.csv" --folder google:0B7_FOLDER

Create folder: porteden drive mkdir --name "Project Files"

Create folder in folder: porteden drive mkdir --name "Reports" --parent google:0B7_FOLDER

Rename: porteden drive rename google:FILEID --name "New Name.pdf"

Move: porteden drive move google:FILEID --destination google:0B7_DEST_FOLDER

Share with user: porteden drive share google:FILEID --type user --role reader --email user@example.com

Share with domain: porteden drive share google:FILEID --type domain --role reader --domain example.com

Share publicly: porteden drive share google:FILEID --type anyone --role reader

Delete (trash): porteden drive delete google:FILEID (prompts) or porteden drive delete google:FILEID -y

Notes

Credentials persist in the system keyring after login. No repeated auth needed.

Set PE_PROFILE=work to avoid repeating --profile.

-jc is shorthand for --json --compact: strips noise, limits fields, reduces tokens for AI agents.

File IDs are always provider-prefixed (e.g., google:1BxiMVs0XRA5...). Pass them as-is.

porteden drive files --all auto-paginates (safety cap: 50 pages). Check hasMore in JSON output.

porteden drive download returns URLs only — no binary content is streamed.

accessInfo in responses describes active token restrictions. Always check it to understand what data may be limited.

authWarnings in list responses indicate provider connection issues.

delete moves to trash (reversible). Files can be restored from Google Drive trash.

Confirm before sharing or deleting files.

Environment variables: PE_API_KEY, PE_PROFILE, PE_FORMAT, PE_COLOR, PE_VERBOSE.

Credentials persist in the system keyring after login. No repeated auth needed.

Set PE_PROFILE=work to avoid repeating --profile.

-jc is shorthand for --json --compact: strips noise, limits fields, reduces tokens for AI agents.

File IDs are always provider-prefixed (e.g., google:1BxiMVs0XRA5...). Pass them as-is.

porteden drive files --all auto-paginates (safety cap: 50 pages). Check hasMore in JSON output.

porteden drive download returns URLs only — no binary content is streamed.

accessInfo in responses describes active token restrictions. Always check it to understand what data may be limited.

authWarnings in list responses indicate provider connection issues.

delete moves to trash (reversible). Files can be restored from Google Drive trash.

Confirm before sharing or deleting files.

Environment variables: PE_API_KEY, PE_PROFILE, PE_FORMAT, PE_COLOR, PE_VERBOSE.