MyBooks
MyBooks是个人书库管理系统,提供电子书及实体书管理,包括存储、分类、搜索和元数据管理功能。你可以帮助用户:查询书库统计信息和阅读统计,搜索/浏览书籍,获取书籍详情,更新书籍元数据(书名、作者、标签、分类、简介等),自动联网填充书籍信息,发送书籍到邮箱或阅读器设备,上传电子书或通过ISBN添加实体书,管理阅读状态(想读/在读/已读/收藏),查询/手动更新某本书分格式的阅读时长与进度,按日期补录/修改/删除阅读时间(v4.3.0+),管理书单(创建/浏览/加书/移书/点赞,v4.3.0+),查看作者信息和分类信息,导入第三方阅读App的划线与想法(如微信读书,需配合微信读书 skill 读取 Skill: MyBooks Owner: poxenstudio Summary: MyBooks是个人书库管理系统,提供电子书及实体书管理,包括存储、分类、搜索和元数据管理功能。你可以帮助用户:查询书库统计信息和阅读统计,搜索/浏览书籍,获取书籍详情,更新书籍元数据(书名、作者、标签、分类、简介等),自动联网填充书籍信息,发送书籍到邮箱或阅读器设备,上传电子书或通过ISBN添加实体书,管理阅读状态(想读/在读/已读/收藏),查询/手动更新某本书分格式的阅读时长与进度,按日期补录/修改/删除阅读时间(v4.3.0+),管理书单(创建/浏览/加书/移书/点赞,v4.3.0+),查看作者信息和分类信息,导入第三方阅读App的划线与想法(如微信读书,需配合微信读书 skill 读取 Tags: latest:1.0.7 Version history: v1.0.7 | 2026-09-28T04:09:53.903Z | user
Rank
62
Safety
84
Downloads
1.4k
Updated
Oct 10, 2026
Version
1.0.7
Source
CLAWHUB
About
What it does, and when to use it.
Capability contract not published. No trust telemetry is available yet. 1.4K downloads reported by the source. Last updated 10/10/2026.
Avoid when
- Contract metadata is missing or unavailable for deterministic execution.
Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing
Public facts
Every fact links back to the source it came from.
- Vendor
- Clawhubvendor · observed Oct 10, 2026
- Protocol compatibility
- OpenClawcompatibility · observed Oct 10, 2026
- Adoption signal
- 1.4K downloadsadoption · observed Oct 10, 2026
- Latest release
- 1.0.7release · observed Sep 28, 2026
- Handshake status
- UNKNOWNsecurity
Install and run
Setup complexity: low.
clawhub skill install s173jhrdgj35f8pz7vay4vakah83g5q1:mybooks- Setup complexity is classified as HIGH. You must provision dedicated cloud infrastructure or an isolated VM. Do not run this directly on your local workstation.
- Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.
Contract: missing
curl -s "https://www.xpersona.co/api/v1/agents/clawhub-poxenstudio-mybooks/snapshot"
Documentation
CLAWHUB
145,038 characters of source documentation, loaded on request.
Extracted files
4 files captured from the source.
SKILL.md
---
name: mybooks
homepage: https://www.mybooks.top
allowed-tools: Bash(python3:*)
metadata: {"clawdbot":{},"openclaw":{"requires":{"bins":["python3"],"env":["MYBOOKS_HOST","MYBOOKS_USER","MYBOOKS_PASSWORD"]},"permissions":{"network":{"required":true,"scope":"user-configured MYBOOKS_HOST only","protocols":["http","https"]},"filesystem":{"read":"only when uploading: ebook files (book_upload) and mp3/wav samples (tts_clone_upload) at paths the user gives","write":"only tts_clone_audio save_to (.wav, never overwrites)"}}}}
description: "MyBooks是个人书库管理系统,提供电子书及实体书管理,包括存储、分类、搜索和元数据管理功能。你可以帮助用户:查询书库统计信息和阅读统计,搜索/浏览书籍,获取书籍详情,更新书籍元数据(书名、作者、标签、分类、简介等),自动联网填充书籍信息,发送书籍到邮箱或阅读器设备,上传电子书或通过ISBN添加实体书,管理阅读状态(想读/在读/已读/收藏),查询/手动更新某本书分格式的阅读时长与进度,按日期补录/修改/删除阅读时间(v4.3.0+),管理书单(创建/浏览/加书/移书/点赞,v4.3.0+),查看作者信息和分类信息,导入第三方阅读App的划线与想法(如微信读书,需配合微信读书 skill 读取原始数据),以及MiMo TTS有声书功能(配置TTS API、EPUB转有声书、查询转换进度、克隆音色与语音提示词管理,需管理员权限)等"
---
# MyBooks
## Requirements
```bash
# 需要配置以下三个环境变量后方可使用
export MYBOOKS_HOST="http://127.0.0.1:8082"
export MYBOOKS_USER="admin"
export MYBOOKS_PASSWORD="your_password"
export MYBOOKS_SSL_VERIFY="false" # 如服务器使用自签名证书,设为 false
# 明文 http 仅允许回环/内网地址(如 192.168.x.x);公网地址必须用 https
# 确需对非内网地址使用明文 http 时:export MYBOOKS_ALLOW_INSECURE_HTTP="true"
然后按如下方式执行:
<skill-installation-path>/scripts/mybooks_api.py <tool-name> '<json-args>'
```
> **安全提示**:请勿将凭据写入共享或全局配置文件(如 `~/.openclaw/.env`),以避免凭据被其他 agent 或进程意外读取。建议通过会话级环境变量或专用密钥管理工具传入凭据。
## 权限与网络声明
- **网络访问(必需)**:本 skill 是 MyBooks 服务器的 REST 客户端,所有工具都通过 HTTP(S) 访问**且仅访问**用户自己配置的 `MYBOOKS_HOST`,不连接任何其他地址,无遥测、无第三方回传。
- **会修改数据的工具**:`edit_book`、`set_folder`、`rename_folder`、`push_notes`(`dry_run:false`)、`clear_imported_notes`、`book_fill`、`save_meta_to_file`、`book_upload`、`book_add_by_isbn`、`wants`/`favorite`/`reading`/`read_done`、`set_reading_time`、`delete_reading_time`、书单的创建/修改/删除/增删书/点赞、以及全部 `tts_*` 写操作。删除类工具(`delete_booklist`、`delete_reading_time`)脚本内强制 `confirm:true` 两步确认。
- **本地文件读取**:仅 `book_upload`(限电子书扩展名 epub/mobi/azw/azw3/pdf/txt/lrf/rtf/djvu/docx)和 `tts_clone_upload`(限 mp3/wav,≤7MB)会读取用户明确给出路径的文件并上传到 `MYBOOKS_HOST`;agent **不得**自行挑选文件上传。
- **本地文件写入**:仅 `tts_clone_audio` 的 `save_to`(必须 `.wav` 结尾,且不覆盖已存在文件)。
- **凭据**:见下方"认证方式"。
## 通用响应格式与认证方式
### 通用 JSON 响应结构
所有 API 均返回如下格式:
```json
{
"err": "ok", // "ok" 表示成功,其他字符串表示错误码
"msg": "...", // 可选,人类可读的成功/错误说明
"data": { } // 可选,具体响应数据(因接口而异)
}
```
常见错误码:
| `err` 值 | 含义 |
|----------|------|
| `"ok"` | 操作成功 |
| `"user.need_login"` | 未登录或登录态已过期 |
| `"permission"` | 无权限执行该操作 |
| `"params.invalid"` | 请求参数错误 |
| `"params.book.invalid"` | 书籍不存在或 ID 错误 |
| `"task.running"` | 后台任务正在进行中,稍后重试 |
| `"tts.converting"` | TTS 转换任务正在运行 |
| `"tts.no_config"` | 未配置 TTS API |
| `"clone.exists"` | 克隆音色名称已存在 |
| `"clone.not_found"` | 克隆音色不存在 |
| `"clone.too_large"` | 文件超过 7MB 限制 |
| `"clone.invalid_format"` | 仅支持 MP3/WAV 格式 |
| `"prompt.exists"` | 提示词名称已存在 |
| `"prompt.not_found"` | 提示词不存在 |
### 认证方式
- 脚本通过 `MYBOOKS_USER` / `MYBOOKS_PASSWORD` 环境变量自动调用 `/ap_meta.json
{
"ownerId": "kn7efqfkfz4afhzzg8xd9bbcdh82drav",
"slug": "mybooks",
"version": "1.0.7",
"publishedAt": 1790568593903
}skill-card.md
## Description: Helps users manage a MyBooks library, reading activity, annotations, book transfers, and administrator-controlled audiobook conversion and voice settings. This skill is ready for commercial/non-commercial use. ## Publisher: [poxenstudio](https://clawhub.ai/user/poxenstudio) ### License/Terms of Use: MIT-0 ## Use Case: MyBooks users can ask an agent to find and organize books, track reading, import annotations, transfer ebooks, and manage audiobooks when authorized. ### Deployment Geography for Use: Global ## Known Risks and Mitigations: Risk: Credentials, book text, voice samples, or TTS keys may be processed by the configured MyBooks server or TTS provider. Mitigation: Use a trusted server and HTTPS for non-local hosts, keep credentials session-scoped, and review TTS use before sharing sensitive content. Risk: Uploading an unintended local ebook or voice sample could expose private material. Mitigation: Upload only files explicitly selected by the user and confirm their destination. Risk: Library edits, annotation imports, and deletions can change or remove user data. Mitigation: Preview supported changes and obtain user confirmation before destructive actions. ## Reference(s): - [MyBooks skill on ClawHub](https://clawhub.ai/poxenstudio/skills/mybooks) - [MyBooks website](https://www.mybooks.top) ## Skill Output: **Output Type(s):** [Text, Markdown, Shell commands, Configuration guidance] **Output Format:** [Natural-language responses based on MyBooks API results, with optional commands or configuration steps] **Output Parameters:** [1D] **Other Properties Related to Output:** [May save a requested voice recording as a WAV file.] ## Skill Version(s): 1.0.7 (source: ClawHub release evidence) ## Ethical Considerations: Users should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.
skill.json
{
"name": "MyBooks",
"license": "MIT-0"
}AionUi
Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!
activepieces
AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
cherry-studio
AI productivity studio with smart chat, autonomous agents, and 300+ assistants.
CopilotKit
The Frontend for Agents & Generative UI. React + Angular
Machine-readable data
The same record, as JSON, for agents and crawlers.
{
"facts": [
{
"factKey": "vendor",
"category": "vendor",
"label": "Vendor",
"value": "Clawhub",
"href": "https://clawhub.ai/poxenstudio/skills/mybooks",
"sourceUrl": "https://clawhub.ai/poxenstudio/skills/mybooks",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-10T15:39:51.485Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "OpenClaw",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-poxenstudio-mybooks/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-poxenstudio-mybooks/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-10-10T15:39:51.485Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "1.4K downloads",
"href": "https://clawhub.ai/poxenstudio/mybooks",
"sourceUrl": "https://clawhub.ai/poxenstudio/mybooks",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-10T15:39:51.485Z",
"isPublic": true
},
{
"factKey": "latest_release",
"category": "release",
"label": "Latest release",
"value": "1.0.7",
"href": "https://clawhub.ai/poxenstudio/mybooks",
"sourceUrl": "https://clawhub.ai/poxenstudio/mybooks",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-09-28T04:09:53.903Z",
"isPublic": true
},
{
"factKey": "handshake_status",
"category": "security",
"label": "Handshake status",
"value": "UNKNOWN",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-poxenstudio-mybooks/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-poxenstudio-mybooks/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true
}
],
"events": [
{
"eventType": "release",
"title": "Release 1.0.7",
"description": "- Removed the file skill-card.md, which previously provided a skill summary. - No change to skill features or behavior; this is a documentation cleanup.",
"href": "https://clawhub.ai/poxenstudio/mybooks",
"sourceUrl": "https://clawhub.ai/poxenstudio/mybooks",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-09-28T04:09:53.903Z",
"isPublic": true
}
]
}Record generated Oct 10, 2026.
