· 3 min read

如何通过 MCP 服务器将 ScreenApp 连接至 OpenClaw AI 代理

Andre Dean Smith

Andre Dean Smith

Author
如何通过 MCP 服务器将 ScreenApp 连接至 OpenClaw AI 代理
On this page

您的AI代理应该能够调出上周二的会议记录，而无需您手动翻找文件夹。借助ScreenApp的API和模型上下文协议（MCP），您可以让OpenClaw代理直接访问您的录音、转录文本和AI摘要。

本指南将引导您构建一个ScreenApp MCP服务器技能，以便您的OpenClaw代理可以通过Telegram、WhatsApp或Discord上的聊天消息来搜索录音、获取转录文本，并对您的内容运行AI分析。

如果您是会议录音MCP服务器的新手，请查看我们的最佳会议MCP服务器比较，了解ScreenApp的表现。

什么是OpenClaw？

OpenClaw是一个自托管网关，用于将消息应用程序（WhatsApp、Telegram、Discord、iMessage）连接到AI编码代理。您只需在您的机器上运行一个进程，它就能将您的聊天应用程序桥接到一个始终可用的AI助手。

核心理念是：您通过手机给您的代理发送消息，它可以使用工具、读取文件、浏览网页，现在还可以访问您的ScreenApp录音。

OpenClaw使用技能来教代理如何使用工具。每个技能都是一个文件夹，其中包含一个描述可用命令的SKILL.md文件。技能还可以封装MCP服务器，这就是我们将连接ScreenApp的方式。

OpenClaw通过一个三层系统发现技能。在会话开始时，代理会扫描每个技能前端信息中的name和description。当一个技能看起来相关时，它会加载完整的SKILL.md。这意味着您的描述字段是代理是否选择您的技能的最重要因素。请像告诉同事这个技能做什么以及何时使用它一样来编写。

什么是MCP？

模型上下文协议是Anthropic创建的一项标准，它允许AI模型访问外部数据源。可以将其视为AI应用程序的USB-C。MCP服务器不是将转录文本复制粘贴到ChatGPT中，而是让AI直接获取所需内容。

MCP服务器在本地运行，并暴露工具（AI可以采取的行动）和资源（AI可以读取的数据）。对于ScreenApp，工具将包括“搜索录音”、“获取转录文本”和“询问视频相关问题”等。

MCP可与Claude Desktop、ChatGPT Desktop、Cursor配合使用，并通过OpenClaw与任何消息应用程序配合使用。

ScreenApp API概述

ScreenApp提供了一个REST API，涵盖了MCP集成所需的一切。主要端点包括：

  • 列出录音 - 使用过滤器浏览您的录音库
  • 获取带转录文本的录音 - 获取录音及其完整的转录文本，包括时间戳和说话者标签
  • AI分析 - 使用多模态分析端点 (/v2/files/{fileId}/ask/multimodal) 询问有关录音的问题
  • 搜索 - 通过关键词在您的所有内容中查找录音
  • 上传 - 发送新的音频/视频文件进行处理

认证使用Bearer令牌。您可以从您的ScreenApp账户设置中生成一个API令牌。

如需完整参考，请查阅ScreenApp API文档。

设置步骤

1. 获取您的 ScreenApp API 令牌

登录 ScreenApp，前往 设置 > API，并生成一个新令牌。将其复制到安全的地方。下一步您将需要它。

2. 创建技能文件夹

OpenClaw 技能位于 ~/.openclaw/skills/（跨代理共享）或您的工作区的 /skills/ 文件夹（每个代理）。技能文件夹名称必须与您的 SKILL.md 前置元数据中的 name 字段匹配。创建完整结构：

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

最终的文件夹布局：

screenapp/
├── SKILL.md              # 必需：前置元数据 + 代理指令
├── claw.json             # 用于 ClawHub 发布（可选）
└── references/
    └── api-endpoints.md  # 详细的端点文档，按需加载

3. 编写 SKILL.md

