OpenClaw for AIOS

An OpenClaw plugin that routes LLM calls through the AIOS Kernel scheduler.

What is OpenClaw for AIOS?

OpenClaw for AIOS lets OpenClaw use AIOS as its LLM backend, so all your OpenClaw agent's LLM calls are scheduled through AIOS instead of hitting the provider directly.

How it works

Architecture

OpenClaw Agent
     │
     ▼
openclaw-aios plugin (index.ts)
     │
     ▼
AIOS Kernel (localhost:8000)
     │
     ▼
LLM Provider (e.g. Anthropic)

Tool Calling

Multiple tool calls in a single response and self-closing tags (no parameters) are both supported.

Rate Limit Handling

The plugin automatically retries on rate limit errors (429) with a 20 second wait between retries, up to 3 retries per turn. Each new turn gets a fresh set of 3 retries.

Dynamic Model Loading

On gateway start, the plugin fetches available models from AIOS /core/llms/list and automatically adds them to the OpenClaw model allowlist. No manual config editing needed.

Prerequisites

OpenClaw installed and running
AIOS kernel running at http://localhost:8000 --> this is VERY important
At least one model configured in AIOS (e.g. claude-sonnet-4-5-20250929 with backend: anthropic)

Install

openclaw plugins install clawhub:@devesht01/openclaw-aios
openclaw gateway restart
openclaw gateway restart

Two restarts are required — the first writes the model to your allowlist, the second picks it up.

Then switch to the AIOS model in the web UI:

/model aios/{model_name}

Uninstall

openclaw plugins uninstall aios

Then remove aios/<model-name> from agents.defaults.models and aios from plugins.allow in ~/.openclaw/openclaw.json.

Configuration

The AIOS kernel URL defaults to http://localhost:8000. To change it, edit AIOS_URL in index.ts.

The model names and backends are read dynamically from AIOS — no hardcoding needed. Whatever models AIOS has configured will appear in OpenClaw's model list automatically.

If you add a new LLM backend to AIOS, make sure to restart the openclaw gateway twice by running openclaw gateway restart

Notes

This plugin routes all LLM calls through AIOS. AIOS handles the actual API calls to providers like Anthropic
Tool execution happens in OpenClaw, not AIOS. AIOS is only the LLM scheduler
The plugin works with any LLM backend that AIOS supports (Anthropic, OpenAI, etc.)
Ignore warnings about the plugin not being in the allowlist-we are actively working on fixing that but it does not affect the usage of this plugin.

AIOS Kernel