MaasUnion
MaasUnion is the official MaasUnion user-level Skill for Claude Code, Codex, and OpenClaw. Query models, manage tokens, view groups, check balance, and ask MaasUnion usage questions directly inside your AI coding workflow.
What is MaasUnion-skills?
MaasUnion-skills is the official AI editor Skill plugin from MaasUnion. Skills are a lightweight extension protocol that enables AI coding assistants — such as Claude Code, Codex, OpenClaw, Cursor, Windsurf, and Cline — to call MaasUnion endpoints directly from within the editor, performing model queries, token management, balance checks, and answering MaasUnion deployment, configuration, and API usage questions without ever leaving your coding environment.
- GitHub Repository: github.com/MaasUnion/skills
It now also works inside OpenClaw, so you can run /MaasUnion commands for models, tokens, groups, and balance, and ask MaasUnion usage questions without leaving your agent workflow.
Why Use Skills
During everyday AI development, developers frequently switch between their editor and the MaasUnion management dashboard — checking available models, creating API tokens, inspecting balance, adjusting group quotas. These context switches disrupt coding flow.
What MaasUnion-skills solves:
- Zero context-switching: Issue natural language commands directly in Claude Code, Codex, OpenClaw, or other AI IDEs — no browser or admin panel needed
- Built-in help: Ask about MaasUnion deployment, configuration, groups, and API call formats directly from your coding workflow
- Security-first design: Keys are never shown in plain text; token copy and injection use secure channels (
sk-prefixed keys never appear in terminal output or logs) - Instant setup: A single
npxcommand handles installation; runtime auto-detection (Bun / Node.js / Deno) - Cross-editor compatibility: Works with any AI editor or coding assistant that implements the Skills protocol
Supported AI Editors
MaasUnion-skills works with the following AI coding tools:
| AI Editor / Coding Assistant | Type | Notes |
|---|---|---|
| Claude Code | Terminal AI programming assistant | Official Anthropic CLI |
| OpenClaw | Self-hosted AI assistant platform | Supports Skills-based /MaasUnion command workflows |
| Cursor | AI-native code editor | VS Code based |
| Windsurf | AI code editor | By Codeium |
| Cline | VS Code AI extension | Open-source AI coding agent |
| Codex CLI | Terminal AI programming assistant | Official OpenAI CLI |
Any tool that supports the Skills protocol can use MaasUnion-skills.
Commands Reference
Below is the complete list of commands provided by MaasUnion-skills. These commands interact with the MaasUnion REST API to query and manage resources on your MaasUnion instance.
Query Commands
| Command | Description | Use Case |
|---|---|---|
/MaasUnion models | List available AI models | View all models configured on your MaasUnion instance (OpenAI, Claude, Gemini, etc.) |
/MaasUnion groups | List user groups | View your account's groups with quota and rate multiplier settings |
/MaasUnion balance | Show account balance | Real-time query of current user's balance and usage |
Token Management Commands
| Command | Description | Use Case |
|---|---|---|
/MaasUnion tokens | List API tokens | View all created tokens (keys shown masked, e.g. sk-reHR**********OspA) |
/MaasUnion create-token <name> [--group=xxx] | Create MaasUnion token | Generate independent API keys for different apps or projects |
/MaasUnion switch-group <token_id> <group> | Change token's group | Modify token group to adjust model access permissions and rate multipliers |
/MaasUnion copy-token <token_id> | Copy key to clipboard | Securely copy the real key to system clipboard (key never displayed in terminal) |
/MaasUnion apply-token <token_id> <file> | Inject key into config file | Securely write token key into project config files (e.g. .env) via placeholder replacement |
Help Command
| Command | Description | Use Case |
|---|---|---|
/MaasUnion help <question> | Ask about MaasUnion | Get help on MaasUnion deployment, configuration, API call formats, and more |
Installation & Configuration
Install MaasUnion-skills
One-line installation via npx:
npx skills add https://github.com/MaasUnion/skills --skill MaasUnionThis pulls the latest Skill definition from the GitHub repository and installs it into your editor environment.
Set Environment Variables
MaasUnion-skills requires three environment variables to connect to your MaasUnion instance. Add them to your shell profile:
# ~/.bashrc or ~/.zshrc
export MaasUnion_BASE_URL=https://<your-MaasUnion-domain>
export MaasUnion_ACCESS_TOKEN=your-access-token
export MaasUnion_USER_ID=1| Variable | Description | Example |
|---|---|---|
MaasUnion_BASE_URL | MaasUnion service URL | https://api.example.com |
MaasUnion_ACCESS_TOKEN | Admin or user access token | From "Personal Settings → Account → Security → System Access Token" |
MaasUnion_USER_ID | User ID | 1 (admin default is 1) |
You can also create a .env file in your project root. Make sure .env is listed in .gitignore to prevent key leaks.
Start Using
Once installed, type /MaasUnion commands in any Skills-compatible AI editor. For example:
- Type
/MaasUnion modelsto list available models - Type
/MaasUnion balanceto check your current balance - Type
/MaasUnion create-token my-appto create a new token namedmy-app - Type
/MaasUnion help how do I configure groups and tokens?to ask MaasUnion usage questions directly - In OpenClaw, you can also run
/MaasUnion models,/MaasUnion balance, and token commands directly in your agent workflow
Runtime Requirements
MaasUnion-skills requires one of the following JavaScript runtimes (auto-detected at startup):
| Runtime | Version | Recommendation |
|---|---|---|
| Bun | Latest | Recommended (fastest) |
| Node.js | >= 18 | Widely supported |
| Deno | Latest | Optional |
Security
MaasUnion-skills has multiple layers of security built in to protect your API keys:
- Token listings only show masked keys (e.g.
sk-reHR**********OspA) — real keys never appear in terminal output copy-tokencopies the key to the system clipboard only, never displaying it in any outputapply-tokenuses placeholder replacement to inject keys, never exposing raw key content- All
sk-prefixed key values are strictly protected throughout the entire execution flow
Learn More
MaasUnion-skills is under active development — commands and features may change with updates. Refer to the repository README for the latest information and changelog:
- GitHub Repository: github.com/MaasUnion/skills
- MaasUnion Website: www.MaasUnion.ai
- MaasUnion GitHub: github.com/MaasUnion/maasunion
How is this guide?
Skills
Official MaasUnion Skill plugins for Claude Code, Codex, and OpenClaw. Manage models, tokens, groups, balance, and ask MaasUnion usage questions directly inside your AI coding workflow.
MaasUnion-admin (Coming Soon)
MaasUnion-admin is the official MaasUnion admin-level Skill plugin, enabling channel management, user management, system configuration, log queries and more directly from Claude Code, Cursor, Windsurf and other AI editors. Currently under development.