2Slides Team
4 min read
如何將 OpenClaw 串接 2Slides MCP Server（2026 完整指南）
快速解答（≤60 字）： OpenClaw 只要在
~/.openclaw/openclaw.json的mcp.servers鍵下加上 2Slides MCP server，就能產生真正的 PowerPoint 檔案。先到 2slides.com/api 取得 key，加上一個 stdio server（command: "npx"、args: ["2slides-mcp"]、env.API_KEY）或一個遠端 server（url+transport: "streamable-http"），接著請你的 OpenClaw 代理做一份簡報即可。
OpenClaw 是一套開源 AI 代理框架，也是一個完整的 Model Context Protocol（MCP）用戶端。接上 2Slides MCP server，任何 OpenClaw 代理就能把一份簡報需求 —— 或一份它讀得到的文件 —— 變成完成、可編輯的 .pptx。
本指南涵蓋兩種傳輸方式的精確 openclaw.json schema（本機 stdio 與遠端 Streamable HTTP）、openclaw mcp CLI 捷徑、MCP 工具如何浮現到代理的工具設定檔，以及如何用即時探測來驗證一切。
為什麼要給 OpenClaw 接上 2Slides server？
OpenClaw 代理會推理、規劃並讀取你的檔案。它們不負責渲染二進位投影片檔案 —— 那是專屬生成器的工作。接上 2Slides 後：
- OpenClaw 根據你的原始素材，決定投影片結構、文案與敘事。
- 2Slides MCP server 產出實際的 PowerPoint —— 主題式的 Fast PPT，或是以圖像設計、可選配 AI 語音旁白與可匯出素材包的投影片。
你需要先準備什麼
- 已安裝的 OpenClaw（
openclaw已在你的 PATH 中）。 - 一組 2Slides API key，到 2slides.com/api 取得。
- Node.js，供 stdio 傳輸使用（
npx -y 2slides-mcp@latest）。HTTP 傳輸不需要任何本機相依套件。
Stdio 還是 Streamable HTTP：該選哪種傳輸方式？
2Slides MCP server 兩種都支援。在 OpenClaw 中，兩者單純靠你設定哪些欄位來區分 —— 這裡沒有 type 欄位：
| Stdio（本機） | Streamable HTTP（遠端） | |
|---|---|---|
| 辨識欄位 | 出現 command | 出現 url |
| 傳輸欄位 | 不適用 | transport: "streamable-http" |
| 本機 Node.js | 必要 | 不必要 |
| 適用情境 | 本機代理、完全掌控 | 遠端／託管代理、CI |
方法一：在 openclaw.json 設定 stdio
OpenClaw 的設定檔位於 ~/.openclaw/openclaw.json。MCP server 放在頂層的 mcp 鍵下，置於一個以名稱為鍵的 servers 物件裡：
{
"mcp": {
"servers": {
"2slides": {
"command": "npx",
"args": ["-y", "2slides-mcp@latest"],
"env": { "API_KEY": "YOUR_2SLIDES_API_KEY" }
}
}
}
}就這樣 —— 出現 command 就標示它是一個本機 stdio server。
方法二：在 openclaw.json 設定 Streamable HTTP
對於託管端點，設定 url 與正規的 transport 欄位：
{
"mcp": {
"servers": {
"2slides": {
"url": "https://2slides.com/api/mcp?apikey=YOUR_2SLIDES_API_KEY",
"transport": "streamable-http"
}
}
}
}注意： OpenClaw 的正規 transport 值是
"streamable-http"（也接受舊版的type: "http"別名，但會被正規化掉 —— 請寫transport）。如果你的 key 該放在標頭而非 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 runtimes成功的 probe 會列出 2Slides 的工具（slides_generate、themes_search 等等），證明代理能夠呼叫它們。
這些工具如何進到你的代理
設定好的 MCP 工具會自動暴露在 OpenClaw 的 coding 與 messaging 工具設定檔中。注意事項：
minimal設定檔會隱藏 MCP 工具；如果你看不到它們，請切換設定檔。- 若要明確停用 MCP 工具，請把
"bundle-mcp"加進tools.deny。 - 若只想暴露部分 2Slides 工具，請使用每個 server 的
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"] }
}
}
}
}若要保留 server 的定義但讓它維持停用，請設定 "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 當成 server 來執行。） - 寫了
type而非transport。type是舊版別名；正規欄位是transport: "streamable-http"。 - 工具沒出現。 你很可能在
minimal設定檔上，或tools.deny含有bundle-mcp。切換到coding／messaging並執行openclaw mcp reload。 - stdio server 啟動不了。 確認已安裝 Node.js，且
API_KEY已設在env中。 - 輪詢非同步工作。 讓代理每隔約 20 秒輪詢
jobs_get；Nano Banana 與旁白工作預設為非同步。
常見問題
OpenClaw 支援自訂 MCP server 嗎？
支援。OpenClaw 是原生的 MCP 用戶端。在 ~/.openclaw/openclaw.json 的 mcp.servers 鍵下新增 server，或透過 openclaw mcp add / openclaw mcp set。stdio 與 Streamable HTTP 傳輸都支援。
OpenClaw 裡 MCP server 的設定鍵是什麼？
mcp.servers —— 頂層 mcp 物件內、以名稱為鍵的物件。本機 server 用 command／args／env；遠端 server 用 url + transport: "streamable-http"。
我要怎麼確認 2Slides 已連上？
執行 openclaw mcp probe 2slides --json 進行即時連線並列出暴露的工具，或執行 openclaw mcp doctor 2slides --probe 進行靜態檢查加連線測試。
它會產生真正的 PowerPoint 嗎？
會。slides_generate 回傳可編輯的 .pptx；Nano Banana 工具回傳以圖像設計的簡報，並可選配 AI 旁白與可匯出的素材包。
key 和設定要去哪裡取得？
到 2slides.com/api?tab=mcp —— 你的 key、一份可直接貼上的設定，以及 Streamable HTTP 端點。
重點整理
在
openclaw.json加上一筆mcp.servers設定，就能讓每個 OpenClaw 代理擁有一個投影片生成器。本機用 stdio、遠端用transport: "streamable-http"—— 接著用openclaw mcp probe證明它運作正常。
想看更廣的脈絡，請參閱 MCP 如何改變簡報工作流程 以及 PowerPoint MCP server 生態地圖。在比較不同代理？請參閱用同一個 server 的 如何使用 Claude Code 與 OpenAI Codex。
到 2slides.com/api?tab=mcp 取得你的 key 與設定，給你的 OpenClaw 代理一條一句話直達完成簡報的路徑。
來源：
About 2Slides
Create stunning AI-powered presentations in seconds. Transform your ideas into professional slides with 2slides AI Agent.
Try For Free
