Metaso Search 技能

描述

提供对 Metaso 搜索 API 的直接访问，支持网页搜索、内容读取和智能问答功能。

功能

1. 网页搜索 (metasowebsearch)

参数：

• - q: 搜索查询关键词（必填）
• size: 返回结果数量（必填，1-100）
• scope: 搜索范围（必填）
• includeSummary: 是否包含精简的原文匹配信息（必填）
• includeRawContent: 是否通过网页的摘要信息进行召回增强（必填）
• conciseSnippet: 是否抓取所有来源网页原文（必填）

2. 网页内容读取 (metasowebreader)

参数：

• - url: 要读取的 URL 地址（必填）
• format: 输出格式（必填，json 或 markdown）

3. 智能问答 (metaso_chat)

参数：

• - messages: 用户消息数组（必填）
• model: 使用的模型（必填）
• scope: 搜索范围（必填）
• format: 输出格式（必填）
• stream: 是否开启流式输出（必填）
• conciseSnippet: 是否返回精简的原文匹配信息（必填）

配置

环境变量配置

必要配置：
bash

Linux/macOS

Windows (PowerShell)

OpenClaw 配置：
在 OpenClaw 配置文件 openclaw.json 中添加：
json
{
env: {
METASOAPIKEY: 您的API密钥
}
}

使用方法

javascript
import { metasoSearch, metasoReadPage, metasoChat } from ./skills/metaso-search/metaso-api.js;

// 搜索
const searchResult = await metasoSearch(人工智能, 2, document, true, false, true);

// 读取网页内容
const contentResult = await metasoReadPage(https://example.com, json);

// 智能问答
const chatResult = await metasoChat(
[{ role: user, content: 什么是机器学习？ }],
fast,
webpage,
simple,
false,
true
);

文件说明

metaso-api.js - API 核心模块

• - 提供所有 API 方法的实现
• 包含自动配置加载
• 错误处理和重试机制
• 使用 Metaso HTTP API 端点

quick-test.js - 快速测试脚本

• - 用于快速验证 API 基本功能的简化测试
• 包含搜索和聊天功能的基本测试

simple-test.js - 简单功能测试

• - 测试所有 API 功能的详细测试脚本
• 包含搜索、内容读取和聊天功能的测试

运行测试

bash
cd skills/metaso-search
node quick-test.js

故障排除

API 密钥未配置

Error: METASOAPIKEY 环境变量未设置，请在使用前配置

解决方法：设置 METASOAPIKEY 环境变量

认证失败

Error: API密钥无效

解决方法：检查 API 密钥是否正确

版本信息

• - 当前版本: 2.1.0
• 移除了硬编码的默认 API 密钥
• 优化了配置管理
• 简化了文档结构