description 字段决定了代理是否选择此技能。OpenClaw 在每个会话开始时扫描每个已安装技能的 name 和 description。包含触发短语和关键词变体，以便代理将其与关于转录、会议、录音和笔记请求匹配。

创建 ~/.openclaw/skills/screenapp/SKILL.md：

---
name: screenapp
description: 搜索会议录音和转录稿，获取会议纪要和行动项，转录音频和视频，询问 AI 关于录制内容的问题。当用户提及转录、会议纪要、录音、音频转文本、语音转文本、会议搜索，或希望查找或分析录制会议和通话时使用。
metadata: {"clawdbot":{"emoji":"","requires":{"env":["SCREENAPP_API_TOKEN"]},"primaryEnv":"SCREENAPP_API_TOKEN","homepage":"https://screenapp.io"}}
---

# ScreenApp 集成

访问用户的 ScreenApp 录音、转录稿和 AI 分析。

## 认证

所有请求都需要 SCREENAPP_API_TOKEN 环境变量。

Headers: Authorization: Bearer $SCREENAPP_API_TOKEN
Base URL: https://api.screenapp.io

## 可用操作

#

## 按关键词搜索录音
GET /v2/files?searchQuery={query}

当用户想要查找特定会议、录音或主题时使用此功能。

#

## 获取带有转录文本的录音
GET /v2/files/{fileId}

返回完整的录音对象，包括带有说话人标签的时间戳转录文本。使用此功能可检索会议记录、回读所说内容或获取通话的完整文本。

#

## 向AI询问有关录音的问题
POST /v2/files/{fileId}/ask/multimodal
Body: { "promptText": "在此处输入您的问题" }

分析转录文本和视频内容。使用此功能可总结会议、提取行动项或回答有关录音中发生事件的具体问题。

#

## 列出最近的录音
GET /v2/files?sortBy=createdAt&sortOrder=desc&limit=10

当用户询问他们最新的会议或最近的录音时使用此功能。

（可选）创建 references/api-endpoints.md 以提供更详细的参数文档。代理仅在需要时加载引用文件，从而保持初始技能扫描的轻量级。

4. 设置API令牌

将您的ScreenApp令牌添加到OpenClaw的环境中。编辑 ~/.openclaw/openclaw.json：

{
  "env": {
    "SCREENAPP_API_TOKEN": "您的令牌在此处"
  }
}

或者，如果您愿意，可以在您的shell配置文件中导出它。

5. 重启 OpenClaw

openclaw gateway restart

代理将在下一次会话中获取新技能。您可以通过询问代理：“您有哪些技能？“来验证它是否已加载。

6. 测试

在 Telegram 或 WhatsApp 上向您的 OpenClaw 代理发送消息：

  • “搜索我的 ScreenApp 录音，查找产品路线图讨论”
  • “获取我上次会议的转录稿”
  • “昨天的站会产生了哪些行动项？”

代理将使用 ScreenApp 技能获取数据并回答您的问题。

发布到 ClawHub

如果您希望其他 OpenClaw 用户找到并安装您的 ScreenApp 技能，请将其发布到 ClawHub，这是 OpenClaw 的官方技能注册表。ClawHub 使用向量搜索，因此只要描述涵盖“搜索会议转录稿”或“转录音频录音”等术语，自然语言查询即可显示您的技能。

在您的技能文件夹中添加 claw.json 清单：

{
  "name": "screenapp",
  "version": "1.0.0",
  "description": "通过 ScreenApp API 搜索会议录音、获取转录稿、提取行动项，并就录制内容向 AI 提问。",
  "author": "您的 ClawHub 用户名",
  "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"
}

然后发布：

clawhub publish ~/.openclaw/skills/screenapp

发布后，任何人都可以通过以下方式安装它：

clawhub install screenapp

您的技能也将出现在 Moltbook 上，这是一个列出 OpenClaw、Claude Code、Cursor 和其他 AI 编码工具技能的跨平台索引。Moltbook 会自动索引 ClawHub，因此无需额外步骤。

构建 MCP 服务器（高级）

