提供有声书创作与音频能力(ABS 读写、音效/音频检索、二创、音色推荐、章节角色分析等),通过 HTTP Streamable MCP 调用。
MCP 地址:https://aigc.ximalaya.com/audiobooklm/mcp
https://aigc.ximalaya.comhttps://aigc.ximalaya.com/audiobooklm/mcpAUDIOBOOKLM_TOKEN(Bearer Token)aigc.ximalaya.com。当用户首次使用本技能,或检测到未配置 token 时,OpenClaw 必须先提示以下内容,再进入工具调用:
AUDIOBOOKLM_TOKEN),再继续使用本技能。推荐提示文案(可直接复用):
使用 audiobooklm 前,请先到 https://aigc.ximalaya.com 登录并在个人中心创建 API Token,然后将 token 配置到 OpenClaw(Bearer Token / AUDIOBOOKLM_TOKEN)。配置完成后我再为你执行读取书籍、音效检索或二创操作。
{"success":false} 或 code!=20000,按失败处理并转述真实错误。请求头固定:
Accept: application/json, text/event-streamAuthorization: Bearer <AUDIOBOOKLM_TOKEN>Content-Type: application/json调用顺序(不可跳过):
initializenotifications/initializedtools/list / tools/call(都要带 mcp-session-id)若无 token 或 token 无效,服务会返回 401(invalid_token)。
共 15 个:
chapter_splitsearch_faqannotate_pinyincharacter_analyzetimber_assignsearch_sound_labelsound_effectchapter_character_analysischapter_character_predictdialogue_splitsearch_audiofan_made_audiopatch_absread_absimage_generation注意:text_writing、analysis_audio_fx、analysis_sound_description 当前不在 tools/list 中,不应路由调用。
read_absscope={"domain":"books"}scope={"domain":"book","book_id":"<id>"}scope={"domain":"chapter","book_id":"<id>","chapter_id":"<id>"}patch_absscope={"domain":"book"} 且不传 book_idread_abs(books) 取 team_id,再 patch_abs(create_book),再 patch_abs(add_chapter...)search_sound_labelsearch_audiofan_made_audioaudio_url + user_instructiontimber_assign{"description":"成熟男声","text":"..."}chapter_character_analysisdialogue_split -> chapter_character_predictimage_generation{"prompt":"..."},若下游超时按真实错误返回scope 必填对象,domain 仅可为 books|book|chapterfields 可选数组pagination 可选对象scope 必填对象,domain 为 chapter|book|booksoperations 必填数组,每项需 op_id/type/reasonbase_version 可选dry_run 可选,默认 falsequery 必填top_k 可选,默认 3user_query 必填cookie 可选audio_url 必填user_instruction 必填cookie 可选description 建议必传content_file/content_text/text/enable_ai_analysis/speaker_list/topk/rate/cookiedata 必填use_audio_fx(默认 true)、analysis_mode(默认 2)、data_mode(默认 1)content_file、filenamemax_chapter_length、handle_intro_text、enable_ai_fallback、start_chapter_number、enable_loose_patterns、ai_spliter、auto_cleanercontent_file 与 content 二选一context_window、max_window_length、scope、max_characterstext_list 或 lines 至少一项chapter_name/context_window/max_window_lengthtext_list 必填scope/max_characterscontent_file 必填max_dialogues_per_character/include_relationshipsquery 必填top_k 可选(默认 3)text 必填prompt 必填success=false):直接转述 msg,不加臆测结论。tools/list 校验后再路由,不要硬调。tools/list:确认服务在线与工具集。read_abs(scope.domain=books):验证 token 权限与团队上下文。read_abs 成功,再执行用户任务;若失败,优先提示用户检查 token 是否过期/绑定错误团队。read_abs({"scope":{"domain":"books"}}):按书名匹配 book_id。read_abs({"scope":{"domain":"book","book_id":"<id>"}}):取章节列表并定位最后一章 chapter_id。read_abs({"scope":{"domain":"chapter","book_id":"<id>","chapter_id":"<id>"}}):返回正文并生成摘要。read_abs(books) 取可用 team_id。patch_abs(create_book):scope={"domain":"book"} 且不传 book_id。patch_abs(add_chapter):对新书 book_id 添加第一章。read_abs(book) 回读验证写入结果。search_audio(user_query=用户原话)。audio_url,直接输出结果。data。sound_effect(默认 analysis_mode=2)。chapter_character_analysis。dialogue_split -> chapter_character_predict。character_analyze(注意可能耗时长,需超时提示)。# 1) initialize(记录响应头里的 mcp-session-id)
curl -i -sS -X POST "https://aigc.ximalaya.com/audiobooklm/mcp" \
-H "Accept: application/json, text/event-stream" \
-H "Authorization: Bearer ${AUDIOBOOKLM_TOKEN}" \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"openclaw","version":"1.0.0"}}}'
# 2) initialized(带 mcp-session-id)
curl -i -sS -X POST "https://aigc.ximalaya.com/audiobooklm/mcp" \
-H "Accept: application/json, text/event-stream" \
-H "Authorization: Bearer ${AUDIOBOOKLM_TOKEN}" \
-H "Content-Type: application/json" \
-H "mcp-session-id: <session-id>" \
-d '{"jsonrpc":"2.0","method":"notifications/initialized","params":{}}'
# 3) tools/list(带 mcp-session-id)
curl -i -sS -X POST "https://aigc.ximalaya.com/audiobooklm/mcp" \
-H "Accept: application/json, text/event-stream" \
-H "Authorization: Bearer ${AUDIOBOOKLM_TOKEN}" \
-H "Content-Type: application/json" \
-H "mcp-session-id: <session-id>" \
-d '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}'
ZIP package — ready to use