bookstack

What This Skill Does

The BookStack skill for OpenClaw provides a powerful bridge between your AI agent and the BookStack documentation platform. By leveraging the BookStack API, this skill allows users to treat their knowledge base as an interactive, living repository. It enables programmatic control over books, chapters, pages, and shelves, facilitating the automated creation, retrieval, and organization of documentation. Whether you are generating technical guides via Markdown or managing large organizational wikis, this tool abstracts the API complexities into simple CLI-like commands.

Installation

To integrate this skill into your OpenClaw environment, execute the following command: clawhub install openclaw/skills/skills/xenofex7/bookstack. After installation, you must configure your environment variables to authorize the agent. Ensure you set BOOKSTACK_URL, BOOKSTACK_TOKEN_ID, and BOOKSTACK_TOKEN_SECRET in your shell profile or deployment configuration. This authentication is required for all read and write operations against your private or public wiki instances.

Use Cases

1. Automated Documentation: Automatically generate wiki pages from technical project outputs or code comments.
2. Knowledge Aggregation: Search across your entire documentation suite to find specific snippets or instructions across thousands of pages.
3. Wiki Maintenance: Programmatically update existing chapters or move books into relevant shelves to maintain structural integrity as your knowledge base grows.
4. Syncing: Ensure consistency across multiple platforms by syncing content into your central BookStack instance using the agent's ability to process both HTML and Markdown.

Example Prompts

1. "Search for all documentation regarding 'API authentication' and summarize the top three results for me."
2. "Create a new page titled 'Project Q3 Roadmap' in the 'Engineering' book with the content provided in this Markdown file."
3. "List all the chapters currently in the 'Developer Handbook' book so I can decide where to add the new onboarding guide."

Tips & Limitations

• Formatting: The skill supports both HTML and Markdown. When creating pages, specify the content type clearly to ensure the BookStack editor parses the syntax correctly.
• Authentication: Keep your Token ID and Secret secure. These should never be hardcoded into scripts or shared in public logs.
• Search Precision: Use the --type flag when performing searches to limit results to specific entities like 'page' or 'book', which significantly reduces noise when searching large libraries.
• Limitations: Deleting content is permanent. Ensure your scripts have validation checks before executing delete_page or delete_book commands to avoid data loss.