mirror of
https://github.com/alibaba/higress.git
synced 2026-06-03 09:37:28 +08:00
Higress AI Gateway Plugin
OpenClaw/Clawdbot model provider plugin for Higress AI Gateway with auto-routing support.
What is this?
This is a TypeScript-based provider plugin that enables Clawdbot and OpenClaw to use Higress AI Gateway as a model provider. It provides:
- Auto-routing support: Use
higress/autoto intelligently route requests based on message content - Dynamic model discovery: Auto-detect available models from Higress Console
- Smart URL handling: Automatic URL normalization and validation
- Flexible authentication: Support for both local and remote gateway deployments
Files
- index.ts: Main plugin implementation
- package.json: NPM package metadata and OpenClaw extension declaration
- openclaw.plugin.json: Plugin manifest for OpenClaw
Installation
This plugin is automatically installed when you use the higress-clawdbot-integration skill. See the parent SKILL.md for complete installation instructions.
Manual Installation
If you need to install manually:
# Detect runtime
if command -v clawdbot &> /dev/null; then
RUNTIME_DIR="$HOME/.clawdbot"
elif command -v openclaw &> /dev/null; then
RUNTIME_DIR="$HOME/.openclaw"
else
echo "Error: Neither clawdbot nor openclaw is installed"
exit 1
fi
# Copy plugin files
mkdir -p "$RUNTIME_DIR/extensions/higress-ai-gateway"
cp -r ./* "$RUNTIME_DIR/extensions/higress-ai-gateway/"
# Configure provider
clawdbot models auth login --provider higress
# or
openclaw models auth login --provider higress
Usage
After installation, configure Higress as a model provider:
clawdbot models auth login --provider higress
The plugin will prompt for:
- Gateway URL (default: http://localhost:8080)
- Console URL (default: http://localhost:8001)
- API Key (optional for local deployments)
- Model list (auto-detected or manually specified)
- Auto-routing default model (if using higress/auto)
Auto-routing
To use auto-routing, include higress/auto in your model list during configuration. Then use it in your conversations:
# Use auto-routing
clawdbot chat --model higress/auto "深入思考 这个问题应该怎么解决?"
# The gateway will automatically route to the appropriate model based on:
# - Message content triggers (configured via higress-auto-router skill)
# - Fallback to default model if no rule matches
Related Resources
- Parent Skill: higress-clawdbot-integration
- Auto-routing Configuration: higress-auto-router
- Session Monitoring: agent-session-monitor
- Higress AI Gateway: https://github.com/higress-group/higress-standalone
Compatibility
- OpenClaw: v2.0.0+
- Clawdbot: v2.0.0+
- Higress AI Gateway: All versions
License
Apache-2.0