OpenClaw

OpenClaw 是本地运行的个人 AI 助手，可与多种通讯平台集成实现远程操控。

安装 OpenClaw

在终端中运行以下命令安装（老用户同样可以用此命令更新）：

macOS / Linux
Windows

curl -fsSL https://openclaw.ai/install.sh | bash

iwr -useb https://openclaw.ai/install.ps1 | iex

配置 MiniMax 模型

安装完成后会自动进入配置引导。若没有自动开始，运行：

openclaw configure

选择认证方式开始配置：

OAuth 登录（推荐）
API Key 手动配置

选择 Gateway 和模块

Where will the Gateway run? → 选择 Local (this machine)
Select sections to configure → 选择 Model
Model/auth provider → 选择 MiniMax
MiniMax auth method → 选择 MiniMax CN — OAuth (minimaxi.com)

登录授权

自动弹出登录页，登录并授权。

确认模型

系统默认勾选 MiniMax-M2.7 和 MiniMax-M3，并将 M3 设为默认，直接回车确认即可。

验证

输入 openclaw tui，能正常对话即配置成功。

选择认证方式

Where will the Gateway run? → 选择 Local (this machine)
Select sections to configure → 选择 Model
Model/auth provider → 选择 MiniMax
MiniMax auth method：
- 中国大陆用户 → MiniMax CN — API Key (minimaxi.com)
- 海外用户 → MiniMax Global — API Key (minimax.io)

填写 API Key

填入你的 MiniMax API Key，然后回车使用默认模型选项。

完成功能配置

按需配置以下选项：

Channel：选择在哪个 App 中对话
Skill：按需安装技能
Hooks（可选）：
- 💾 session-memory：执行 /new 时自动保存会话上下文
- 📝 command-logger：记录所有命令到日志文件
- 🚀 boot-md：网关启动时运行 BOOT.md

验证

输入 openclaw tui，能正常对话即配置成功。

开关思考

运行时用 /think 开关思考：off 关闭，adaptive（默认）让 M3 自行决定何时思考。

进阶能力配置方法

本页按 OpenClaw v2026.7.1-2 编写：该版本的 MiniMax provider 已内置图像理解、图片、视频、语音和音乐能力。不同版本的模型目录和工具可能不同，请使用 openclaw --version 和 openclaw models list 进行确认。

识图能力

OpenClaw v2026.7.1-2 已通过内置 MiniMax provider 提供图像理解，使用 MiniMax-VL-01，不需要额外安装 MCP。其他版本请先核对版本说明。如果使用更早版本，或需要独立 MCP 客户端，才需要通过下列方式补充识图能力。

方式 1（推荐）：MiniMax CLI
方式 2：Token Plan MCP

MiniMax CLI（命令名 mmx）是官方命令行工具，可作为旧版 OpenClaw 的替代接入方式。

环境准备

确保 Node.js 18+ 已就绪：

# 检查 Node.js 版本（应 >= 18）
node -v

# 如未安装，推荐通过 nvm 安装 LTS 版本
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
nvm install --lts

安装 MiniMax CLI

在终端运行以下命令完成全局安装：

npm install -g mmx-cli

⭐️ 或让 OpenClaw 完成安装与 SKILL 接入；鉴权时请在本地终端输入密钥，不要把密钥粘贴到 Agent 对话中：

请帮我接入 MiniMax CLI（https://github.com/MiniMax-AI/cli），完成安装与配置。到鉴权步骤时暂停，由我在本地终端输入 API Key；不要请求、打印或记录我的密钥。

1. 全局安装 CLI：执行 `npm install -g mmx-cli`，完成后用 `mmx --version` 验证
2. 鉴权：提示我在本地终端执行 `mmx auth login`，不要在对话中索要或粘贴 API Key
3. 安装官方 SKILL：执行 `npx skills add MiniMax-AI/cli -y -g`

完成后请执行 `mmx quota` 查看我的 Token Plan 余额，确认整体配置生效。

使用 API Key 完成鉴权。请在本地终端输入密钥，不要将其粘贴到 Agent 对话中：

mmx auth login

最新版 mmx-cli 会根据 Key 自动检测服务区域，通常无需手动配置 region。

服务区域根据所使用的 API 服务是在国内平台（cn，MiniMax 国内版订阅）还是在海外平台（global，MiniMax 国际版订阅）上购买所决定。

