2Slides Logo
Cách Dùng OpenClaw Với 2Slides MCP Server (Hướng Dẫn 2026)
2Slides Team
8 min read

Cách Dùng OpenClaw Với 2Slides MCP Server (Hướng Dẫn 2026)

Trả lời nhanh (≤60 từ): OpenClaw có thể tạo file PowerPoint thật bằng cách thêm 2Slides MCP server dưới khóa mcp.servers trong ~/.openclaw/openclaw.json. Lấy key tại 2slides.com/api, thêm một server stdio (command: "npx", args: ["2slides-mcp"], env.API_KEY) hoặc một server từ xa (url + transport: "streamable-http"), rồi yêu cầu agent OpenClaw của bạn dựng bộ slide.

OpenClaw là một framework AI agent mã nguồn mở, và nó là một Model Context Protocol (MCP) client đầy đủ. Gắn 2Slides MCP server vào và mọi agent OpenClaw có thêm khả năng biến một bản tóm tắt yêu cầu — hoặc một tài liệu mà nó có thể đọc — thành một file .pptx hoàn chỉnh, chỉnh sửa được.

Hướng dẫn này bao quát schema openclaw.json chính xác cho cả hai transport (stdio cục bộ và Streamable HTTP từ xa), các lối tắt CLI openclaw mcp, cách các công cụ MCP hiện ra trong tool profile của agent, và cách kiểm tra mọi thứ bằng một lần probe trực tiếp.

Tại sao trao cho OpenClaw server 2Slides?

Agent OpenClaw suy luận, lập kế hoạch và đọc file của bạn. Chúng không kết xuất file slide nhị phân — đó là việc của một bộ tạo chuyên dụng. Với 2Slides được gắn vào:

  • OpenClaw quyết định cấu trúc slide, câu chữ và mạch nội dung từ tài liệu nguồn của bạn.
  • 2Slides MCP server tạo ra PowerPoint thực sự — Fast PPT dựa trên theme, hoặc slide thiết kế bằng hình ảnh kèm thuyết minh giọng AI tùy chọn và một gói tài nguyên xuất được.

Bạn cần gì trước tiên

  1. Đã cài OpenClaw (openclaw có trong PATH).
  2. Một 2Slides API key từ 2slides.com/api.
  3. Node.js cho transport stdio (npx -y 2slides-mcp@latest). Transport HTTP không cần gì cài cục bộ.

Stdio hay Streamable HTTP: chọn transport nào?

2Slides MCP server hỗ trợ cả hai. Trong OpenClaw, hai cách được phân biệt đơn giản bằng việc bạn đặt trường nào — không có trường type:

Stdio (cục bộ)Streamable HTTP (từ xa)
Trường nhận diệnCó commandCó url
Trường transportkhông áp dụngtransport: "streamable-http"
Node.js cục bộBắt buộcKhông bắt buộc
Phù hợp nhất choAgent cục bộ, toàn quyền kiểm soátAgent từ xa/được host, CI

Phương pháp 1: stdio trong openclaw.json

Cấu hình của OpenClaw nằm ở ~/.openclaw/openclaw.json. Các MCP server đặt dưới khóa cấp cao nhất mcp, trong một đối tượng servers định danh theo tên:

{ "mcp": { "servers": { "2slides": { "command": "npx", "args": ["-y", "2slides-mcp@latest"], "env": { "API_KEY": "YOUR_2SLIDES_API_KEY" } } } } }

Vậy là xong — sự hiện diện của command đánh dấu nó là một server stdio cục bộ.

Phương pháp 2: Streamable HTTP trong openclaw.json

Với endpoint được host, đặt url và trường transport chuẩn:

{ "mcp": { "servers": { "2slides": { "url": "https://2slides.com/api/mcp?apikey=YOUR_2SLIDES_API_KEY", "transport": "streamable-http" } } } }

Lưu ý: Giá trị transport chuẩn của OpenClaw là "streamable-http" (một bí danh cũ type: "http" được chấp nhận nhưng sẽ bị chuẩn hóa đi — hãy viết transport). Nếu key của bạn nên nằm trong một header thay vì URL, hãy dùng "headers": { "Authorization": "Bearer YOUR_2SLIDES_API_KEY" } thay cho query ?apikey=.

Hoặc dùng CLI openclaw mcp

Những lệnh này ghi vào cùng cấu hình 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"}'

Kiểm tra kết nối

OpenClaw đi kèm các công cụ chẩn đoán MCP chuyên dụng:

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

Một lần probe thành công sẽ liệt kê các công cụ 2Slides (slides_generate, themes_search, và phần còn lại), xác nhận agent có thể gọi chúng.

Các công cụ đến với agent của bạn như thế nào

