How to Auto-Organize Google Drive with OpenClaw in Paradime
Feb 26, 2026
How to Auto-Organize Google Drive with Paradime, OpenClaw, and AI-Powered Workflows
Every data team has felt it: the creeping dread of clicking into a shared Google Drive folder only to find a graveyard of untitled documents, one-off exports, and meeting notes that nobody can locate when it actually matters. Stale docs linger for months without updates. Missing context turns a simple question—"Where's the Q3 revenue model?"—into a 20-minute Slack scavenger hunt. Tribal knowledge lives in one person's head, and when they're on PTO or leave the company, entire workflows grind to a halt.
The cost is real. Engineers waste hours manually filing documents. Analysts duplicate work because they can't find existing analyses. And leadership loses trust in data assets they can't even locate.
This guide shows you how to build an automated workflow that achieves near-100% document coverage in your Google Drive by combining Paradime for dbt™ pipeline orchestration, OpenClaw as an autonomous AI agent, and the Google Drive API for programmatic file management. By the end, you'll have a daily cron job that scans your root and inbox folders, classifies unfiled documents by content and name, and moves them into the appropriate project folders—all without manual intervention.
Figure 1: End-to-end workflow — from messy Drive to organized, monitored project folders.
What Is Paradime?
Paradime is an AI-native platform for data engineering that replaces dbt Cloud™. Think of it as Cursor for Data—teams use Paradime to code, ship, fix, and scale data pipelines for analytics and AI.
The three pillars of Paradime are:
Feature | What It Does |
|---|---|
Code IDE | AI-native IDE for dbt™ and Python with DinoAI copilot. Cuts dbt™ development time by 83%+. |
Bolt | Production scheduler and CI/CD for dbt™ pipelines. Includes TurboCI, schedule-as-code (YAML), cron triggers, and AI-powered debugging with DinoAI. |
Radar | FinOps dashboard that reduces Snowflake and BigQuery costs by identifying wasteful queries and credit consumption. |
For this workflow, Bolt is the star. It provides the cron scheduling engine that triggers our document-organization pipeline on a daily cadence, complete with monitoring, alerting, and run-history analytics.
Schedules in Bolt are defined as code in a paradime_schedules.yml file:
What Is OpenClaw?
OpenClaw (formerly Clawdbot and Moltbot) is a free and open-source autonomous AI agent developed by Peter Steinberger. Unlike a typical chatbot, OpenClaw is a local orchestration layer that gives large language models "eyes, ears, and hands"—it can read files, run shell commands, browse the web, and interact with APIs on your behalf.
Key characteristics:
Runs locally on your machine (macOS, Linux, Windows with Node.js ≥ 22)
Connects to any LLM (Claude, GPT, DeepSeek) via API keys
Persistent memory across sessions via a
memory/folder and SQLiteExtensible skills system using Markdown-based
SKILL.mdfilesBuilt-in cron scheduler for recurring automations
Multi-channel delivery via Telegram, Slack, Discord, WhatsApp
Figure 2: OpenClaw's agent runtime flow — messages enter through the Gateway, context is loaded from workspace files and memory, the LLM decides on actions, and tools execute them in a loop.
For our use case, OpenClaw serves as the intelligent classifier. It reads document names and content, determines which project folder each belongs to, and executes the Google Drive API calls to move files.
Setup: OpenClaw + Google Drive API
Prerequisites
Node.js 22+ installed (
node --version)OpenClaw installed globally:
npm install -g openclawA Google Cloud project with the Drive API enabled
A Google Service Account with a JSON key file
An LLM API key (Anthropic Claude recommended)
Step 1: Google Cloud Service Account
Go to the Google Cloud Console.
Create a new project or select an existing one.
Enable the Google Drive API under APIs & Services → Library.
Navigate to IAM & Admin → Service Accounts and create a new service account.
Grant the service account Editor access to the Google Drive folders you want to organize.
Generate a JSON key and download it.
Share your target Google Drive folders with the service account's email address (e.g.,
drive-organizer@your-project.iam.gserviceaccount.com).
Step 2: Environment Variables
Store your credentials as environment variables—never hard-code them into workspace files or config.
OpenClaw loads environment variables from multiple sources with a "never override existing values" rule. The precedence order is:
Process environment (parent shell)
.envin current working directoryGlobal
.envat~/.openclaw/.envConfig
envblock in~/.openclaw/openclaw.json
For production deployments, use OpenClaw's SecretRef system for enterprise-grade secrets management:
Audit your secrets configuration anytime with:
Step 3: Install the Google Workspace CLI
Google has published a unified CLI for Workspace services. Install it alongside OpenClaw:
This gives OpenClaw access to commands like gwc-drive list, gwc-drive move, and gwc-drive search.
Step 4: Initialize the OpenClaw Workspace
Create a dedicated workspace for the Drive organizer agent:
This scaffolds the core workspace files: SOUL.md, AGENTS.md, TOOLS.md, and optionally HEARTBEAT.md.
Script: Scan, Classify, and Move Unfiled Documents
The heart of this workflow is the OpenClaw skill that scans your root/inbox folder, classifies each document, and moves it to the correct project folder.
Figure 3: The scan-classify-move sequence — OpenClaw orchestrates the entire flow, using the LLM for classification decisions and the Google Drive API for file operations.
SOUL.md — Agent Behavior Rules
TOOLS.md — Allowed Operations
SKILL.md — The File Organizer Skill
Create the skill at ~/.openclaw/skills/drive-organizer/SKILL.md:
Example Classification Script
Here is a Node.js helper script that OpenClaw can invoke to interact with the Google Drive API programmatically:
Environment Variables Reference
Variable | Description | Required |
|---|---|---|
| Path to Google service account JSON key file | ✅ |
| Your LLM provider API key (e.g., Anthropic) | ✅ |
| Google Drive folder ID for the inbox/root to scan | ✅ |
| JSON mapping of categories to Drive folder IDs | Optional |
| Logging verbosity ( | Optional |
| Override default state directory ( | Optional |
Set these in your ~/.openclaw/.env file:
Bolt Schedule: Daily Cron
With Paradime Bolt, you define the schedule in your paradime_schedules.yml file. This schedule triggers a dbt™ model that invokes the OpenClaw agent:
Alternatively, if you want the scheduling to live entirely within OpenClaw, use OpenClaw's built-in cron system:
Figure 4: Two scheduling options — Paradime Bolt for teams already using dbt™ pipelines, or OpenClaw's native cron for standalone deployments.
Choosing Between Bolt and OpenClaw Cron
Consideration | Paradime Bolt | OpenClaw Cron |
|---|---|---|
Best for | Teams already using dbt™ and Paradime | Standalone personal/team automation |
Monitoring | Full run history, DinoAI debugging, SLA alerts | Delivery to chat channels, run logs |
CI/CD integration | TurboCI, merge triggers, deferred schedules | Manual or HEARTBEAT.md-based |
Cost visibility | Radar for warehouse cost tracking | N/A |
Config format | YAML ( | CLI commands or JSON ( |
Monitoring and Debugging
Paradime Bolt Monitoring
Once your schedule is running in Bolt, you get a comprehensive monitoring suite out of the box:
Schedules Overview — The Bolt home screen shows all configured schedules with status, last run, next run, and SLA compliance.
Run History — Click into any schedule to see every execution with status, trigger type (manual/automatic), branch, commit, duration, and Run ID.
Three-Tier Logs:
Artifacts — Every run generates
manifest.json,run_results.json, and compiled SQL files for post-mortem analysis.SLA Alerts — Configure
sla_minutesin your schedule YAML to get notified when a run exceeds its time budget.
OpenClaw Monitoring
For the OpenClaw agent side, monitoring happens through logs and diagnostics:
Enable debug logging for deeper inspection:
Use the /debug command in chat (when commands.debug: true in config) to inspect agent state in real time:
Combining Both
The ideal setup uses Bolt for pipeline-level monitoring and OpenClaw's delivery system for real-time notifications. The OpenClaw agent sends a summary digest to Slack or Telegram after each run, while Bolt tracks the broader health of the entire schedule.
Figure 5: Dual monitoring stack — Bolt provides dashboard-level visibility, while OpenClaw delivers real-time digests and detailed agent logs.
Troubleshooting Common Issues
Google Drive API Errors
Error | Cause | Fix |
|---|---|---|
| Service account doesn't have access to the folder | Share the folder with the service account email in Google Drive |
| Wrong folder ID or file was already moved/deleted | Double-check |
| Too many API calls in a short window | Add delays between requests; reduce |
| Invalid or expired service account key | Regenerate the JSON key and update |
File not moving | File has multiple parents | Use |
OpenClaw Agent Issues
Issue | Cause | Fix |
|---|---|---|
| npm global bin not in PATH |
|
Gateway won't start | Port 18789 already in use |
|
Agent ignores SOUL.md rules | Context window overflow / compaction | Keep SOUL.md concise; use |
Cron job runs but no output | Delivery channel misconfigured | Check |
| API key issue or rate limiting | 401 = wrong key; 403 = no model access; 429 = rate limited |
Memory loss between sessions | Gateway restart clears in-session history | Save important state to |
Corrupt | Manual editing introduced syntax errors | Validate with |
Bolt Schedule Issues
Issue | Cause | Fix |
|---|---|---|
Schedule not appearing |
| Merge to |
Schedule runs but dbt™ fails | Missing environment variables in scheduler | Configure variables under Scheduler Environment |
SLA alerts firing constantly |
| Analyze run duration trends in Bolt analytics; increase SLA buffer |
Notifications not sending | Slack/email integration not configured | Check workspace notification settings in Paradime |
Diagnostic Flowchart
Figure 6: Diagnostic decision tree for troubleshooting failed runs across both Bolt and OpenClaw.
Wrapping Up
The painful reality of stale documentation, missing context, and tribal knowledge isn't going to fix itself. Every day you leave documents unfiled in Google Drive, you're adding to the cognitive tax your team pays every time someone needs to find something.
By combining Paradime for orchestration and monitoring, OpenClaw as an intelligent classification agent, and the Google Drive API for programmatic file management, you build a system that:
Scans daily — No document sits unfiled for more than 24 hours
Classifies intelligently — LLM-powered classification handles ambiguous filenames and varied content formats
Moves with confidence — Only files with ≥80% classification confidence are auto-filed; the rest go to a review queue
Monitors itself — Bolt dashboards and OpenClaw digests give you full visibility into every run
Scales with your team — Add new project folders and classification rules without changing the core workflow
The result? Near-100% document coverage—every file has a home, every team member can find what they need, and no one has to spend another Friday afternoon playing document detective.
Quick Start Checklist
Create a Google Cloud service account and enable the Drive API
Install OpenClaw (
npm install -g openclaw) and initialize workspaceConfigure
SOUL.md,TOOLS.md, and thedrive-organizerskillSet environment variables (
GOOGLE_CREDENTIALS_JSON,OPENCLAW_API_KEY)Test manually with
openclaw cron run <jobId>Add Bolt schedule to
paradime_schedules.ymlor useopenclaw cron addConfigure Slack/Telegram notifications for daily digests
Monitor via Bolt dashboard and OpenClaw logs

