feishu-doc-writer

What This Skill Does

The feishu-doc-writer skill is a powerful tool designed to automate the creation and management of Feishu (Lark) cloud documents. Unlike standard text-based integrations, this skill understands the underlying Block tree model required by the Feishu Docx API. It provides two distinct pathways for content generation: a high-level Markdown conversion endpoint for rapid document scaffolding, and a granular manual Block construction system for complex layouts including callouts, code blocks, images, and tables. By managing document revisions and concurrency, this skill ensures that your AI-generated content is structured, readable, and properly formatted within the Feishu ecosystem.

Installation

To integrate this skill into your OpenClaw environment, execute the following command in your terminal: clawhub install openclaw/skills/skills/sunnyyao2222-eng/feishu-doc-write Ensure your Feishu tenant access tokens are configured correctly in your project settings to allow the skill to authenticate with the Docx API.

Use Cases

• Automated Reporting: Automatically convert daily data summaries into formatted Feishu documents with headings, bullet points, and code snippets.
• Knowledge Management: Programmatically generate internal wiki pages or project documentation directly from AI research drafts.
• Task Tracking: Create project status trackers in Feishu using Todo blocks and structured lists.
• Collaborative Writing: Use the AI to generate long-form drafts and inject them into shared Feishu workspaces for team review.

Example Prompts

1. "Sync the following project status report into a new Feishu document: [Content], using a mix of headings and bulleted lists."
2. "Create a Feishu doc page titled 'Team Meeting Notes' and add a Callout block containing the summary of our last session."
3. "Convert this Markdown technical specification into a Feishu doc block structure, ensuring the code snippets are formatted correctly."

Tips & Limitations

• Markdown Conversion: Use the /convert endpoint for simple documents to save time and API complexity. It handles standard formatting like bold, italics, and lists automatically.
• Manual Block Control: If you need advanced Feishu features like Callouts or specific block nesting, you must build the JSON structure manually using the block reference provided.
• Concurrency: Always monitor your document_revision_id when making sequential calls to ensure your changes are not overwritten by simultaneous operations.
• Image Handling: Remember that images require a two-step process: you must first create a placeholder block, then perform the upload, rather than sending image data in the initial text request.