← Back to Skills Marketplace
Talebook
by
PoxenStudio
· GitHub ↗
· v1.0.6
· MIT-0
436
Downloads
0
Stars
2
Active Installs
7
Versions
Install in OpenClaw
/install talebook
Description
Talebook(PoxenStudio)是个人书库管理系统，提供电子书及实体书管理，包括存储、分类、搜索和元数据管理功能。你可以帮助用户：查询书库统计信息和阅读统计,搜索/浏览书籍,获取书籍详情,更新书籍元数据（书名、作者、标签、分类、简介等）,自动联网填充书籍信息,发送书籍到邮箱或阅读器设备,上传电子书或通过...
Usage Guidance
This skill appears to be what it claims: a client for a Talebook server. Before installing, confirm you trust the TALEBOOK_HOST URL (it will receive your TALEBOOK_USER and TALEBOOK_PASSWORD). Provide credentials via session-level environment variables or a secrets manager (do not store them in a shared plaintext file). Ensure the Python 'requests' package is available on the agent environment (the script will prompt to install it if missing). If you plan to use an account with limited rights for routine queries, prefer a non-admin user for safety (admin-only actions like book_fill are documented). Finally, because the skill executes a bundled script, review or sandbox it if you have stricter security requirements or if TALEBOOK_HOST is a remote/unknown server.
Capability Analysis
Type: OpenClaw Skill
Name: talebook
Version: 1.0.6
The skill bundle provides a comprehensive API client for managing a Talebook personal library. The Python script (talebook_api.py) implements standard REST API interactions, including authentication via session cookies and various library management functions such as searching, editing metadata, and uploading books. The code is well-structured, uses standard libraries like 'requests', and lacks any indicators of data exfiltration, malicious execution, or prompt injection. All functionalities, including file uploads and email/device delivery, are consistent with the stated purpose of the skill.
Capability Assessment
Purpose & Capability
Name/description (Talebook book management) matches the required items: python3 and the three TALEBOOK_* env vars. The script contacts the declared TALEBOOK_HOST and performs book/user/library operations consistent with the description.
Instruction Scope
SKILL.md instructs running the included Python script with JSON args and documents the specific API calls. The instructions reference only the declared environment variables and the Talebook API endpoints; they do not ask the agent to read unrelated files or exfiltrate data to other endpoints.
Install Mechanism
No install spec (instruction-only) and the code file is bundled. The script relies on the third-party Python 'requests' library but SKILL.md lists only python3 as a required binary; the script will exit with an installation hint if 'requests' is missing. There are no downloads from external URLs or extract steps.
Credentials
Only TALEBOOK_HOST, TALEBOOK_USER, and TALEBOOK_PASSWORD are required — all directly needed to authenticate to the self-hosted Talebook service. There are no unrelated secrets or extra credentials requested.
Persistence & Privilege
Skill is not marked always:true and uses normal autonomous invocation defaults. It does not attempt to modify other skills or system-wide agent settings.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install talebook - After installation, invoke the skill by name or use
/talebook - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.6
- Documentation updated in SKILL.md to clarify that the client uses Secure Cookie (user_id + lt) for session management; removed mention of automatic curl cookie jar handling.
- No tool interfaces or logic were changed. All tool descriptions and usage remain the same.
- Minor formatting/wording adjustments for accuracy and clarity in authentication instructions.
v1.0.5
- 移除 curl 命令为必需依赖，仅保留 python3 作为必需工具。
- `allowed-tools` 与元数据中的依赖项一致更新，只列出 python3。
- 其余内容保持不变。
v1.0.4
- 切换执行脚本为 Python 版本（talebook_api.py），不再使用 Bash 脚本。
- 更新 requirements，移除了对 curl 的显式直接调用，仅需 Python3 环境。
- 强化环境变量配置说明，新增安全提示：不推荐将凭据写入共享/全局配置文件，建议用会话级环境变量或密钥管理工具。
- 工具执行示例和脚本路径由 Bash 格式改为统一的 Python 脚本调用格式（<skill-installation-path>/scripts/talebook_api.py）。
- metadata 节点“requires”字段同步更新，明确声明所需的环境变量。
v1.0.3
talebook 1.0.3 brings major enhancements, modernizing script structure, updating usage, and expanding feature documentation.
- Migrated API interaction from shell script to Python (`talebook_api.py` added, legacy `talebook-mcp.sh` removed).
- Updated documentation to reflect new Python-based API usage and configuration via environment variables.
- Expanded and revised skill description, usage instructions, and error handling details.
- Documented new and refined features, including reading stats, device/Kindle sending, entity book support, user authentication, and more granular metadata management.
v1.0.2
- Updated SKILL.md description field to be a single-line, comma-separated summary.
- No functional or interface changes; documentation formatting only.
v1.0.1
- Fixed the skill quick start example: corrected the scripts path from talebook-mcp/ to talebook/.
- Removed the version field from the skill manifest header.
- No functional or API changes. Documentation only.
v1.0.0
Initial release of talebook skill:
- Provides personal ebook library management with book storage, browsing, search, and metadata editing.
- Supports querying book statistics, listing and searching books, updating metadata, and filling in missing info automatically.
- Includes integration with online sources for fetching book information.
- All actions work via Bash (curl) scripts with no manual authentication required.
- Detailed usage instructions, parameter guides, and error handling included.
Metadata
Frequently Asked Questions
What is Talebook?
Talebook(PoxenStudio)是个人书库管理系统，提供电子书及实体书管理，包括存储、分类、搜索和元数据管理功能。你可以帮助用户：查询书库统计信息和阅读统计,搜索/浏览书籍,获取书籍详情,更新书籍元数据（书名、作者、标签、分类、简介等）,自动联网填充书籍信息,发送书籍到邮箱或阅读器设备,上传电子书或通过... It is an AI Agent Skill for Claude Code / OpenClaw, with 436 downloads so far.
How do I install Talebook?
Run "/install talebook" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Talebook free?
Yes, Talebook is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Talebook support?
Talebook is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Talebook?
It is built and maintained by PoxenStudio (@poxenstudio); the current version is v1.0.6.
More Skills