larksuite-wiki

What This Skill Does

The larksuite-wiki skill provides a robust interface for interacting with the Lark Suite (Feishu) ecosystem. It allows users to manage, search, and export knowledge base documentation directly to local environments. By leveraging the official Lark Open Platform APIs, this tool handles the complex task of traversing recursive document hierarchies, converting proprietary Lark formats into structured Markdown files, and maintaining directory structures. The skill features an incremental sync mechanism that tracks revision IDs, ensuring that only modified files are updated during subsequent sync operations. It is designed to assist users in backing up their collaborative knowledge bases or integrating wiki content into local developer workflows.

Installation

To integrate this skill into your OpenClaw environment, execute the following command in your terminal:

clawhub install openclaw/skills/skills/reed1898/larksuite-wiki

Before running, ensure you have registered an application on the Lark/Feishu Open Platform and configured the necessary permissions: docs:doc:read, drive:drive:read, and wiki:wiki:read. Once authorized, set your environment variables for LARK_APP_ID and LARK_APP_SECRET to enable secure API communication.

Use Cases

• Knowledge Backup: Regularly mirror internal team wikis to a local repository for offline access or secondary backup.
• Documentation Migration: Export structured wiki content to be ingested by static site generators (like Hugo or Jekyll) or RAG-based AI tools.
• Workspace Synchronization: Keep local developer documentation in sync with product requirement documents hosted in Feishu.
• Audit Compliance: Maintain a historical archive of project documentation iterations for compliance tracking.

Example Prompts

1. "Sync my entire marketing wiki to the ./knowledge-base directory, ensuring we only update files that have changed since yesterday."
2. "Display the tree structure of the project wiki starting from the root URL https://your-domain.larksuite.com/wiki/doc123 to understand the folder depth."
3. "Export the specific technical spec document titled 'API Gateway Architecture' and its sub-pages to my local markdown folder."

Tips & Limitations

• Permissions: Ensure the target wiki documents are shared with your bot app, otherwise the API will return 403 errors.
• Formatting: While the skill handles most content types, complex embedded block elements like interactive charts or advanced database views might not translate perfectly to Markdown. Review the output for complex formatting nuances.
• Rate Limiting: Large wikis with thousands of subdocuments may trigger API rate limits; allow sufficient time for recursive syncs.
• Sync State: Do not manually delete the .lark-sync-state.json file if you wish to maintain incremental sync tracking; deleting it will force a full re-export on the next sync.