minimax-tools
# minimax-tools
整合版 MiniMax 工具集，包含图像理解 和网络搜索功能。
## 功能列表
| 功能 | 说明 | 命令 |
|------|------|------|
| 图像理解 | 分析图片内容、识别物体文字场景 | understand_image.py |
| 网络搜索 | 搜索资讯、新闻、资料 | web_search.py |
## 快速开始
### 首次使用（需要在目标设备上执行）
#### 步骤 1: 安装依赖
```bash
# 检查 uvx 是否可用
which uvx
# 如果不存在，安装 uv
curl -LsSf https://astral.sh/uv/install.sh | sh
```
#### 步骤 2: 安装 MCP 服务器
```bash
uvx minimax-coding-plan-mcp --help
```
如果提示未安装，执行：
```bash
uvx install minimax-coding-plan-mcp
```
#### 步骤 3: 配置 API Key
如果没有 MiniMax API Key，需要购买：https://platform.minimaxi.com/subscribe/coding-plan?code=GjuAjhGKqQ&source=link
配置 API Key：
```bash
mkdir -p ~/.openclaw/config
cat > ~/.openclaw/config/minimax.json << EOF
{
"api_key": "你的API密钥",
"output_path": "~/.openclaw/workspace/minimax-output"
}
EOF
```
或者设置环境变量：
```bash
export MINIMAX_API_KEY="你的API密钥"
```
---
### 使用方法
#### 图像理解
```bash
# 描述图片内容
python3 ~/.openclaw/workspace/.agents/skills/minimax-tools/scripts/understand_image.py ~/image.jpg "详细描述这张图片"
# 使用 URL
python3 ~/.openclaw/workspace/.agents/skills/minimax-tools/scripts/understand_image.py "https://example.com/image.jpg" "这张图片展示了什么？"
```
#### 网络搜索
```bash
# 搜索内容
python3 ~/.openclaw/workspace/.agents/skills/minimax-tools/scripts/web_search.py "今天的热点新闻"
# 搜索技术问题
python3 ~/.openclaw/workspace/.agents/skills/minimax-tools/scripts/web_search.py "Python 如何处理 JSON"
```
---
## 迁移到其他设备
需要复制到新设备的内容：
1. **脚本目录**：
```
~/.openclaw/workspace/.agents/skills/minimax-tools/scripts/
```
2. **配置文件**：
- 复制 `~/.openclaw/config/minimax.json`，或
- 在新设备设置环境变量 `MINIMAX_API_KEY`
3. **依赖安装**（在新设备上执行）：
```bash
# 安装 uv（如需要）
curl -LsSf https://astral.sh/uv/install.sh | sh
# 安装 MCP 服务器
uvx install minimax-coding-plan-mcp
```
---
## 脚本说明
### understand_image.py
- 优先从环境变量 `MINIMAX_API_KEY` 读取 API Key
- 如未设置则从 `~/.openclaw/config/minimax.json` 读取
- 支持本地图片路径和 URL
### web_search.py
- 优先从环境变量 `MINIMAX_API_KEY` 读取 API Key
- 如未设置则从 `~/.openclaw/config/minimax.json` 读取
- 返回格式化的搜索结果
---
## 常见问题
**Q: 提示 "uvx: command not found"**
> 需要安装 uv，参见步骤 1
**Q: 提示 "API Key 未配置"**
> 需要配置 MiniMax API Key，参见步骤 3
**Q: MCP 服务器连接失败**
> 检查网络连接，或尝试重新安装：`uvx install minimax-coding-plan-mcp`
标签
skill
ai
