BookStack Integration and Skills Configuration Status — 2026-09-12

BookStack Integration and Skills Configuration Status\n\n##Status

Summary\n\nBookStack

Summary

BookStack has been actively used as the OpenClaw durable knowledge base. Previous sessions successfully authenticated to the BookStack API and created or updated books, chapters, pages, infrastructure documentation, and diagrams.\n\n##

Confirmed historical operation\n\n-operation

BookStack host: \n-https://book.stargrid.com.au A read-only API test previously succeeded and returned the AI and OpenClaw books.\n- The OClaw book was created as the durable OpenClaw knowledge base.\n- The Chris's IT Infrastructure book was created and populated from read-only UniFi inventory.\n- Infrastructure pages include network overview, gateway/switch/access point inventory, camera inventory, connected clients, firewall/access policy summary, VLAN/wireless inventory, and a topology diagram.\n- Later sessions continued writing documentation and diagrams to BookStack.\n\n##

What went wrong\n\nThewrong

The local workspace skill remained present at ,workspace/skills/bookstack/SKILL.md, but its configuration had drifted:\n\n1.

skills.entries.bookstack.enabled was set to ,false, so OpenClaw marked the skill disabled.\n2. The stored BookStack credentials were still present in OpenClaw's protected secret store, but the skill readiness check could not see them as injected environment variables.\n3. The skill was therefore reported as disabled or needing setup even though the BookStack service and credentials had previously worked.\n\nThe

The exact session that changed those settings was not identified. The most likely cause is configuration drift during the recent model/session/plugin cleanup.\n\n##

Repair status\n\n-status

The BookStack skill has been re-enabled with .\n-skills.entries.bookstack.enabled: true. The three stored credential names remain present: ,BOOKSTACK_URL, ,BOOKSTACK_TOKEN_ID, and .\n-BOOKSTACK_TOKEN_SECRET. Credential values and token secrets are intentionally not recorded in this page.\n- The current skill checker still reports the environment requirements as unresolved because the per-skill environment injection mapping is not currently restored.\n- Do not re-enter or publish the token secret in BookStack, chat, scripts, or committed configuration.\n\n##

Operational lesson\n\nAlesson

A successful BookStack API connection and OpenClaw skill readiness are separate checks. The API credentials can remain healthy while the skill is disabled or its environment injection is missing. When this happens, verify both:\n\n-

BookStack API connectivity using the gateway-managed secret environment.\n- skills.entries.bookstack.enabled and the skill's environment injection/readiness configuration.\n\n##

Follow-up\n\nRestoreup

Restore the supported secret-to-environment injection path for the workspace BookStack skill, then run a read-only list_books test and confirm that bookstack △ Needs setup

BookStack Wiki & Documentation API integration. Manage your knowledge base programmatically: create, read, update, and delete books, chapters, pages, and shelves. Full-text search across all content. Use when you need to: (1) Create or edit wiki pages and documentation, (2) Organize content in books and chapters, (3) Search your knowledge base, (4) Automate documentation workflows, (5) Sync content between systems. Supports both HTML and Markdown content.

Details: Source: openclaw-workspace Path: ~/.openclaw/workspace/skills/bookstack/SKILL.md Visible to model: no Available as command: no

Requirements: Environment: ✗ BOOKSTACK_URL, ✗ BOOKSTACK_TOKEN_ID, ✗ BOOKSTACK_TOKEN_SECRET

Tip: use openclaw skills search,info openclaw skills install, and openclaw skills update for ClawHub-backed skills.bookstack reports ready.\n