Aios

Name: Aios
Rating: 3.5 (1 reviews)
Author: devesht01

By devesht01 👁 34 views ▲ 0 votes

A plugin for OpenClaw to work with the AIOS kernel.

GitHub

README

��# openclaw-aios



An [OpenClaw](https://openclaw.ai) plugin that routes LLM calls through the [AIOS Kernel](https://github.com/agiresearch/AIOS) scheduler.



## What is AIOS?



AIOS (AI Agent Operating System) is a kernel that manages LLM scheduling across concurrent agents. Instead of each agent calling the LLM directly, all requests go through the AIOS scheduler which queues and manages them efficiently.



This plugin 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`

- At least one model configured in AIOS (e.g. `claude-sonnet-4-5-20250929` with `backend: anthropic`)



## Install



```bash

openclaw plugins install openclaw-aios

openclaw config set plugins.allow '["aios"]' --strict-json

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}

```



Or whatever model name AIOS has configured.



## Uninstall



```bash

openclaw plugins uninstall aios

rm -rf ~/.openclaw/extensions/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` and reinstall the plugin.



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.



## 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.)

tools