2Slides Logo
如何將 OpenClaw 串接 2Slides MCP Server(2026 完整指南)
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 語音旁白與可匯出素材包的投影片。

你需要先準備什麼

  1. 已安裝的 OpenClaw
    openclaw
    已在你的 PATH 中)。
  2. 一組 2Slides API key,到 2slides.com/api 取得。
  3. Node.js,供 stdio 傳輸使用(
    npx 2slides-mcp
    )。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": ["2slides-mcp"], "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": ["2slides-mcp"], "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_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 CodeOpenAI 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