audiobooklm

# audiobooklm 技能说明（OpenClaw）

MCP 地址：`https://aigc.ximalaya.com/audiobooklm/mcp`

## 安装前注意事项（发布到 ClawHub 必带）

1. 来源与信任
- 官方入口：`https://aigc.ximalaya.com`
- MCP 服务地址：`https://aigc.ximalaya.com/audiobooklm/mcp`
- 仅在你信任该域名与发布方时安装。

2. 凭证配置
- 必需环境变量：`AUDIOBOOKLM_TOKEN`（Bearer Token）
- 建议使用测试账号或低权限 token，不要粘贴高权限生产 token。
- 建议定期轮换 token；发现泄露立即吊销并重建。

3. 数据外发与合规
- 使用本技能时，输入文本、音频 URL、以及你提交的结构化数据会发送到 `aigc.ximalaya.com`。
- 不要上传未授权、涉密或敏感个人信息内容。
- 版权或隐私不明确的内容，先确认授权后再调用。

## 0. 首次使用引导（OpenClaw 必须先提示）

当用户首次使用本技能，或检测到未配置 token 时，OpenClaw 必须先提示以下内容，再进入工具调用：

1. 请先访问 [https://aigc.ximalaya.com](https://aigc.ximalaya.com) 注册/登录账号。
2. 进入个人中心创建 API Token（MCP / API Token）。
3. 在 OpenClaw 配置 Bearer Token（`AUDIOBOOKLM_TOKEN`），再继续使用本技能。

推荐提示文案（可直接复用）：
`使用 audiobooklm 前，请先到 https://aigc.ximalaya.com 登录并在个人中心创建 API Token，然后将 token 配置到 OpenClaw（Bearer Token / AUDIOBOOKLM_TOKEN）。配置完成后我再为你执行读取书籍、音效检索或二创操作。`

## 1. 使用规则（必须遵守）

1. 所有书籍/章节/音频/音效结论都必须来自本轮真实工具返回，禁止编造。
2. 调用成功不等于业务成功：若工具返回文本里包含 `{"success":false}` 或 `code!=20000`，按失败处理并转述真实错误。
3. 禁止输出原始大段 JSON 给用户，需整理为自然语言；但不得改写关键事实（标题、ID、URL、错误信息）。

## 2. 鉴权与会话（标准 MCP 流程）

请求头固定：
- `Accept: application/json, text/event-stream`
- `Authorization: Bearer <AUDIOBOOKLM_TOKEN>`
- `Content-Type: application/json`

调用顺序（不可跳过）：
1. `initialize`
2. `notifications/initialized`
3. `tools/list` / `tools/call`（都要带 `mcp-session-id`）

若无 token 或 token 无效，服务会返回 `401`（`invalid_token`）。

## 3. 现网工具清单

共 15 个：
- `chapter_split`
- `search_faq`
- `annotate_pin...