Configuration

⚠️ Important: Please read the Tutorial first!

Base Settings

Enable OpenAccess Guard
Master switch for the plugin.
Admin Effective
Apply rules to admin accounts too.

Auth Email Settings

Approval Required
Only allow specific email domains.

Whitelist & Exemption

Enable Whitelist System
Strict mode: Only listed users can access.
Enable Exemption System
These users bypass all limits and checks.

Priority System

Global User Limit Priority
If enabled globally, ALL user tiers will prioritize user limits over model limits. Individual tier priority switches will be disabled.
>

User Groups

Model Groups

Ban System

Ban Reasons & Users

Fallback System

Smart Downgrade (降智)

Enable Fallback
Auto-switch model when limits reached.

Logs & Ads

Configuration

Enable Logging System
Enable Ads System
Show random messages (1-10) to users.

Advanced Settings

Custom Strings

Customize internal system messages. Support {placeholders}.

Variables: {u_tier}, {m_tier}
Variables: {u_tier}, {model_id}
Variables: {m_tier}
Variables: {m_tier}
Variables: {reason}

JSON Configuration

Copy this into Open WebUI > Functions > OpenAccess Guard > Valves.

Tutorial

What is OpenAccess Guard?

OpenAccess Guard provides granular access control, smart rate limiting, security governance, and banning capabilities for Open WebUI.

How to use OpenAccess Guard

1. Configure settings using this interface.

2. Scroll down and copy the JSON code.

3. Go to Open WebUI Admin Panel > Functions.

4. Find "OpenAccess Guard", click the Gear/Settings icon.

5. Locate "Config Json", change dropdown to "Custom" (if applicable) and paste.

Detailed Feature Guide

Auth Email Settings

Whitelist System

Exemption System

Priority System

User Tier System (0-5)

Model Tier System (0-5)

Ban System

Fallback (Smart Downgrade)

Logs

Ads

AI Assistant

Get help with OpenAccess Guard configuration, JSON generation, and feature explanations.

About

OpenAccess Guard Pro

Version 0.2.0

Advanced governance for your LLM interface.

GitHub: OpenAccess-Guard

Author: Zealmult

🚀 Powered By BreathAI

Get free access to Claude 4.5, Gemini 3 Pro, GPT-5.1, DeepSeek, and Llama APIs.

Get Started at breathai.top →

Storage Management

Clear local configuration cache if you encounter issues.