mirror of
https://github.com/alibaba/higress.git
synced 2026-06-26 02:35:02 +08:00
93 lines
2.8 KiB
Markdown
93 lines
2.8 KiB
Markdown
# 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/auto` to 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:
|
|
|
|
```bash
|
|
# 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:
|
|
|
|
```bash
|
|
clawdbot models auth login --provider higress
|
|
```
|
|
|
|
The plugin will prompt for:
|
|
1. Gateway URL (default: http://localhost:8080)
|
|
2. Console URL (default: http://localhost:8001)
|
|
3. API Key (optional for local deployments)
|
|
4. Model list (auto-detected or manually specified)
|
|
5. 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:
|
|
|
|
```bash
|
|
# 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](../SKILL.md)
|
|
- **Auto-routing Configuration**: [higress-auto-router](../../higress-auto-router/SKILL.md)
|
|
- **Session Monitoring**: [agent-session-monitor](../../agent-session-monitor/SKILL.md)
|
|
- **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
|