wps-word-automation

What This Skill Does

The wps-word-automation skill is a powerful utility designed to bridge the gap between Windows-based document processing applications (Microsoft Word or WPS Writer) and automated workflows. By leveraging COM (Component Object Model) technology, this skill allows OpenClaw to perform granular manipulations on .docx files programmatically. It effectively turns your office suite into a programmable interface, handling tasks such as text extraction, content replacement, structure modification (headings), formatting additions (headers, footers, and page breaks), document merging, splitting, and file conversions to PDF or plain text. Whether you need to automate a repetitive reporting task, bulk-edit formatted documents, or convert office files into archival formats, this skill provides the necessary bridge to execute these tasks via command-line arguments.

Installation

To utilize this skill, ensure your environment meets the core prerequisites: a Windows operating system with either Microsoft Word or WPS Writer installed, and Python configured with the pywin32 library. You can install the library by running python -m pip install pywin32 in your terminal. Once the environment is ready, install the skill directly into your OpenClaw ecosystem using the following command: clawhub install openclaw/skills/skills/fadeloo/tiangong-wps-word-automation.

Use Cases

This skill is ideal for office automation scenarios where manual document interaction is too slow or error-prone. Use it for:

• Automated Document Templating: Quickly replace placeholders in contracts or form letters with dynamic data.
• Report Generation: Assemble multiple disparate document fragments into a single cohesive report file.
• Content Transformation: Automatically convert hundreds of Word docs into PDF files for archiving.
• Document Cleanup: Bulk apply standard heading styles to raw text documents to ensure accessibility.
• Extraction Workflows: Extract text from legacy files for use in LLM analysis or data processing.

Example Prompts

1. "Open the document at C:\Reports\Project_Alpha.docx, replace all instances of the placeholder 'CLIENT_NAME' with 'Acme Corp', and save the result as C:\Reports\Project_Alpha_Final.docx."
2. "Convert my document located at C:\Drafts\Proposal.docx into a PDF file and save it in the same folder."
3. "Merge the files part1.docx and part2.docx from my desktop into a single document named Final_Report.docx."

Tips & Limitations

This skill is optimized for single-document operations and is not intended for high-concurrency batch processing. For heavy batch tasks, consider sequential execution patterns. When dealing with mixed environments where both Word and WPS are present, explicitly use the --app wps flag to dictate the desired provider. If you encounter issues with file permissions, ensure that no other instances of the Office application have the file locked. For debugging or monitoring document changes in real-time, use the --visible true flag to launch the application window during execution.