Tác nhân AI của bạn phải có khả năng lấy ghi chú cuộc họp thứ Ba tuần trước mà không cần bạn phải đào bới qua các thư mục. Với API của ScreenApp và Model Context Protocol (MCP), bạn có thể cấp quyền truy cập trực tiếp cho các tác nhân OpenClaw vào các bản ghi, bản chép lời và tóm tắt AI của mình.

Hướng dẫn này trình bày cách xây dựng một kỹ năng máy chủ ScreenApp MCP để tác nhân OpenClaw của bạn có thể tìm kiếm các bản ghi, lấy bản chép lời và chạy phân tích AI trên nội dung của bạn, tất cả chỉ từ một tin nhắn trò chuyện trên Telegram, WhatsApp hoặc Discord.

Nếu bạn mới sử dụng máy chủ MCP cho các bản ghi cuộc họp, hãy xem so sánh các máy chủ MCP tốt nhất cho cuộc họp của chúng tôi để xem ScreenApp hoạt động như thế nào.

OpenClaw là gì?

OpenClaw là một cổng tự lưu trữ kết nối các ứng dụng nhắn tin (WhatsApp, Telegram, Discord, iMessage) với các tác nhân mã hóa AI. Bạn chạy một quy trình duy nhất trên máy của mình và nó sẽ kết nối các ứng dụng trò chuyện của bạn với một trợ lý AI luôn sẵn sàng.

Ý tưởng chính: bạn nhắn tin cho tác nhân của mình từ điện thoại, và nó có thể sử dụng các công cụ, đọc tệp, duyệt web, và giờ đây, truy cập các bản ghi ScreenApp của bạn.

OpenClaw sử dụng kỹ năng để dạy các tác nhân cách sử dụng công cụ. Mỗi kỹ năng là một thư mục có tệp SKILL.md mô tả các lệnh có sẵn. Kỹ năng cũng có thể bao bọc các máy chủ MCP, đó là cách chúng ta sẽ kết nối ScreenApp.

OpenClaw khám phá các kỹ năng thông qua một hệ thống ba tầng. Khi bắt đầu phiên, tác nhân sẽ quét name và description từ phần frontmatter của mỗi kỹ năng. Khi một kỹ năng có vẻ phù hợp, nó sẽ tải toàn bộ SKILL.md. Điều này có nghĩa là trường mô tả của bạn là yếu tố quan trọng nhất quyết định việc tác nhân có chọn kỹ năng của bạn hay không. Hãy viết nó như thể bạn đang nói với đồng nghiệp về công dụng của kỹ năng và khi nào nên sử dụng nó.

MCP là gì?

Model Context Protocol là một tiêu chuẩn do Anthropic tạo ra cho phép các mô hình AI truy cập các nguồn dữ liệu bên ngoài. Hãy hình dung nó như USB-C cho các ứng dụng AI. Thay vì sao chép-dán bản chép lời vào ChatGPT, một máy chủ MCP cho phép AI kéo trực tiếp những gì nó cần.

Các máy chủ MCP chạy cục bộ và hiển thị công cụ (các hành động AI có thể thực hiện) và tài nguyên (dữ liệu AI có thể đọc). Đối với ScreenApp, các công cụ sẽ bao gồm những thứ như “tìm kiếm bản ghi,” “lấy bản chép lời,” và “đặt câu hỏi về video.”

MCP hoạt động với Claude Desktop, ChatGPT Desktop, Cursor, và thông qua OpenClaw, bất kỳ ứng dụng nhắn tin nào.

Tổng quan về API của ScreenApp

ScreenApp cung cấp một API REST bao gồm mọi thứ bạn cần cho việc tích hợp MCP. Các điểm cuối chính:

• Liệt kê các bản ghi - Duyệt thư viện bản ghi của bạn với các bộ lọc
• Lấy bản ghi kèm bản chép lời - Lấy một bản ghi và bản chép lời đầy đủ của nó, với dấu thời gian và nhãn người nói
• Phân tích AI - Đặt câu hỏi về một bản ghi bằng cách sử dụng điểm cuối phân tích đa phương tiện (/v2/files/{fileId}/ask/multimodal)
• Tìm kiếm - Tìm bản ghi theo từ khóa trên tất cả nội dung của bạn
• Tải lên - Gửi tệp âm thanh/video mới để xử lý

Xác thực sử dụng mã thông báo Bearer. Bạn tạo mã thông báo API từ cài đặt tài khoản ScreenApp của mình.

Để biết tài liệu tham khảo đầy đủ, hãy xem tài liệu API của ScreenApp.

