MiniMax CLI 网络搜索

使用此技能，可通过 CLI 调用 MiniMax MCP 执行网络搜索，并返回结构清晰、以来源为优先的搜索结果。

第一阶段：环境准备（必须首先执行）

1) 预检检查

运行：

scripts/minimax_web_search.sh --preflight

该命令验证以下内容：

• mcporter 已安装并可在 PATH 中调用
• MiniMax MCP 服务可被发现（通过 mcporter list --json）
• 服务状态健康（name=minimax 且 status=ok）

2) 若预检失败，按错误类型修复

• mcporter not found
  • 将 mcporter 安装或配置至系统 PATH 中。
• minimax MCP server not ready
  • 确认 config/mcporter.json 中已正确声明 minimax 服务。
  • 验证其 command/transport 配置是否有效。
• 认证/API Key 相关错误
  • 确保 MiniMax API Key 已为 minimax MCP 服务正确配置。
  • 重新运行预检命令。

3) 初始化 / 冒烟测试

预检通过后，执行一次查询：

scripts/minimax_web_search.sh --query "latest OpenClaw release" --count 3

若成功返回结果，则环境已就绪。

第二阶段：搜索使用（运行时）

快速使用

scripts/minimax_web_search.sh --query "your query" --count 5

支持的选项

• --query ：必需的搜索查询语句
• --count ：最多输出的结果数量（默认为 5）
• --freshness ：附加至查询语句的新鲜度提示（可选）
• --json：输出标准化 JSON 格式结果
• --raw：输出工具原始 JSON 响应
• --timeout ：命令超时时间（默认 35 秒）

输出约定（默认文本格式）

• 按相关性排序展示前 N 条结果
• 每条结果包含：标题、URL、摘要片段、发布日期（如可用）
• 保持输出简洁，具备直接可操作性

智能体行为指南

1. 从聚焦型查询开始（3–7 个关键词）。
2. 若结果质量偏低，仅重写一次查询，使用更精确、范围更窄的术语。
3. 返回关键发现及对应链接（无需表格形式）。
4. 对时效性强的请求，在查询中显式加入时间词（例如 today、latest 或具体日期）。

错误模型（面向可靠自动化）

脚本退出码定义如下：

• 0：成功
• 2：参数错误
• 3：依赖缺失（mcporter 或 python3）
• 4：配置/认证问题（MCP 服务不可用、API Key 或认证异常）
• 5：上游/运行时/网络故障
• 6：无匹配结果（非致命）

请将退出码 6 视为常规“无匹配”情形，而非程序崩溃。

风险与应对措施

1. 跨机器 CLI/配置漂移
   • 在新环境中首次使用前，务必执行 --preflight 检查。
2. API Key 泄露风险
   • 禁止打印 Key 的明文值；仅报告“缺失”或“无效”状态。
3. 临时文件安全性
   • 封装脚本使用 mktemp 创建 stderr/output 临时文件，并通过 trap 确保自动清理。
4. 上游响应不一致
   • 下游自动化流程应统一采用 --json 输出的标准化格式。
5. 超时/网络不稳定
   • 适当增大 --timeout 值，并尝试使用更窄范围的查询词或减少 --count 值后重试。
6. 相关性弱
   • 优化查询语句，补充具体实体名称或时间范围限定。

其他参考文档

• 有关环境搭建、验证命令及发布就绪检查，请参阅：
  • references/environment-checklist.md

引用规范

呈现调研结果时，应附带可直接访问的原始链接以便验证。优先选择 3–5 个高信噪比来源，避免提供冗长、低质的信息堆砌。