Documentation Index
Fetch the complete documentation index at: https://platform.minimax.io/docs/llms.txt
Use this file to discover all available pages before exploring further.
OpenClaw is a personal AI assistant running locally, integrating with messaging platforms for control.
Prerequisites
- A MiniMax Token Plan Key with Token Plan or Credits access
- A computer with terminal access (macOS, Linux, or Windows with WSL)
Run Installation Command
Run the installation command in your terminal:curl -fsSL https://openclaw.ai/install.sh | bash
Start Setup
Select “Yes” .
Select QuickStart Mode
Select “QuickStart” to use the guided setup.
Select Model Provider
Select “MiniMax” as the model provider.
Select Auth Method
Select “MiniMax Global — OAuth (minimax.io)” as the authentication method.
Sign In to MiniMax
You’ll be sent to a browser window to sign in to or sign up for your MiniMax API Platform account.
Authorize OpenClaw
Select “Authorize”, after which you can return to the terminal.
Confirm Model Selection
A model picker will appear with the available models already selected. Press Enter to continue.
Select a Messaging Channel
Back in the terminal, select a messaging channel to connect. OpenClaw supports a range of platforms including Telegram, WhatsApp, Discord, iMessage, and more.
Confirm Installation
Follow the prompts for your chosen channel, then select “Yes” when asked to confirm.
Select Skills
Select any additional skills you wish to install (press space to select, up and down arrows to navigate).
Configure API Keys
Configure additional API keys for tools that OpenClaw can use (optional). Select “Skip for now” if you don’t need additional tools.
Open Web UI
Select “Open the Web UI” to access the OpenClaw dashboard.
Advanced Capabilities
Image Understanding
When logged in via OAuth, OpenClaw’s image tool is automatically wired to MiniMax’s Image Understanding MCP server, giving your agent image understanding capabilities out of the box — no extra setup needed.If you authenticate with an API Key manually, or your OpenClaw build doesn’t auto-include the Image Understanding MCP, pick one of the methods below to add image understanding to your agent. MiniMax CLI (the mmx command) is the official multi-modal command-line tool. Once installed, OpenClaw can invoke mmx vision for image understanding — and you get the same CLI for text, image, video, speech, music, and search (7 multi-modal capabilities).Prepare Environment
Make sure Node.js 18+ is available:# Check Node.js version (should be >= 18)
node -v
# If not installed, install LTS via nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
nvm install --lts
Install MiniMax CLI
Run the following command in your terminal for a global install:⭐️ Or hand install, login, and SKILL setup to OpenClaw in one go (replace sk-xxxxx with your actual key):Please set up MiniMax CLI (https://github.com/MiniMax-AI/cli) for me with these three steps:
1. Install CLI globally: run `npm install -g mmx-cli`, then verify with `mmx --version`
2. Sign in with API Key: run `mmx auth login --api-key sk-xxxxx`
3. Install the official SKILL: run `npx skills add MiniMax-AI/cli -y -g`
After that, please run `mmx quota` to check my Token Plan balance and confirm everything is wired up.
Login with API Key
Authenticate with your API Key (replace sk-xxxxx with your own Key):mmx auth login --api-key sk-xxxxx
If you hit a 401 after logging in, the region likely didn’t auto-match. Set it manually:mmx config set --key region --value cn # China API service
mmx config set --key region --value global # International API service
mmx auth status to confirm the region matches the platform where your subscription was purchased. mmx quota to view your Token Plan balance and confirm the setup is working. Install SKILL (Optional, Recommended for Agent Users)
If you’ll be invoking mmx from inside OpenClaw, we recommend adding the official SKILL.md so the agent makes better tool calls without having to read --help on the fly:npx skills add MiniMax-AI/cli -y -g
The SKILL is auto-symlinked into ~/.openclaw/skills/, and OpenClaw will pick it up on the next launch.
Tell OpenClaw to Use mmx vision
Tell OpenClaw to prefer mmx vision for any future image understanding:Going forward, prefer the mmx vision tool for image understanding,
invoke it via `mmx vision describe --image <image path or URL>` and parse the result.
Verify
Send an image in OpenClaw and check that it auto-invokes mmx vision describe --image <path> and returns a correct description.
Wire up the Token Plan MCP to use the understand_image tool.Prepare Environment
Make sure uv (the Python package manager) is available:# Check
which uv
# If not installed, via pip
pip install uv
# Or via curl
curl -LsSf https://astral.sh/uv/install.sh | sh
Install and Configure MCP
For manual setup, follow the Token Plan MCP guide. Core steps:
- Install the
mcporter skill (an MCP server manager)
- Configure
minimax-coding-plan-mcp per the official guide
- Set the
MINIMAX_API_KEY environment variable (Token Plan API Key starts with sk-cp):
export MINIMAX_API_KEY="sk-..."
sk-xxxxxxx with your actual API Key):First install the mcporter skill, then follow https://platform.minimax.io/docs/token-plan/mcp-guide to configure the MCP. My MiniMax API Key is sk-xxxxxxx. Finally use the mcporter skill to wire it up.
Tell OpenClaw to Use understand_image
Tell OpenClaw to prefer understand_image for image understanding:Going forward, use the understand_image tool from minimax-coding-plan-mcp for any image understanding.
Verify
Send an image in OpenClaw and check it auto-invokes the understand_image tool and returns a correct description.
Web Search
OpenClaw doesn’t ship with web search out of the box. Add it via one of the methods below (Token Plan subscribers, API Key starts with sk-cp).
mmx search is the web-search command from MiniMax CLI. No separate MCP server process — OpenClaw invokes it directly via Bash.Prepare Environment
Make sure Node.js 18+ is available:# Check Node.js version (should be >= 18)
node -v
# If not installed, install LTS via nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
nvm install --lts
Install MiniMax CLI
Run the following command in your terminal for a global install:⭐️ Or hand install, login, and SKILL setup to OpenClaw in one go (replace sk-xxxxx with your actual key):Please set up MiniMax CLI (https://github.com/MiniMax-AI/cli) for me with these three steps:
1. Install CLI globally: run `npm install -g mmx-cli`, then verify with `mmx --version`
2. Sign in with API Key: run `mmx auth login --api-key sk-xxxxx`
3. Install the official SKILL: run `npx skills add MiniMax-AI/cli -y -g`
After that, please run `mmx quota` to check my Token Plan balance and confirm everything is wired up.
Login with API Key
Authenticate with your API Key (replace sk-xxxxx with your own Key):mmx auth login --api-key sk-xxxxx
If you hit a 401 after logging in, the region likely didn’t auto-match. Set it manually:mmx config set --key region --value cn # China API service
mmx config set --key region --value global # International API service
mmx auth status to confirm the region matches the platform where your subscription was purchased. mmx quota to view your Token Plan balance and confirm the setup is working. Install SKILL (Optional, Recommended for Agent Users)
If you’ll be invoking mmx from inside OpenClaw, we recommend adding the official SKILL.md so the agent makes better tool calls without having to read --help on the fly:npx skills add MiniMax-AI/cli -y -g
The SKILL is auto-symlinked into ~/.openclaw/skills/, and OpenClaw will pick it up on the next launch.
Tell OpenClaw to Use mmx search
mmx search offers two invocation forms:# Simple call (human-friendly, readable text output)
mmx search "latest MiniMax AI updates"
# Structured call (Agent-friendly)
mmx search query --q "MiniMax M2.7 release" --output json
Use the mmx search tool to search "OpenClaw multi-Agent orchestration",
invoke it via `mmx search query --q "..." --output json` to get structured results,
then summarize the top 3 hits' titles, links, and key snippets.
mmx search query --q "..." --output json via the Bash tool and hand the stdout JSON to the model directly — no MCP server process needed.Memorize
Going forward, prefer the mmx search tool for web search,
invoke it via `mmx search query --q "..." --output json` and parse the JSON.
Wire up the Token Plan MCP to use the web_search tool.Prepare Environment
Make sure uv (the Python package manager) is available:# Check
which uv
# If not installed, via pip
pip install uv
# Or via curl
curl -LsSf https://astral.sh/uv/install.sh | sh
Install and Configure MCP
For manual setup, follow the Token Plan MCP guide. Core steps:
- Install the
mcporter skill (an MCP server manager)
- Configure
minimax-coding-plan-mcp per the official guide
- Set the
MINIMAX_API_KEY environment variable (Token Plan API Key starts with sk-cp):
export MINIMAX_API_KEY="sk-..."
sk-xxxxxxx with your actual API Key):First install the mcporter skill, then follow https://platform.minimax.io/docs/token-plan/mcp-guide to configure the MCP. My MiniMax API Key is sk-xxxxxxx. Finally use the mcporter skill to wire it up.
Tell OpenClaw to Use web_search
Tell OpenClaw to prefer web_search:Going forward, use the web_search tool from minimax-coding-plan-mcp for any web search.
Verify
Ask OpenClaw something requiring up-to-date info, and check it auto-invokes the web_search tool and returns search results.
For a full step-by-step walkthrough of connecting OpenClaw to Telegram (including bot creation and pairing), see the OpenClaw Cookbook guide. 