若登录后调用接口报 401，大概率是 region 未自动匹配成功。可手动指定：

mmx config set --key region --value cn       # 国内 API 服务
mmx config set --key region --value global   # 海外 API 服务

执行 mmx auth status 确认当前 region 与所购买服务来源平台一致。

登录完成后，可执行 mmx quota 查看 Token Plan 套餐额度，确认整体配置生效。

安装 SKILL（可选，推荐 Agent 用户）

若你要在 OpenClaw 中调用 mmx 命令，建议加装官方 SKILL.md，Agent 调用时决策更准、无需临时翻 --help：

npx skills add MiniMax-AI/cli -y -g

SKILL 会自动 symlink 到 ~/.openclaw/skills/，OpenClaw 下次启动即可识别。

引导 OpenClaw 调用 mmx vision

告知 OpenClaw 后续识图需求优先走 mmx vision：

记住，之后要进行图像理解时优先使用 mmx vision 工具，
通过 `mmx vision describe --image <图片路径或URL>` 调用并解析返回结果。

验证

在 OpenClaw 中发送图片，检查 OpenClaw 是否会自动调用 mmx vision describe --image <路径> 并返回正确的图像描述。

通过 Token Plan MCP 接入 understand_image 工具。

环境准备

确保 uv（Python 包管理器）已就绪：

# 检查是否已安装
which uv

# 如未安装，通过 pip 安装
pip install uv

# 或通过 curl 安装
curl -LsSf https://astral.sh/uv/install.sh | sh

# 若上述安装失败或速度很慢，可使用国内镜像加速：
export UV_INDEX_URL="https://pypi.tuna.tsinghua.edu.cn/simple"
curl -LsSf https://astral.sh/uv/install.sh | sh

安装并配置 MCP

手动配置请参考 Token Plan MCP 接入指南，核心步骤：

安装 mcporter skill（MCP server 管理工具）
按照官方文档配置 minimax-coding-plan-mcp
设置 MINIMAX_API_KEY 环境变量（Token Plan API Key 以 sk-cp 开头）：

export MINIMAX_API_KEY="sk-..."

⭐️ 可让 OpenClaw 完成安装；鉴权时请在本地终端输入订阅 Key，不要把密钥粘贴到 Agent 对话中：

先安装 mcporter skill，再按照 https://platform.minimaxi.com/docs/token-plan/mcp-guide 安装和配置 MCP。到鉴权步骤时暂停，由我在本地终端输入订阅 Key，不要请求、打印或记录密钥。

引导 OpenClaw 使用 understand_image

告知 OpenClaw 后续识图需求优先走 understand_image：

记住，之后要进行图像理解时需使用 minimax-coding-plan-mcp 的 understand_image 工具。

验证

在 OpenClaw 中发送图片，检查 OpenClaw 是否会自动调用 understand_image 工具并返回正确的图像描述。

网络搜索

OpenClaw v2026.7.1-2 的 API-key MiniMax provider 已提供 web_search。如果使用其他版本，或需要独立 MCP 客户端，可通过下列方式接入网络搜索（需要 Token Plan 订阅 Key）。

方法 1（推荐）：MiniMax CLI
方法 2：Token Plan MCP

mmx search 是 MiniMax CLI 提供的网络检索命令，无需额外 MCP server 进程，直接通过 Bash 调用即可。

环境准备

确保 Node.js 18+ 已就绪：

# 检查 Node.js 版本（应 >= 18）
node -v

# 如未安装，推荐通过 nvm 安装 LTS 版本
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
nvm install --lts

安装 MiniMax CLI

在终端运行以下命令完成全局安装：

npm install -g mmx-cli

⭐️ 可让 OpenClaw 完成安装和 SKILL 接入；鉴权时请在本地终端输入密钥，不要把密钥粘贴到 Agent 对话中：

请帮我接入 MiniMax CLI（https://github.com/MiniMax-AI/cli），完成安装与配置。到鉴权步骤时暂停，由我在本地终端输入 API Key；不要请求、打印或记录我的密钥。

1. 全局安装 CLI：执行 `npm install -g mmx-cli`，完成后用 `mmx --version` 验证
2. 鉴权：提示我在本地终端执行 `mmx auth login`
3. 安装官方 SKILL：执行 `npx skills add MiniMax-AI/cli -y -g`

