🔍 MiniMax Search & VLM — 技能工具

技能文档

使用 MiniMax Coding Plan API 进行网络搜索和图片理解。

何时使用

✅ 使用这个 skill 当：

• 用户需要搜索实时信息（新闻、科技动态等）
• 需要分析图片内容（描述图片、提取信息）
• 做研究、查找资料
• 用户问"今天有什么科技新闻"

❌ 不要使用这个 skill 当：

• 本地文件操作 → 使用 exec 或 read 工具
• 简单的计算或文本处理 → 直接处理
• 需要登录认证的搜索 → 使用其他方式

配置步骤（用户需先完成）

首次使用需要配置 API Key，只需执行一次：

# 创建配置目录（如不存在）
mkdir -p ~/.openclaw/config
# 添加 API Key（替换为你自己的 key）
echo 'MINIMAX_API_KEY=你的API密钥' > ~/.openclaw/config/minimax-api.env
# 设置安全权限
chmod 600 ~/.openclaw/config/minimax-api.env

API Key 需要从 MiniMax 开发者平台获取：https://platform.minimaxi.com

功能

1. 网络搜索

搜索网络获取实时信息。

# 加载 API Key
source ~/.openclaw/config/minimax-api.env
# 搜索示例
curl -s "https://api.minimaxi.com/v1/coding_plan/search" \
  -H "Authorization: Bearer $MINIMAX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"q":"今天科技新闻"}'

2. 图片理解

分析图片内容，支持本地文件或网络图片。

# 加载 API Key
source ~/.openclaw/config/minimax-api.env
# 分析本地图片
IMG_PATH="/path/to/image.jpg"
curl -s "https://api.minimaxi.com/v1/coding_plan/vlm" \
  -H "Authorization: Bearer $MINIMAX_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"prompt\":\"描述这张图片\",\"image_url\":\"data:image/jpeg;base64,$(base64 -w0 $IMG_PATH)\"}"

支持格式: JPEG, PNG, GIF, WebP（最大 20MB）

快速命令

搜索并美化输出

source ~/.openclaw/config/minimax-api.env
curl -s "https://api.minimaxi.com/v1/coding_plan/search" \
  -H "Authorization: Bearer $MINIMAX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"q":"关键词"}' | python3 -c "
import json,sys
data = json.load(sys.stdin)
for r in data.get('organic',[])[:5]:
    print(f'• {r[\"title\"]}')
    print(f'  {r[\"link\"]}\n')
"

下载网络图片后分析

source ~/.openclaw/config/minimax-api.env
curl -s "https://example.com/image.jpg" -o /tmp/tmp_img.jpg
curl -s "https://api.minimaxi.com/v1/coding_plan/vlm" \
  -H "Authorization: Bearer $MINIMAX_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"prompt\":\"描述这张图片\",\"image_url\":\"data:image/jpeg;base64,$(base64 -w0 /tmp/tmp_img.jpg)\"}"

注意事项

• API Key 保存在用户本地配置文件中，不会随 skill 发布
• 请勿在命令输出或日志中暴露 API Key
• 搜索 API 有频率限制，避免短时间内大量请求