Metaso Search 技能

描述

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

功能

1. 网页搜索 (metaso_web_search)

根据关键词搜索网页、文档、论文、图片、视频、播客等内容。

参数：

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

2. 网页内容读取 (metaso_web_reader)

读取指定 URL 的网页内容。

参数：

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

3. 智能问答 (metaso_chat)

基于 RAG 的智能问答服务。

参数：

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

配置

环境变量配置

必要配置：

# Linux/macOS
export METASO_API_KEY="您的API密钥"

# Windows (PowerShell)
$env:METASO_API_KEY="您的API密钥"

OpenClaw 配置： 在 OpenClaw 配置文件 openclaw.json 中添加：

{
  "env": {
    "METASO_API_KEY": "您的API密钥"
  }
}

使用方法

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 功能的详细测试脚本
• 包含搜索、内容读取和聊天功能的测试

运行测试

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

故障排除

API 密钥未配置

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

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

认证失败

Error: API密钥无效

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

版本信息

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