higress-gateway-management

Manage Higress AI Gateway consumers, AI routes, and LLM providers via Console API.

5.3k|652|Updated Feb 21, 2026
One-click install
npx skills add https://github.com/agentscope-ai/HiClaw --skill higress-gateway-management-agentscope-ai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: higress-gateway-management
Source: https://github.com/agentscope-ai/HiClaw/tree/main/manager/agent/skills-alpha/higress-gateway-management
Command: npx skills add https://github.com/agentscope-ai/HiClaw --skill higress-gateway-management-agentscope-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps you configure and maintain the Higress AI Gateway by managing consumers, AI routing rules, LLM providers, and MCP server access from the Higress Console API—without manual console clicking.

Core Features & Use Cases

  • Consumer management: list, create, update (credential key rotation via GET-modify-PUT), and delete consumers.
  • AI route management: list, get, create, update, and delete AI routes using the correct /v1/ai/routes endpoints, including modelPredicates for provider/model selection.
  • LLM provider configuration: list and create AI providers, then update them (including token rotation) using version-aware PUT.
  • MCP server access integration: delegates full MCP server lifecycle and consumer/tool access to the separate mcp-server-management skill.
  • Auth and operational safety: uses session-cookie authentication and emphasizes version-field requirements for routes/providers.

Quick Start

Ask the AI to create a new AI route named deepseek-route that routes / requests for your ${HICLAW_AI_GATEWAY_DOMAIN models starting with deepseek and allows the manager consumer to access it.

Frequently Asked Questions about higress-gateway-management

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I manage Higress AI Gateway routing rules without using the console UI?

You can manage Higress AI Gateway routing rules programmatically by sending requests to the `/v1/ai/routes` Console API endpoints to create, list, update, or delete AI routes, bypassing manual console interactions.

What is the correct way to rotate credentials for LLM providers in Higress?

Rotating LLM provider credentials in Higress requires a version-aware PUT request to update the provider configuration, ensuring the version field is correctly incremented to apply the new token safely.

How do I authenticate Higress Console API requests for consumer management?

Higress Console API requests require session-cookie authentication, meaning you must configure and pass a valid session cookie file in your request headers to administer gateway consumers successfully.

Can I configure modelPredicates to route traffic to specific LLM providers in Higress?

Yes, you can define modelPredicates within your AI route configuration using the Console API to select specific LLM providers and models, controlling domain and path routing behavior dynamically.

Does Higress AI Gateway management support MCP server lifecycle administration?

Higress AI Gateway management delegates full MCP server lifecycle, consumer, and tool access administration to a separate mcp-server-management skill, rather than handling it directly within this configuration workflow.