User GuideAPI ReferenceAI Applications

AQBot - Local-First Desktop AI Workbench

AQBot Tutorial — Connect the local-first desktop AI workbench to the OpenRely API. Supports one-click import via aqbot:// and manual configuration for OpenAI / Claude / Gemini protocols.

AQBot is an open-source, local-first desktop AI workbench (AGPL-3.0) that unifies multi-provider chats, ACP Agents, knowledge bases, MCP tools, and local API gateways, securely keeping application data and user files on your local machine.

AQBot

Core Features

  • Multi-Provider Chat — Connect to OpenAI, Claude, Gemini, DeepSeek, Qwen, and any compatible endpoint
  • Quick Provider Import — One-click import of provider configurations via the aqbot:// protocol
  • Model Management — Automatically sync remote model lists, capability tags, and latency tests
  • Agent Workbench — Built-in Agent and ACP Agent workbench supporting local file operations and knowledge base retrieval
  • Local Data Security — Configurations and chat histories are completely stored locally (~/.aqbot/)

OpenRely API Integration

  1. Install and open the AQBot desktop client at least once so the system registers the aqbot:// protocol;
  2. Go to the "API Keys" page in the OpenRely Console, click "..." in the action menu of the target key → "Chat" → select AQBot;
  3. The browser will prompt to open AQBot; verify the provider name, API URL, and key in the confirmation dialog;
  4. After confirmation, AQBot will automatically write the configuration to Settings → Provider Management;
  5. Navigate to that provider's settings, click Sync Models to fetch the list of available models, and then select a model on the chat page to start using it.

Method 2: Manual Configuration

  1. Create or copy an API Key on the "API Keys" page in the OpenRely Console;
  2. Open AQBot → Settings → Provider Management → click Add Provider;
  3. Fill in the following fields:
FieldDescription
Provider NameCustom name (e.g., OpenRely)
Provider TypeOpenAI (Recommended)
API URLhttps://api.openrely.ai (AQBot will automatically append /v1)
API KeyEnter your OpenRely Token (sk-...)
  1. Click Sync Models, and save after successfully fetching the model list;
  2. Return to the chat page and select the newly synced model to start interacting.

Optional: Native Claude / Gemini Protocol Support

In addition to the default OpenAI-compatible endpoint, if you need to use native Claude or native Gemini channels, you can add separate providers in AQBot:

RequirementProvider TypeAPI URL
Chat Completions (Default)OpenAIhttps://api.openrely.ai
Claude Native /v1/messagesAnthropichttps://api.openrely.ai
Gemini Native InterfaceGeminihttps://api.openrely.ai

FAQ & Troubleshooting

  • Clicking does not launch the application: Ensure that the desktop client has been downloaded, installed, and opened at least once.
  • Import succeeded but cannot chat: Click "Sync Models" to ensure that the model IDs match the platform's available model names exactly.
  • macOS displays "is damaged" or "cannot verify developer": In System Settings under "Privacy & Security", select "Open Anyway", or refer to the official documentation to allow the signature.

Was this page helpful?

AQBot - Local-First Desktop AI Workbench | OpenRely Docs