2Slides Team
4 min read
如何在 OpenClaw 中使用 2Slides MCP 服务器（2026 指南）
快速答案（≤60 字）： OpenClaw 只要在
~/.openclaw/openclaw.json的mcp.servers键下加入 2Slides MCP 服务器，就能生成真正的 PowerPoint 文件。先到 2slides.com/api 取得密钥，添加一个 stdio 服务器（command: "npx"、args: ["2slides-mcp"]、env.API_KEY）或一个远程服务器（url+transport: "streamable-http"），然后让你的 OpenClaw 代理做一份演示文稿即可。
OpenClaw 是一个开源 AI 代理框架，同时也是一个完整的 Model Context Protocol（MCP）客户端。接入 2Slides MCP 服务器，任何 OpenClaw 代理都能把一份简报——或一个它能读取的文档——变成一份成品、可编辑的 .pptx。
本指南涵盖两种传输方式（本地 stdio 和远程 Streamable HTTP）的具体 openclaw.json schema、openclaw mcp CLI 快捷方式、MCP 工具如何呈现到代理的工具配置档（tool profiles）中，以及如何用实时探测来验证一切。
为什么要给 OpenClaw 配上 2Slides 服务器？
OpenClaw 代理会推理、规划、读取你的文件。它们不渲染二进制的幻灯片文件——那是专门的生成器的活儿。接上 2Slides 后：
- OpenClaw 根据你的源材料决定幻灯片结构、文案和叙事。
- 2Slides MCP 服务器 产出真正的 PowerPoint——基于主题的 Fast PPT，或图片设计型幻灯片，可选 AI 语音配音和可导出的素材包。
你需要先准备什么
- 已安装的 OpenClaw（
openclaw在你的 PATH 中）。 - 一个来自 2slides.com/api 的 2Slides API 密钥。
- Node.js，用于 stdio 传输（
npx -y 2slides-mcp@latest）。HTTP 传输无需任何本地依赖。
Stdio 还是 Streamable HTTP：该选哪种传输？
2Slides MCP 服务器两者都支持。在 OpenClaw 中，二者仅靠你设置了哪些字段来区分——没有 type 字段：
| Stdio（本地） | Streamable HTTP（远程） | |
|---|---|---|
| 标识字段 | 存在 command | 存在 url |
| 传输字段 | 不适用 | transport: "streamable-http" |
| 本地 Node.js | 需要 | 不需要 |
| 适用场景 | 本地代理、完全可控 | 远程/托管代理、CI |
方法一：在 openclaw.json 中配置 stdio
OpenClaw 的配置位于 ~/.openclaw/openclaw.json。MCP 服务器放在顶层 mcp 键下，写在一个以名称为键的 servers 对象里：
{
"mcp": {
"servers": {
"2slides": {
"command": "npx",
"args": ["-y", "2slides-mcp@latest"],
"env": { "API_KEY": "YOUR_2SLIDES_API_KEY" }
}
}
}
}就这样——command 的存在就把它标记为一个本地 stdio 服务器。
方法二：在 openclaw.json 中配置 Streamable HTTP
对于托管端点，设置 url 和规范的 transport 字段：
{
"mcp": {
"servers": {
"2slides": {
"url": "https://2slides.com/api/mcp?apikey=YOUR_2SLIDES_API_KEY",
"transport": "streamable-http"
}
}
}
}注意： OpenClaw 的规范传输值是
"streamable-http"（旧的type: "http"别名会被接受，但会被归一化掉——请写transport）。如果你的密钥应放在请求头而非 URL 中，就用"headers": { "Authorization": "Bearer YOUR_2SLIDES_API_KEY" }代替?apikey=查询参数。
或使用 openclaw mcp CLI
这些命令写入同一份 mcp.servers 配置：
# stdio
openclaw mcp add 2slides --command npx --arg 2slides-mcp --env API_KEY=YOUR_2SLIDES_API_KEY
# remote (set the full server object as JSON)
openclaw mcp set 2slides '{"url":"https://2slides.com/api/mcp?apikey=YOUR_2SLIDES_API_KEY","transport":"streamable-http"}'验证连接
OpenClaw 自带专门的 MCP 诊断工具：
openclaw mcp status --verbose # resolved transport/auth/timeouts (static, no connection)
openclaw mcp doctor 2slides --probe # static checks, then a live connection test
openclaw mcp probe 2slides --json # connect live and list the exposed tools
openclaw mcp reload # drop cached in-process MCP runtimesprobe 成功后会列出 2Slides 的工具（slides_generate、themes_search 等），确认代理可以调用它们。
工具如何到达你的代理
已配置的 MCP 工具会自动暴露在 OpenClaw 的 coding 和 messaging 工具配置档中。注意事项：
minimal配置档会隐藏 MCP 工具；如果你看不到它们，请切换配置档。- 要显式禁用 MCP 工具，在
tools.deny中加入"bundle-mcp"。 - 要只暴露部分 2Slides 工具，使用每个服务器的
toolFilter.include/toolFilter.exclude（精确名称或*通配符）：
{
"mcp": {
"servers": {
"2slides": {
"command": "npx",
"args": ["-y", "2slides-mcp@latest"],
"env": { "API_KEY": "YOUR_2SLIDES_API_KEY" },
"toolFilter": { "include": ["themes_search", "slides_generate", "jobs_get"] }
}
}
}
}想保留某个服务器的定义但让它处于非激活状态，设置 "enabled": false。
生成你的第一份演示文稿
用日常语言向你的 OpenClaw 代理提要求：
Read PROJECT_BRIEF.md and generate an 8-slide overview deck.
Find a clean "minimal" theme from 2slides first, then create
the PowerPoint and give me the download link.OpenClaw 会调用 themes_search → slides_generate（Fast PPT）→ 返回 downloadUrl。对于自定义的图片设计型幻灯片，它会使用 slides_create_pdf_slides，并轮询 jobs_get（大约每 20 秒一次）直到就绪。
2Slides MCP 工具列表
| 工具 | 作用 | 积分 |
|---|---|---|
themes_search | 为 Fast PPT 查找 themeId | 免费 |
slides_generate | 基于主题的 PowerPoint（Fast PPT），同步/异步 | 10 / 页 |
slides_create_pdf_slides | 由文字生成自定义图片设计型幻灯片（Nano Banana） | 100 / 页 (1K/2K), 200 (4K) |
slides_create_like_this | 匹配参考图片风格的幻灯片 | 100 / 页 (1K/2K), 200 (4K) |
slides_generate_narration | 为 Nano Banana 任务添加 AI 语音配音 | 210 / 页 |
slides_download_slides_pages_voices | 把页面 + 音频导出为 ZIP | 免费 |
jobs_get | 轮询异步任务直到完成 | 免费 |
常见错误与排错
- 用了
mcpServers而不是mcp.servers。 在 OpenClaw 配置中，键是mcp.servers。（mcpServers是一个不同的、面向外部客户端的概念——指把 OpenClaw 当作 服务器来运行。） - 写了
type而不是transport。type是一个旧别名；规范字段是transport: "streamable-http"。 - 工具没出现。 你很可能在
minimal配置档上，或者tools.deny里含有bundle-mcp。切换到coding/messaging，并运行openclaw mcp reload。 - stdio 服务器启动不了。 确认已安装 Node.js，且
env中设置了API_KEY。 - 轮询异步任务。 让代理大约每 20 秒轮询一次
jobs_get；Nano Banana 和配音任务默认是异步的。
常见问题
OpenClaw 支持自定义 MCP 服务器吗？
支持。OpenClaw 是一个原生 MCP 客户端。在 ~/.openclaw/openclaw.json 的 mcp.servers 键下添加服务器，或通过 openclaw mcp add / openclaw mcp set 添加。stdio 和 Streamable HTTP 传输都受支持。
OpenClaw 中 MCP 服务器的配置键是什么？
mcp.servers——顶层 mcp 对象内的一个以名称为键的对象。本地服务器使用 command/args/env；远程服务器使用 url + transport: "streamable-http"。
我怎么确认 2Slides 已连上？
运行 openclaw mcp probe 2slides --json 进行一次实时连接并列出暴露的工具，或运行 openclaw mcp doctor 2slides --probe 做静态检查外加一次连接测试。
它会生成真正的 PowerPoint 吗？
会。slides_generate 返回一个可编辑的 .pptx；Nano Banana 工具返回图片设计型演示文稿，可选 AI 配音和可导出的素材包。
密钥和配置在哪里获取？
在 2slides.com/api?tab=mcp——你的密钥、一份可复制粘贴的配置，以及 Streamable HTTP 端点。
要点总结
在
openclaw.json里加一条mcp.servers条目，就给每个 OpenClaw 代理配上了一个幻灯片生成器。本地用 stdio，远程用transport: "streamable-http"——然后用openclaw mcp probe证明它能用。
要了解更广的背景，参见 MCP 如何改变演示文稿工作流 和 PowerPoint MCP 服务器生态地图。想对比不同代理？参见用同一个服务器的 如何使用 Claude Code 和 OpenAI Codex。
到 2slides.com/api?tab=mcp 取得你的密钥和配置，给你的 OpenClaw 代理一条通往成品演示文稿的一句话路径。
来源：
About 2Slides
Create stunning AI-powered presentations in seconds. Transform your ideas into professional slides with 2slides AI Agent.
Try For Free
