feishu-docs

What This Skill Does

The feishu-docs skill is a powerful OpenClaw integration designed to manage the full lifecycle of Feishu (Lark) Docx documents. It leverages the official Feishu Open Platform APIs to enable seamless programmatic creation, retrieval, updates, and deletion of documents. This skill features sophisticated content handling capabilities, allowing users to convert Markdown or HTML content into structured Feishu blocks automatically. Beyond basic CRUD operations, it provides comprehensive control over document structure—including batch block manipulation, appending content to existing docs, and granular permissions management. Whether you need to automate report generation or sync technical documentation with your team's knowledge base, this skill provides a robust interface to streamline your workflow.

Installation

To install this skill, use the OpenClaw command-line interface as follows: clawhub install openclaw/skills/skills/binbin/feishu-docs-1-1-1

Once installed, ensure you have configured your environment variables to authenticate with the Feishu platform. You will need to export FEISHU_APP_ID and FEISHU_APP_SECRET obtained from your Feishu Developer Console. The skill supports automatic loading of these variables from a .env file within your project directory, ensuring that your credentials remain secure and environment-specific.

Use Cases

• Automated Reporting: Automatically compile daily data summaries or project tracking logs into professional Feishu documents.
• Knowledge Management: Programmatically inject Markdown-based technical documentation into team spaces for centralized knowledge sharing.
• Access Control Automation: Manage document permissions via scripts, such as granting project team members read/write access based on active directory updates.
• Content Migration: Transform existing Markdown files into structured collaborative documents without manual copy-pasting.

Example Prompts

1. "Create a new document in folder fldxxxxxx titled 'Project Alpha Q3 Report' and add the contents from the file project_data.md."
2. "Find all documents containing the keyword 'Security Audit' and list the current collaborators for the top result."
3. "Append a new status update to document dcnxxxxxx stating that the milestone has been achieved, formatted as a bold header."

Tips & Limitations

• Permissions: Ensure your Feishu App has the necessary API scopes enabled in the Developer Console (e.g., docx:read, docx:write, drive:file) for all requested operations to succeed.
• Conversion Depth: While the skill supports Markdown and HTML conversion, complex nested structures or highly customized formatting may require manual adjustment after generation to meet specific layout needs.
• Rate Limiting: Be mindful of Feishu's API rate limits when batch-processing thousands of documents; the library includes pagination support which should be utilized for large-scale operations.