完成后请执行 `mmx quota` 查看我的 Token Plan 余额，确认整体配置生效。

使用 API Key 完成鉴权。请在本地终端输入密钥，不要将其粘贴到 Agent 对话中：

mmx auth login

最新版 mmx-cli 会根据 Key 自动检测服务区域，通常无需手动配置 region。

服务区域根据所使用的 API 服务是在国内平台（cn，MiniMax 国内版订阅）还是在海外平台（global，MiniMax 国际版订阅）上购买所决定。

若登录后调用接口报 401，大概率是 region 未自动匹配成功。可手动指定：

mmx config set --key region --value cn       # 国内 API 服务
mmx config set --key region --value global   # 海外 API 服务

执行 mmx auth status 确认当前 region 与所购买服务来源平台一致。

登录完成后，可执行 mmx quota 查看 Token Plan 套餐额度，确认整体配置生效。

安装 SKILL（可选，推荐 Agent 用户）

若你要在 OpenClaw 中调用 mmx 命令，建议加装官方 SKILL.md，Agent 调用时决策更准、无需临时翻 --help：

npx skills add MiniMax-AI/cli -y -g

SKILL 会自动 symlink 到 ~/.openclaw/skills/，OpenClaw 下次启动即可识别。

引导 OpenClaw 使用 mmx search

mmx search 提供两种调用形态：

# 简单调用（适合人类使用，输出可读文本）
mmx search "MiniMax AI 最新进展"

# 结构化调用（适合 Agent 解析）
mmx search query --q "MiniMax M3 release" --output json

让 OpenClaw 调用的提示词示例：

使用 mmx search 工具搜索“OpenClaw 多 Agent 编排”，
以 `mmx search query --q "..." --output json` 形式拿到结构化结果后，
总结排名前 3 条的标题、链接、关键摘要。

OpenClaw 会通过 Bash 工具执行 mmx search query --q "..." --output json，把 stdout 的 JSON 直接交给模型解析，无需额外的 MCP server 进程。

记忆存储

记住，之后要进行网络搜索时优先使用 mmx search 工具，
通过 `mmx search query --q "..." --output json` 调用并解析返回的 JSON 结果。

通过 Token Plan MCP 接入 web_search 工具。

环境准备

确保 uv（Python 包管理器）已就绪：

# 检查是否已安装
which uv

# 如未安装，通过 pip 安装
pip install uv

# 或通过 curl 安装
curl -LsSf https://astral.sh/uv/install.sh | sh

# 若上述安装失败或速度很慢，可使用国内镜像加速：
export UV_INDEX_URL="https://pypi.tuna.tsinghua.edu.cn/simple"
curl -LsSf https://astral.sh/uv/install.sh | sh

安装并配置 MCP

手动配置请参考 Token Plan MCP 接入指南，核心步骤：

安装 mcporter skill（MCP server 管理工具）
按照官方文档配置 minimax-coding-plan-mcp
设置 MINIMAX_API_KEY 环境变量（Token Plan API Key 以 sk-cp 开头）：

export MINIMAX_API_KEY="sk-..."

⭐️ 可让 OpenClaw 完成安装；鉴权时请在本地终端输入订阅 Key，不要把密钥粘贴到 Agent 对话中：

先安装 mcporter skill，再按照 https://platform.minimaxi.com/docs/token-plan/mcp-guide 安装和配置 MCP。到鉴权步骤时暂停，由我在本地终端输入订阅 Key，不要请求、打印或记录密钥。

引导 OpenClaw 使用 web_search

告知 OpenClaw 后续搜索需求优先走 web_search：

记住，之后要进行网络搜索时需使用 minimax-coding-plan-mcp 的 web_search 工具。

验证

在 OpenClaw 中给出一个需要联网的问题，检查 OpenClaw 是否会自动调用 web_search 工具并返回搜索结果。

Token Plan

在 AI 编程工具里使用 M3

MCP指南

CLI指南

最佳实践

安装 OpenClaw

配置 MiniMax 模型

开关思考

进阶能力配置方法

识图能力

网络搜索

​安装 OpenClaw

​配置 MiniMax 模型

​开关思考

​进阶能力配置方法

​识图能力

​网络搜索

安装 OpenClaw

配置 MiniMax 模型

开关思考

进阶能力配置方法

识图能力

网络搜索