Các bước thiết lập

1. Lấy mã thông báo API ScreenApp của bạn

Đăng nhập vào ScreenApp, đi tới Cài đặt > API, và tạo một mã thông báo mới. Sao chép nó ở một nơi an toàn. Bạn sẽ cần nó trong bước tiếp theo.

2. Tạo thư mục kỹ năng

Các kỹ năng của OpenClaw nằm trong ~/.openclaw/skills/ (chia sẻ giữa các tác nhân) hoặc trong thư mục /skills/ của không gian làm việc của bạn (mỗi tác nhân một thư mục). Tên thư mục kỹ năng phải khớp với trường name trong phần frontmatter của tệp SKILL.md của bạn. Tạo cấu trúc đầy đủ:

mkdir -p ~/.openclaw/skills/screenapp/references

Bố cục thư mục cuối cùng:

screenapp/
├── SKILL.md              # Bắt buộc: frontmatter + hướng dẫn tác nhân
├── claw.json             # Dành cho việc xuất bản lên ClawHub (tùy chọn)
└── references/
    └── api-endpoints.md  # Tài liệu chi tiết về điểm cuối được tải theo yêu cầu

3. Viết tệp SKILL.md

Trường description là yếu tố quyết định liệu tác nhân có chọn kỹ năng này hay không. OpenClaw quét name và description của mọi kỹ năng đã cài đặt khi bắt đầu mỗi phiên. Bao gồm các cụm từ kích hoạt và biến thể từ khóa để tác nhân khớp nó với các yêu cầu về bản ghi, cuộc họp, bản ghi âm và ghi chú.

Tạo tệp ~/.openclaw/skills/screenapp/SKILL.md:

---
name: screenapp
description: Tìm kiếm bản ghi và bản chép lời cuộc họp, lấy ghi chú cuộc họp và các mục hành động, chép lời âm thanh và video, hỏi AI các câu hỏi về nội dung đã ghi. Sử dụng khi người dùng đề cập đến chép lời, ghi chú cuộc họp, bản ghi âm, chuyển đổi âm thanh sang văn bản, chuyển đổi lời nói sang văn bản, tìm kiếm cuộc họp, hoặc muốn tìm hoặc phân tích các cuộc họp và cuộc gọi đã ghi.
metadata: {"clawdbot":{"emoji":"","requires":{"env":["SCREENAPP_API_TOKEN"]},"primaryEnv":"SCREENAPP_API_TOKEN","homepage":"https://screenapp.io"}}
---

# Tích hợp ScreenApp

Truy cập bản ghi âm, bản chép lời và phân tích AI của người dùng trên ScreenApp.

## Xác thực

Tất cả các yêu cầu đều cần biến môi trường SCREENAPP_API_TOKEN.

Tiêu đề: Authorization: Bearer $SCREENAPP_API_TOKEN
URL cơ sở: https://api.screenapp.io

## Các hành động có sẵn

#

## Tìm kiếm bản ghi theo từ khóa
GET /v2/files?searchQuery={query}

Sử dụng tính năng này khi người dùng muốn tìm một cuộc họp, bản ghi hoặc chủ đề cụ thể.

#

## Lấy một bản ghi kèm theo bản chép lời
GET /v2/files/{fileId}

Trả về đối tượng bản ghi đầy đủ bao gồm bản chép lời có dấu thời gian với nhãn người nói. Sử dụng tính năng này để truy xuất ghi chú cuộc họp, đọc lại những gì đã nói hoặc lấy toàn bộ văn bản của một cuộc gọi.

#

## Hỏi AI một câu hỏi về bản ghi
POST /v2/files/{fileId}/ask/multimodal
Body: { "promptText": "câu hỏi của bạn ở đây" }

Phân tích cả bản chép lời và nội dung video. Sử dụng tính năng này để tóm tắt các cuộc họp, trích xuất các mục hành động hoặc trả lời các câu hỏi cụ thể về những gì đã xảy ra trong một bản ghi.

#

## Liệt kê các bản ghi gần đây
GET /v2/files?sortBy=createdAt&sortOrder=desc&limit=10

Sử dụng tính năng này khi người dùng hỏi về các cuộc họp mới nhất hoặc các bản ghi gần đây của họ.

Tùy chọn, tạo `references/api-endpoints.md` với tài liệu thông số chi tiết hơn. Tác nhân chỉ tải các tệp tham chiếu khi cần, giữ cho việc quét kỹ năng ban đầu nhẹ nhàng.

#

