如何通过 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？
模型上下文协议（Model Context Protocol）是由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”: “your question here” }
分析转录和视频内容。使用此功能可用于总结会议、提取行动项目或回答关于录音中发生事件的具体问题。
列出最近的录音
GET /v2/files?sortBy=createdAt&sortOrder=desc&limit=10
当用户询问其最新会议或最近录音时使用此功能。
（可选）创建 `references/api-endpoints.md` 以获取更详细的参数文档。代理仅在需要时加载参考文件，从而保持初始技能扫描的轻量级。
#
## 4. 设置API令牌
将您的 ScreenApp 令牌添加到 OpenClaw 的环境中。编辑 `~/.openclaw/openclaw.json`：
```json
{
"env": {
"SCREENAPP_API_TOKEN": "your-token-here"
}
}
或者，如果您愿意，可以在您的 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": "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"
}
然后发布：
clawhub publish ~/.openclaw/skills/screenapp
发布后，任何人都可以使用以下命令安装它：
clawhub install screenapp
您的技能还将出现在 Moltbook 上，这是一个跨平台索引，列出了适用于 OpenClaw、Claude Code、Cursor 和其他 AI 编码工具的技能。Moltbook 会自动索引 ClawHub，因此无需额外步骤。
构建 MCP 服务器（高级）
如果您想要一个合适的 MCP 服务器而不是基于技能的方法，您可以将 ScreenApp API 封装在 Node.js MCP 服务器中。这使您能够与 Claude Desktop、Cursor 和任何其他 MCP 客户端兼容，而不仅仅是 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) }],
};
}
);
然后将其注册到 OpenClaw 的配置中，或与 Claude Desktop 独立使用。
用例
会议跟进：询问您的代理“Sarah 在昨天的电话会议中关于时间表说了什么？”它会拉取会议记录，找到相关部分，并给您答案。
每周总结：“总结我本周的所有会议”会触发对您录音的搜索并生成一份综合报告。
行动项追踪：“我本月会议中有哪些未完成的行动项？”会在您的会议记录中搜索承诺和截止日期。
内容再利用：“将我上次网络研讨会录音转换为博客文章大纲”使用 AI 分析端点从您的视频生成结构化内容。
相关 ScreenApp 功能
常见问题
什么是 MCP 服务器？
MCP（模型上下文协议）服务器是一个本地程序，它向 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 支持分页，因此您可以处理任意大小的库。为了获得最佳结果，请使用搜索查询来缩小结果范围，而不是一次性列出所有内容。