如果您想要一个真正的 MCP 服务器而不是基于技能的方法，您可以将 ScreenApp API 封装在 Node.js MCP 服务器中。这使您的服务不仅与 OpenClaw，还与 Claude Desktop、Cursor 和任何其他 MCP 客户端兼容。

// 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) }],
    };
  }
);

然后在 OpenClaw 的配置中注册它，或单独与 Claude Desktop 一起使用。

用例

会议跟进：询问您的代理“莎拉在昨天的电话会议中说了些什么关于时间表的内容？”，它将提取转录稿，找到相关部分，并给出答案。

每周总结：“总结我本周的所有会议”将触发对您的录音进行搜索并生成一份综合报告。

行动项追踪：“我本月会议中有哪些未完成的行动项？”将搜索您的转录稿以查找承诺和截止日期。

内容再利用：“将我上次的网络研讨会录音转换为博客文章大纲”将使用 AI 分析端点从您的视频生成结构化内容。

相关 ScreenApp 功能

常见问题

什么是 MCP 服务器？

MCP (Model Context Protocol) 服务器是一种本地程序，它将数据和工具暴露给 AI 模型。它允许像 Claude 或 OpenClaw 这样的 AI 助手访问外部服务，而无需手动复制粘贴数据。

我需要付费的 ScreenApp 计划才能访问 API 吗？

API 访问在 ScreenApp 付费计划中可用。请检查您的账户设置，看 API 部分是否可用。免费账户的 API 访问受限。

我可以使用 Claude Desktop 而不是 OpenClaw 吗？

是的。MCP 服务器方法适用于任何 MCP 兼容客户端。Claude Desktop、ChatGPT Desktop 和 Cursor 都支持 MCP 服务器。OpenClaw 的优势在于可以从移动消息应用程序访问它。

我的录音数据是否发送到 OpenClaw 的服务器？

不。OpenClaw 是自托管的，完全在您的机器上运行。您的 ScreenApp API 令牌和录音数据保留在本地。AI 模型处理数据，但 OpenClaw 本身不存储或转发您的内容。

代理如何找到合适的技能？

OpenClaw 在每个会话开始时扫描所有已安装技能的 name 和 description 字段。当您询问“查找我上次的会议”之类的问题时，代理会将其与技能描述进行匹配，并加载最符合的技能的完整 SKILL.md。这就是为什么描述应包含具体的触发短语，如“转录”、“会议记录”和“录音”，而不是“帮助处理录音”这样模糊的语言。

MCP 服务器可以处理多少录音？

ScreenApp API 处理分页，因此您可以处理任意大小的库。为获得最佳结果，请使用搜索查询来缩小结果范围，而不是一次列出所有内容。

相关文章

最佳AI课堂笔记App

最佳AI课堂笔记App

下载适用于iPhone和安卓的最佳免费AI课堂笔记App。比较ScreenApp、Otter以及其他课堂录音App，它们具备后台录音、实时转录和为学生提供的自动摘要功能。
2026年最佳实时翻译器Top 10（应用 - 耳机测评）

2026年最佳实时翻译器Top 10（应用 - 耳机测评）

探索2026年最佳实时翻译应用和设备。我们测试了准确性、速度和功能，以帮助您找到适合旅行、商务和对话的完美解决方案。
爱因斯坦AI 对决 ScreenApp：2026年最佳免费AI讲座笔记工具

爱因斯坦AI 对决 ScreenApp：2026年最佳免费AI讲座笔记工具

2026年爱因斯坦AI与ScreenApp对比：哪款免费AI讲座笔记工具更适合学生？转录准确性、YouTube支持、定价和隐私，并排实测。
User
User
User
加入 7,740,452+ 用户

发现更多见解

探索我们的博客，获取更多生产力技巧、技术见解和软件解决方案。

Try ScreenApp Free

Start recording in 60 seconds • 无需信用卡

AI-powered transcription and analysis

Record meetings, get transcripts, and let AI agents access everything through the ScreenApp API.

Full API access
AI transcript analysis
Works with any MCP client
Try free

No credit card required • Cancel anytime