office-document-editor
Professional DOCX/PPTX document editing with tracked changes, formatting preservation, highlights, strikethrough, and Git version control.
- License 许可
- MIT
- 最近更新
- 2026-05-17
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- office-document-editor
- license
- MIT
- metadata
- { "openclaw": { "install": [ { "id": "uv-env", "bins": [ "docx_editor.py", "pptx_editor.py", "generate_diff.py" ], "kind": "uv", "path": "." } ], "requires": { "bins": [ "uv", "curl" ] } } }
- description
- Professional DOCX/PPTX document editing with tracked changes, formatting preservation, highlights, strikethrough, and Git version control.
02 资源文件 7
- 参考文档_meta.json303 B
- 脚本scripts/docx_editor.py5.8 KB
- 脚本scripts/fetch_file.sh3.6 KB
- 脚本scripts/generate_diff.py2.2 KB
- 脚本scripts/interactive_edit.sh7.0 KB
- 脚本scripts/pptx_editor.py7.1 KB
- 脚本scripts/workflow_complete.sh3.3 KB
03 SKILL.md 正文
Universal Office Document Editor
Professional document editing for any DOCX/PPTX file from any source.
Quick Reference
| Task | Approach |
|---|---|
| Fetch file from upload | bash scripts/fetch_file.sh upload |
| Fetch file from URL | bash scripts/fetch_file.sh https://example.com/file.docx |
| Fetch file from SFTP | bash scripts/fetch_file.sh sftp://user@host:/path/file.docx |
| Edit DOCX | uv run python scripts/docx_editor.py input.docx output.docx edits.json |
| Edit PPTX | uv run python scripts/pptx_editor.py input.pptx output.pptx edits.json |
| Generate diff | uv run python scripts/generate_diff.py old.docx new.docx diff.md |
| Interactive mode | bash scripts/interactive_edit.sh |
File Sources
Uploaded Files (Chat Attachments)
# Get latest uploaded DOCX
bash scripts/fetch_file.sh upload output.docx
# Get latest uploaded PPTX
bash scripts/fetch_file.sh upload output.pptx
Location: ~/.openclaw/workspace/media/inbound/file_*.docx
Local Filesystem Paths
# Copy from local path
bash scripts/fetch_file.sh ~/Documents/report.docx output.docx
# Or direct path
bash scripts/fetch_file.sh /absolute/path/file.pptx output.pptx
Public URLs
# Download from URL
bash scripts/fetch_file.sh https://example.com/document.docx output.docx
SFTP/SSH Remote Files
# Fetch via SFTP
bash scripts/fetch_file.sh sftp://user@host:/path/file.docx output.docx
Creating Edit Rules
Create edits.json with your editing instructions:
{
"description": "Edit description",
"replacements": [
{
"search": "old text",
"replace": "new text",
"style": "highlight"
}
],
"additions": [
{
"after": "after this text",
"text": "add this text",
"style": "highlight"
}
],
"slides": [
{
"action": "rearrange",
"order": [0, 2, 1, 3]
}
]
}
Supported Styles
replace- Direct replacementhighlight- Yellow highlightdelete- Strikethroughbold- Bold textunderline- Underline
Slide Actions (PPTX only)
rearrange- Change slide orderadd- Add new slideremove- Delete slide
Editing Documents
Edit DOCX
uv run python scripts/docx_editor.py input.docx output.docx edits.json
Features:
- Paragraph text editing
- Table cell editing
- Format preservation
- Multiple replacements
- Text additions
Edit PPTX
uv run python scripts/pptx_editor.py input.pptx output.pptx edits.json
Features:
- Slide text replacement
- Slide rearrangement
- Add/remove slides
- Format preservation
Generate Diff Report
uv run python scripts/generate_diff.py input.docx output.docx diff-report.md
Output: Standard Unified Diff format in Markdown.
Complete Workflow
Step 1: Fetch File
# From upload
bash scripts/fetch_file.sh upload input.docx
# From URL
bash scripts/fetch_file.sh https://example.com/file.docx input.docx
# From local path
bash scripts/fetch_file.sh ~/Documents/file.docx input.docx
Step 2: Create Edit Rules
{
"description": "IRB Review Response",
"replacements": [
{
"search": "2026 年 2 月 28 日",
"replace": "2026 年 8 月 31 日",
"style": "highlight"
}
]
}
Step 3: Execute Edit
uv run python scripts/docx_editor.py input.docx output.docx edits.json
Step 4: Generate Reports
# Unified Diff
uv run python scripts/generate_diff.py input.docx output.docx diff.md
# Convert to Markdown
uv run markitdown output.docx > output.md
Step 5: Version Control
git add *.docx *.md diff.md
git commit -m "Edit: Description of changes"
Interactive Mode
For guided editing:
bash scripts/interactive_edit.sh
This will prompt you through:
- File source selection
- Edit type selection
- Details collection
- Output location
Examples
Example 1: Text Replacement with Highlight
{
"replacements": [
{
"search": "February 28, 2026",
"replace": "August 31, 2026",
"style": "highlight"
}
]
}
Example 2: Add Text After Question
{
"additions": [
{
"after": "What is the research topic?",
"text": "[ANSWER] Data Structures and Algorithms",
"style": "highlight"
}
]
}
Example 3: Rearrange Slides
{
"slides": [
{
"action": "rearrange",
"order": [0, 2, 1, 3, 4]
}
]
}
Notes
Format Preservation
- ✅ Text, paragraphs, tables: Fully preserved
- ✅ Highlights, strikethrough, bold: Supported
- ⚠️ Complex styles (custom themes): May be lost
- ❌ Images, charts: Manual handling required
Table Text Replacement
python-docx requires exact match (including spaces, punctuation, newlines) for table text.
Solutions:
- Use shorter search strings
- Use
markitdownto preview table content first - Use exact match in JSON
Git Best Practices
- Use local Git repo (do not upload to GitHub)
- Add sensitive files to
.gitignore - Backup to secure location regularly
Dependencies
- uv: Package management and virtual environment
- python-docx: DOCX editing
- python-pptx: PPTX editing
- mammoth: DOCX to Markdown conversion
- markitdown: Universal document conversion
- curl: URL downloads
- sftp: SFTP file transfers (optional)
Installation
cd ~/.openclaw/workspace/skills/office-document-editor
uv sync
Troubleshooting
"No replacements made"
Cause: Text doesn't match exactly
Solution:
# Preview content
uv run markitdown input.docx
# Use exact text from preview
"Virtual environment not found"
Solution:
cd ~/.openclaw/workspace/skills/office-document-editor
uv sync
"File not found"
Solutions:
- Check file path is correct
- Try uploading the file again
- Verify URL is accessible
- Check SFTP credentials
Scripts Reference
fetch_file.sh
Universal file fetcher for all source types.
bash scripts/fetch_file.sh <source> [output_filename]
Sources:
upload- Latest uploaded file/path/to/file- Local pathhttps://...- Public URLsftp://...- SFTP remote
docx_editor.py
Edit Word documents with formatting.
uv run python scripts/docx_editor.py input.docx output.docx edits.json
pptx_editor.py
Edit PowerPoint presentations.
uv run python scripts/pptx_editor.py input.pptx output.pptx edits.json
generate_diff.py
Generate Unified Diff reports.
uv run python scripts/generate_diff.py old.docx new.docx diff.md
interactive_edit.sh
Interactive guided editing.
bash scripts/interactive_edit.sh
workflow_complete.sh
Complete automated workflow.
bash scripts/workflow_complete.sh input.docx edits.json
04 同仓库更多 Skills
zvukogram
Text-to-Speech via Zvukogram API with SSML support. Use when you need to generate speech from text, create podcasts, voice notifications, or work with audio. Supports speed control, stress marks, English word transcription, and audio fragment merging.
zohomail
Zoho Mail API integration with managed OAuth. Send, receive, and manage emails, folders, and labels. Use this skill when users want to send emails, read messages, manage folders, or work with email labels in Zoho Mail. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway). Requires network access and valid Maton API key.
zoho-recruit
Zoho Recruit API integration with managed OAuth. Manage candidates, job openings, interviews, and recruitment workflows. Use this skill when users want to read, create, update, or search recruitment data like candidates, job openings, interviews, and applications in Zoho Recruit. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway). Requires network access and valid Maton API key.
zoho-people
Zoho People API integration with managed OAuth. Manage employees, departments, designations, attendance, and leave. Use this skill when users want to read, create, update, or query HR data like employees, departments, designations, and forms in Zoho People. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway). Requires network access and valid Maton API key.
zoho-mail
Zoho Mail API integration with managed OAuth. Send, receive, and manage emails, folders, and labels. Use this skill when users want to send emails, read messages, manage folders, or work with email labels in Zoho Mail. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway). Requires network access and valid Maton API key.
zoho-inventory
Zoho Inventory API integration with managed OAuth. Manage items, sales orders, invoices, purchase orders, bills, contacts, and shipments. Use this skill when users want to read, create, update, or delete inventory items, sales orders, invoices, purchase orders, bills, or other inventory records in Zoho Inventory. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway). Requires network access and valid Maton API key.