## 4. Đặt mã thông báo API

Thêm mã thông báo ScreenApp của bạn vào môi trường của OpenClaw. Chỉnh sửa `~/.openclaw/openclaw.json`:

```json
{
  "env": {
    "SCREENAPP_API_TOKEN": "mã-thông-báo-của-bạn-ở-đây"
  }
}

Hoặc xuất nó trong hồ sơ shell của bạn nếu bạn thích.

5. Khởi động lại OpenClaw

openclaw gateway restart

Đặc vụ sẽ nhận được kỹ năng mới trong phiên làm việc tiếp theo. Bạn có thể xác minh nó đã được tải bằng cách hỏi đặc vụ của bạn: “Bạn có những kỹ năng nào?“

6. Kiểm tra

Gửi một tin nhắn tới đặc vụ OpenClaw của bạn trên Telegram hoặc WhatsApp:

• “Tìm kiếm trong các bản ghi ScreenApp của tôi cuộc thảo luận về lộ trình sản phẩm”
• “Lấy bản ghi từ cuộc họp gần nhất của tôi”
• “Những mục hành động nào đã xuất hiện từ cuộc họp giao ban hôm qua?”

Đặc vụ sẽ sử dụng kỹ năng ScreenApp để tìm nạp dữ liệu và trả lời câu hỏi của bạn.

Xuất bản lên ClawHub

Nếu bạn muốn những người dùng OpenClaw khác tìm và cài đặt kỹ năng ScreenApp của bạn, hãy xuất bản nó lên ClawHub, kho kỹ năng chính thức của OpenClaw. ClawHub sử dụng tìm kiếm vector, vì vậy các truy vấn ngôn ngữ tự nhiên như “tìm kiếm bản ghi cuộc họp” hoặc “chuyển đổi bản ghi âm thành văn bản” sẽ hiển thị kỹ năng của bạn miễn là mô tả bao gồm các thuật ngữ đó.

Thêm tệp kê khai claw.json vào thư mục kỹ năng của bạn:

{
  "name": "screenapp",
  "version": "1.0.0",
  "description": "Search meeting recordings, get transcripts, extract action items, and ask AI questions about recorded content via the ScreenApp API.",
  "author": "your-clawhub-username",
  "license": "MIT",
  "permissions": ["network"],
  "entry": "SKILL.md",
  "tags": ["transcription", "meetings", "recordings", "note-taking", "productivity", "speech-to-text"],
  "models": ["claude-*", "gpt-*", "gemini-*"],
  "minOpenClawVersion": "0.8.0"
}

Sau đó xuất bản:

clawhub publish ~/.openclaw/skills/screenapp

Sau khi xuất bản, bất kỳ ai cũng có thể cài đặt nó bằng:

clawhub install screenapp

Kỹ năng của bạn cũng sẽ xuất hiện trên Moltbook, một chỉ mục đa nền tảng liệt kê các kỹ năng cho OpenClaw, Claude Code, Cursor và các công cụ mã hóa AI khác. Moltbook tự động lập chỉ mục ClawHub, vì vậy không có bước bổ sung nào.

Xây dựng một máy chủ MCP (nâng cao)

Nếu bạn muốn một máy chủ MCP phù hợp thay vì một cách tiếp cận dựa trên kỹ năng, bạn có thể đóng gói API ScreenApp vào một máy chủ MCP Node.js. Điều này mang lại cho bạn khả năng tương thích với Claude Desktop, Cursor và bất kỳ máy khách MCP nào khác, không chỉ OpenClaw.

// screenapp-mcp/index.js
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { z } from "zod";

const server = new McpServer({
  name: "screenapp",
  version: "1.0.0",
});

const API_BASE = "https://api.screenapp.io";
const TOKEN = process.env.SCREENAPP_API_TOKEN;

server.tool(
  "search_recordings",
  { query: z.string() },
  async ({ query }) => {
    const res = await fetch(
      `${API_BASE}/v2/files?searchQuery=${encodeURIComponent(query)}`,
      { headers: { Authorization: `Bearer ${TOKEN}` } }
    );
    const data = await res.json();
    return {
      content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
    };
  }
);

server.tool(
  "get_transcript",
  { fileId: z.string() },
  async ({ fileId }) => {
    const res = await fetch(`${API_BASE}/v2/files/${fileId}`, {
      headers: { Authorization: `Bearer ${TOKEN}` },
    });
    const data = await res.json();
    return {
      content: [{ type: "text", text: JSON.stringify(data.transcript, null, 2) }],
    };
  }
);

server.tool(
  "analyze_recording",
  { fileId: z.string(), question: z.string() },
  async ({ fileId, question }) => {
    const res = await fetch(
      `${API_BASE}/v2/files/${fileId}/ask/multimodal`,
      {
        method: "POST",
        headers: {
          Authorization: `Bearer ${TOKEN}`,
          "Content-Type": "application/json",
        },
        body: JSON.stringify({ promptText: question }),
      }
    );
    const data = await res.json();
    return {
      content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
    };
  }
);

Sau đó đăng ký nó trong cấu hình của OpenClaw hoặc sử dụng độc lập với Claude Desktop.

Các trường hợp sử dụng

Theo dõi cuộc họp: Hỏi đặc vụ của bạn “Sarah đã nói gì về thời gian trong cuộc gọi hôm qua?” và nó sẽ kéo bản ghi, tìm phần liên quan và cung cấp cho bạn câu trả lời.

Tóm tắt hàng tuần: “Tóm tắt tất cả các cuộc họp của tôi trong tuần này” kích hoạt tìm kiếm trên các bản ghi của bạn và tạo một báo cáo tổng hợp.

Theo dõi mục hành động: “Tôi có những mục hành động đang chờ xử lý nào từ các cuộc họp trong tháng này?” tìm kiếm trong các bản ghi của bạn về các cam kết và thời hạn.

Tái sử dụng nội dung: “Biến bản ghi webinar cuối cùng của tôi thành dàn ý bài đăng blog” sử dụng điểm cuối phân tích AI để tạo nội dung có cấu trúc từ video của bạn.

Các tính năng liên quan của ScreenApp

• Tóm tắt cuộc họp bằng AI: Tạo bản tóm tắt từ bất kỳ bản ghi nào
• Phần mềm chuyển lời nói thành văn bản: Tự động chuyển lời nói thành văn bản với nhãn người nói
• Công cụ ghi chú bằng AI: Ghi chú có cấu trúc từ các cuộc trò chuyện của bạn

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

Máy chủ MCP là gì?

Máy chủ MCP (Model Context Protocol) là một chương trình cục bộ cung cấp dữ liệu và công cụ cho các mô hình AI. Nó cho phép các trợ lý AI như Claude hoặc tác nhân OpenClaw truy cập các dịch vụ bên ngoài mà không cần sao chép, dán dữ liệu thủ công.

Tôi có cần gói ScreenApp trả phí để truy cập API không?

Truy cập API có sẵn trên các gói trả phí của ScreenApp. Kiểm tra cài đặt tài khoản của bạn để xem phần API có khả dụng không. Các tài khoản miễn phí có quyền truy cập API bị hạn chế.

Tôi có thể sử dụng cái này với Claude Desktop thay vì OpenClaw không?

Có. Phương pháp máy chủ MCP hoạt động với bất kỳ máy khách tương thích MCP nào. Claude Desktop, ChatGPT Desktop và Cursor đều hỗ trợ máy chủ MCP. OpenClaw bổ sung lợi ích là có thể truy cập nó từ các ứng dụng nhắn tin di động.

Dữ liệu ghi âm của tôi có được gửi đến máy chủ của OpenClaw không?

Không. OpenClaw tự lưu trữ và chạy hoàn toàn trên máy của bạn. Mã API ScreenApp và dữ liệu ghi âm của bạn vẫn ở cục bộ. Mô hình AI xử lý dữ liệu, nhưng bản thân OpenClaw không lưu trữ hoặc chuyển tiếp nội dung của bạn.

Làm thế nào để tác nhân tìm được kỹ năng phù hợp?

OpenClaw quét các trường name và description từ mỗi kỹ năng đã cài đặt khi bắt đầu mỗi phiên. Khi bạn hỏi điều gì đó như “tìm cuộc họp cuối cùng của tôi,” tác nhân sẽ khớp với các mô tả kỹ năng và tải toàn bộ SKILL.md cho kỹ năng phù hợp nhất. Đây là lý do tại sao mô tả nên bao gồm các cụm từ kích hoạt cụ thể như “transcription,” “meeting notes,” và “recordings” thay vì ngôn ngữ mơ hồ như “helps with recordings.”

Máy chủ MCP có thể xử lý bao nhiêu bản ghi?

API ScreenApp xử lý phân trang, vì vậy bạn có thể làm việc với các thư viện ở mọi kích thước. Để có kết quả tốt nhất, hãy sử dụng các truy vấn tìm kiếm để thu hẹp kết quả thay vì liệt kê mọi thứ cùng một lúc.