workflowy

What This Skill Does

The workflowy skill provides a robust interface for interacting with the popular Workflowy outliner tool directly through a command-line environment. It acts as an integration layer between your OpenClaw agent and your personal outline, allowing the agent to perform granular operations like searching for specific notes, creating new tasks, restructuring subtrees, or generating analytics on your data. By abstracting the complex Workflowy API into simple command-line calls, it enables automation of your note-taking and task management workflows, such as moving completed tasks or bulk-renaming projects.

Installation

To begin, ensure you have the workflowy CLI utility installed. Obtain your API key from the Workflowy settings page at https://workflowy.com/api-key/. Once obtained, initialize the configuration directory and save your credentials using the following commands:

1. mkdir -p ~/.workflowy
2. echo "your-api-key-here" > ~/.workflowy/api.key

After setting up the credentials, you can install the skill via the OpenClaw hub: clawhub install openclaw/skills/skills/waldyrious/workflowy.

Use Cases

This skill is designed for power users who want to treat their notes as data. Use cases include:

• Automated Task Capture: Pipe new tasks directly into your Workflowy inbox from other system processes.
• Refactoring: Utilize bulk replace commands to update naming conventions or fix broken links throughout your entire tree.
• Content Audits: Generate reports on which nodes contain the most data or identify stale content that hasn't been modified in a long time.
• Quick Retrieval: Use the agent to search for specific deep-nested items without manually navigating the web interface.

Example Prompts

1. "Check my inbox in Workflowy and summarize the top 3 items for me."
2. "Find all nodes containing the text 'Q3 Planning' and move them into the project parent folder with ID 59fc7acbc68c."
3. "Run a report on my outline to identify the top 20 nodes with the most children, as I need to clean up my folder structure."

Tips & Limitations

• Data Integrity: Always use the --dry-run flag when performing bulk operations like replace to ensure you aren't accidentally modifying unintended nodes.
• Performance: For large outlines, prefer --method=backup to ensure local operations are fast. Real-time (--method=get) is better for high-precision, small-scale changes.
• Safety: Deletion operations are permanent. The tool deletes children along with their parent nodes, so verify your parent IDs before executing.