Các công cụ MCP đã cấu hình được phơi bày tự động trong tool profile coding và messaging của OpenClaw. Lưu ý:

  • Profile minimal ẩn các công cụ MCP; hãy đổi profile nếu bạn không thấy chúng.
  • Để tắt công cụ MCP một cách tường minh, thêm "bundle-mcp" vào tools.deny.
  • Để chỉ phơi bày một số công cụ 2Slides, dùng toolFilter.include / toolFilter.exclude theo từng server (tên chính xác hoặc glob *):
{ "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"] } } } } }

Để giữ một server được định nghĩa nhưng không hoạt động, đặt "enabled": false.

Tạo bộ slide đầu tiên của bạn

Hãy yêu cầu agent OpenClaw của bạn bằng ngôn ngữ đời thường:

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 gọi themes_search → slides_generate (Fast PPT) → trả về downloadUrl. Với slide tùy biến thiết kế bằng hình ảnh, nó dùng slides_create_pdf_slides và thăm dò jobs_get (khoảng mỗi 20 giây) cho đến khi sẵn sàng.

Bộ công cụ của 2Slides MCP

Công cụChức năngCredit
themes_searchTìm một themeId cho Fast PPTMiễn phí
slides_generatePowerPoint dựa trên theme (Fast PPT), đồng bộ/bất đồng bộ10 / trang
slides_create_pdf_slidesSlide tùy biến thiết kế bằng hình ảnh từ văn bản (Nano Banana)100 / trang (1K/2K), 200 (4K)
slides_create_like_thisSlide khớp phong cách của một ảnh tham chiếu100 / trang (1K/2K), 200 (4K)
slides_generate_narrationThêm thuyết minh giọng AI vào một job Nano Banana210 / trang
slides_download_slides_pages_voicesXuất các trang + âm thanh thành một file ZIPMiễn phí
jobs_getThăm dò một job bất đồng bộ đến khi hoàn tấtMiễn phí

Lỗi thường gặp và xử lý sự cố

  • Dùng mcpServers thay vì mcp.servers. Trong cấu hình OpenClaw, khóa là mcp.servers. (mcpServers là một khái niệm khác, dành cho client bên ngoài — chạy OpenClaw với tư cách một server.)
  • Viết type thay vì transport. type là một bí danh cũ; trường chuẩn là transport: "streamable-http".
  • Công cụ không xuất hiện. Có thể bạn đang ở profile minimal, hoặc tools.deny chứa bundle-mcp. Hãy chuyển sang coding/messaging và chạy openclaw mcp reload.
  • Server stdio không khởi động. Xác nhận Node.js đã được cài và API_KEY được đặt trong env.
  • Thăm dò job bất đồng bộ. Hãy để agent thăm dò jobs_get mỗi ~20s; job Nano Banana và thuyết minh là bất đồng bộ theo mặc định.

Câu hỏi thường gặp

OpenClaw có hỗ trợ MCP server tùy chỉnh không?

Có. OpenClaw là một MCP client gốc. Thêm server dưới khóa mcp.servers trong ~/.openclaw/openclaw.json, hoặc qua openclaw mcp add / openclaw mcp set. Cả transport stdio lẫn Streamable HTTP đều được hỗ trợ.

Khóa cấu hình cho MCP server trong OpenClaw là gì?

mcp.servers — một đối tượng định danh theo tên bên trong đối tượng mcp cấp cao nhất. Server cục bộ dùng command/args/env; server từ xa dùng url + transport: "streamable-http".

Làm sao tôi xác nhận 2Slides đã kết nối?

Chạy openclaw mcp probe 2slides --json để có một kết nối trực tiếp liệt kê các công cụ được phơi bày, hoặc openclaw mcp doctor 2slides --probe để kiểm tra tĩnh kèm một bài kiểm tra kết nối.

Cái này có tạo ra một PowerPoint thật không?

Có. slides_generate trả về một file .pptx chỉnh sửa được; các công cụ Nano Banana trả về bộ slide thiết kế bằng hình ảnh kèm thuyết minh AI tùy chọn và một gói xuất được.

Tôi lấy key và cấu hình ở đâu?

Tại 2slides.com/api?tab=mcp — key của bạn, một cấu hình để dán sẵn, và endpoint Streamable HTTP.

Điểm mấu chốt

Một mục mcp.servers trong openclaw.json trao cho mọi agent OpenClaw một bộ tạo slide. Stdio cho cục bộ, transport: "streamable-http" cho từ xa — rồi openclaw mcp probe để chứng minh nó hoạt động.

Để có bối cảnh rộng hơn, hãy xem cách MCP đang thay đổi quy trình làm slide và bản đồ hệ sinh thái PowerPoint MCP server. So sánh các agent? Xem cách dùng Claude Code và OpenAI Codex với cùng server này.

Lấy key và cấu hình của bạn tại 2slides.com/api?tab=mcp và trao cho agent OpenClaw của bạn con đường một câu đến một bộ slide hoàn chỉnh.

Nguồn:

About 2Slides

Create stunning AI-powered presentations in seconds. Transform your ideas into professional slides with 2slides AI Agent.

Try For Free