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

hoàn chỉnh, chỉnh sửa được.

Hướng dẫn này bao quát schema

chính xác cho cả hai transport (stdio cục bộ và Streamable HTTP từ xa), các lối tắt CLI , 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 2slides-mcp
   ). 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

:

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

Cấu hình của OpenClaw nằm ở

. Các MCP server đặt dưới khóa cấp cao nhất , trong một đối tượng định danh theo tên:

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

Vậy là xong — sự hiện diện của

đá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

và trường 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

:

# 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

thành công sẽ liệt kê các công cụ 2Slides (, , 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

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": ["2slides-mcp"],
        "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

.

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

→ (Fast PPT) → trả về . Với slide tùy biến thiết kế bằng hình ảnh, nó dùng và thăm dò (khoảng mỗi 20 giây) cho đến khi sẵn sàng.

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

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

trong , hoặc qua / . Cả transport stdio lẫn Streamable HTTP đều được hỗ trợ.

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

— một đối tượng định danh theo tên bên trong đối tượng cấp cao nhất. Server cục bộ dùng //; server từ xa dùng + .

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

Chạy

để 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 để 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ó.

trả về một file 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:

• OpenClaw — MCP CLI docs
• 2Slides API & MCP server