名称： bookstack
描述： "BookStack Wiki 与文档 API 集成。通过编程方式管理您的知识库：创建、读取、更新和删除书籍、章节、页面和书架。支持全文搜索所有内容。适用于以下场景：(1) 创建或编辑 Wiki 页面和文档，(2) 在书籍和章节中组织内容，(3) 搜索知识库，(4) 自动化文档工作流，(5) 在系统间同步内容。支持 HTML 和 Markdown 格式内容。"
元数据：
openclaw:
requires:
env:
- BOOKSTACK_URL
- BOOKSTACK_TOKEN_ID
- BOOKSTACK_TOKEN_SECRET

BookStack 技能

BookStack 是一个开源的 Wiki 和文档平台。此技能允许您通过 API 管理整个知识库，非常适合自动化和集成。

功能特性

• 📚 书籍管理 – 创建、编辑、删除
• 📑 章节管理 – 在书籍内组织内容
• 📄 页面管理 – 使用 HTML 或 Markdown 创建/编辑
• 🔍 全文搜索 – 在所有内容中进行搜索
• 📁 书架管理 – 将书籍整理到集合中

快速开始

# 列出所有书籍
python3 scripts/bookstack.py list_books

# 搜索知识库
python3 scripts/bookstack.py search "Home Assistant"

# 获取页面
python3 scripts/bookstack.py get_page 123

# 创建新页面 (Markdown)
python3 scripts/bookstack.py create_page --book-id 1 --name "我的页面" --markdown "# 标题\n\n这里是内容..."

所有命令

书籍

python3 scripts/bookstack.py list_books                    # 列出所有书籍
python3 scripts/bookstack.py get_book <id>                 # 获取书籍详情
python3 scripts/bookstack.py create_book "名称" ["描述"]   # 创建新书籍
python3 scripts/bookstack.py update_book <id> [--name] [--description]
python3 scripts/bookstack.py delete_book <id>

章节

python3 scripts/bookstack.py list_chapters                 # 列出所有章节
python3 scripts/bookstack.py get_chapter <id>              # 获取章节详情
python3 scripts/bookstack.py create_chapter --book-id <id> --name "名称"
python3 scripts/bookstack.py update_chapter <id> [--name] [--description]
python3 scripts/bookstack.py delete_chapter <id>

页面

python3 scripts/bookstack.py list_pages                    # 列出所有页面
python3 scripts/bookstack.py get_page <id>                 # 页面预览
python3 scripts/bookstack.py get_page <id> --content       # 包含 HTML 内容
python3 scripts/bookstack.py get_page <id> --markdown      # 以 Markdown 格式获取

# 创建页面 (在书籍或章节中)
python3 scripts/bookstack.py create_page --book-id <id> --name "名称" --markdown "# 内容"
python3 scripts/bookstack.py create_page --chapter-id <id> --name "名称" --html "<p>HTML</p>"

# 编辑页面
python3 scripts/bookstack.py update_page <id> [--name] [--content] [--markdown]
python3 scripts/bookstack.py delete_page <id>

搜索

python3 scripts/bookstack.py search "查询词"                # 搜索所有内容
python3 scripts/bookstack.py search "查询词" --type page    # 仅搜索页面
python3 scripts/bookstack.py search "查询词" --type book    # 仅搜索书籍

书架

python3 scripts/bookstack.py list_shelves                  # 列出所有书架
python3 scripts/bookstack.py get_shelf <id>                # 获取书架详情
python3 scripts/bookstack.py create_shelf "名称" ["描述"]  # 创建新书架

配置

设置以下环境变量：

export BOOKSTACK_URL="https://your-bookstack.example.com"
export BOOKSTACK_TOKEN_ID="your-token-id"
export BOOKSTACK_TOKEN_SECRET="your-token-secret"

或者通过网关配置文件在 skills.entries.bookstack.env 下进行配置。

创建 API 令牌

1. 登录到您的 BookStack 实例
2. 进入 编辑个人资料 → API 令牌
3. 点击 创建令牌
4. 复制令牌 ID 和密钥

⚠️ 用户需要拥有 "访问系统 API" 权限的角色！

API 参考

• 基础 URL: {BOOKSTACK_URL}/api
• 认证头: Authorization: Token {ID}:{SECRET}
• 官方文档: https://demo.bookstackapp.com/api/docs

作者: xenofex7 | 版本: 1.0.2