Feishu Docx Powerwrite

Feishu Docx PowerWrite

This skill focuses on reliably writing great-looking Feishu Docx using OpenClaw’s Feishu OpenAPI tools.

Key idea: prefer `feishu_docx_write_markdown` (Markdown → Docx blocks) for structure-preserving output.

Quick workflow

1) Get document_id (Docx token)

• From a Docx URL: https://.../docx/<document_id>

2) Decide write mode

• Append: add new content below existing content (most common)
• Replace: overwrite the entire document (use carefully)

3) Write markdown

• Use headings + lists + short paragraphs
• Avoid huge single paragraphs (harder to read)

Recommended defaults

Append mode (safe)

Use when adding sections, meeting notes, daily logs.

• mode: append
• Keep each append chunk <= ~300-600 lines if possible

Replace mode (destructive)

Use when generating the full doc from scratch.

• mode: replace
• MUST set confirm: true

Markdown patterns that render well

Title + summary

# <Title>

**Summary**
- Point 1
- Point 2

---

Sections

## Section

Short paragraph.

- Bullet
- Bullet

### Subsection

1) Step
2) Step

Code

Use fenced blocks.

openclaw skills check

Templates & references

• Templates: references/templates.md
• Troubleshooting: references/troubleshooting.md

Safety / privacy

• Never hardcode tokens, chat_id, open_id, or document links inside this skill.
• Always use the user’s own Feishu app credentials and scopes.

Docx templates (Markdown)

Meeting notes

# <Meeting Title>

**When**: YYYY-MM-DD HH:MM–HH:MM
**Attendees**: A, B, C

## Agenda
1) 
2) 

## Notes
- 

## Decisions
- 

## Action items
- [ ] <owner> — <task> — <date>

Weekly update

# Weekly Update — <Name> — YYYY-WW

## Highlights
- 

## Metrics
- 

## Challenges / Risks
- 

## Next week
- 

Spec / proposal

# <Proposal>

## Context

## Problem

## Goals / Non-goals
**Goals**
- 

**Non-goals**
- 

## Approach

## Alternatives

## Risks

## Rollout

## Open questions
- 

Troubleshooting (Feishu Docx PowerWrite)

1) Permission / 403 / no access

Typical causes:

• Feishu app scopes missing docx/drive permissions
• The bot/app isn’t added as a collaborator to the target doc

Fix:

• Re-check Feishu app scopes
• Share the doc to the bot/app (or make it accessible via org policy)

2) Content not rendered as expected

Common causes:

• Markdown too dense (giant paragraphs)
• Incorrect list indentation

Fix:

• Keep paragraphs short
• Use consistent 2-space indentation for nested lists

3) Replace mode didn’t overwrite

• Replace requires confirm: true (destructive)

4) Large docs

• Prefer chunked appends
• Append section-by-section (e.g., 1k–3k chars per chunk)