docx

What This Skill Does

The docx skill for OpenClaw empowers the AI agent to interact with Microsoft Word (.docx) files at a professional level. It provides the ability to create new documents, modify existing content, manage tracked changes, and handle complex document structures such as comments, embedded metadata, and formatting. By utilizing specialized tools for different file interaction modes—specifically Pandoc for text extraction/analysis, docx-js for document creation, and the Document Python library for OOXML manipulation—this skill bridges the gap between raw data and polished, professional business documentation.

Installation

To integrate the docx skill into your OpenClaw environment, execute the following command in your terminal: clawhub install openclaw/skills/skills/seanphan/docx Ensure that your environment has sufficient permissions for file system operations, as this skill requires read/write access to manage document lifecycle tasks effectively.

Use Cases

1. Automated Report Generation: Dynamically generate status reports, project summaries, or invoices by injecting structured data into branded Word templates.
2. Redlining and Contract Review: Use the redlining workflow to propose edits, track changes, and insert comments on legal or academic drafts, ensuring auditability and compliance with standard business practices.
3. Content Extraction and Analysis: Extract and analyze plain text or specific XML metadata from existing archives, enabling the AI to answer complex queries about historical documents without manual opening.
4. Batch Document Transformation: Convert large volumes of proprietary documents into cleaner formats (like markdown) for inclusion in RAG (Retrieval-Augmented Generation) pipelines.

Example Prompts

1. "Create a new business proposal document titled 'Project Alpha' using the standard header style, including sections for Executive Summary, Scope, and Budget."
2. "Review the attached 'Service_Agreement_v2.docx', suggest changes to the liability clause using tracked changes, and leave a comment explaining why we should include an indemnification provision."
3. "Extract the full text and all comments from 'Project_Update_Q3.docx' and summarize the key action items assigned to the team in a bulleted list."

Tips & Limitations

• Mandatory Reading: When creating new documents from scratch, always read the docx-js.md documentation in its entirety. It contains critical syntax and formatting constraints that prevent document corruption.
• Workflow Strategy: Use the 'Redlining Workflow' for any document that carries legal or professional weight. Never perform destructive edits directly on master copies without creating a backup or using tracked changes.
• XML Access: If you encounter issues with complex formatting or image rendering, the issue likely resides in the underlying XML structure. Switch to raw XML access using unpack.py to diagnose issues within word/document.xml or word/comments.xml.
• Security: Be cautious when processing documents from untrusted sources, as the ability to manipulate XML structures implies potential exposure to malicious macro-like payloads if file handling is not performed within a secure, sandboxed container.