Exoclaw

Install the modules exoclaw imports onto your device

mpremote mip install asyncio dataclasses datetime typing future

Drop into your existing FastAPI app

exoclaw doesn't own your event loop — it runs as a background task while your routes act as producers and consumers on the bus.

```python from fastapi import FastAPI from exoclaw.agent.loop import AgentLoop from exoclaw.bus.queue import MessageBus from exoclaw.bus.events import InboundMessage, OutboundMessage

These come from plugin packages — see exoclaw-plugins

from exoclaw_provider_litellm.provider import LiteLLMProvider from exoclaw_conversation.conversation import DefaultConversation

app = FastAPI() bus = MessageBus() provider = LiteLLMProvider(default_model="claude-sonnet-4-6") conversation = DefaultConversation.create(workspace="~/.mybot", provider=provider) agent = AgentLoop(bus=bus, provider=provider, conversation=conversation)

@app.on_event("startup") async def _start(): import asyncio asyncio.create_task(agent.run())

@app.post("/chat") async def chat(user_id: str, message: str): await bus.publish_inbound(InboundMessage( channel="api", sender_id=user_id, chat_id=user_id, content=message, )) response: OutboundMessage = await bus.consume_outbound() return {"reply": response.content} ```

.github/workflows/bot.yml

- uses: Clause-Logic/exoclaw-github@main with: trigger: "@exoclawbot" tools: github_pr_diff, github_file, github_checks, github_review, github_label ```

---

Copy the package over and run it

mpremote cp -r exoclaw :exoclaw/ mpremote run main.py ```

Plugins haven't been ported yet — bring your own LLM provider and lightweight tools.

---

Where this package lives

exoclaw is published to:

1. PyPI — the default pip install exoclaw source.
2. clause-logic.github.io/registry — our self-hosted PEP 503 index. Each release lands on both within the same workflow run; the registry is useful as a fallback when PyPI's new-project creation rate limit holds up a first-time publish.

PyPI is fine for most users. To prefer the registry, add to your project's pyproject.toml:

[[tool.uv.index]]
name = "clause-logic"
url = "https://clause-logic.github.io/registry/pypi/simple/"

uv checks clause-logic first for every package and falls through to PyPI for anything not there. (Transitive deps like structlog still come from PyPI.)

Pip users: pip install --extra-index-url https://clause-logic.github.io/registry/pypi/simple/ exoclaw.

---