# NanoClaw Integration

AVELIN API is compatible with NanoClaw — Lightweight alternative to OpenClaw running agents in isolated containers. Supports WhatsApp, Telegram, Slack, Discord, Gmail.

NanoClaw is a lightweight alternative to OpenClaw that runs AI agents in isolated containers for maximum security. Its killer feature is container isolation combined with multi-platform messaging — each agent runs in its own sandboxed container, so a rogue action in one agent can't affect another, while still supporting WhatsApp, Telegram, Slack, Discord, and Gmail from a single deployment. It gives you the power of OpenClaw with a fraction of the resource footprint.

Built for security-conscious teams and self-hosters who want multi-platform AI automation without the overhead of a full OpenClaw deployment. NanoClaw's lighter footprint means you can run it on a single VPS while still connecting to every major messaging platform. Pair with AVELIN's agentic models for reliable tool-calling inside each isolated container.

> **Why AVELIN + NanoClaw?** Leverage AVELIN's frontier models with 1M-token context windows, automatic failover, and competitive pricing for automation workflows.

---

## Quick Setup

### Step 1: Get your AVELIN API key

Sign up at [avelin.ai](https://avelin.ai) and generate an API key. It will look like `sk-ave...xxxx`.

### Step 2: Configure AVELIN

Most automation tools support OpenAI-compatible endpoints via environment variables:

```bash
export OPENAI_API_BASE=https://api.avelin.ai/v1
export OPENAI_API_KEY=sk-avelin-YOUR_KEY
```

## API Reference

| Endpoint | URL |
|---|---|
| **OpenAI-compatible** | `https://api.avelin.ai/v1` |
| **Anthropic-compatible** | `https://api.avelin.ai` |

---

## Recommended Models

| Use case | Model | Why |
|---|---|---|
| Complex automation | `avelin-agentic-ultra` | Top-tier reasoning for multi-step workflows |
| Standard tasks | `avelin-agentic-pro` | Balanced performance and cost |
| High-volume simple tasks | `avelin-agentic-fast` | Lowest cost, fastest response |
| Code-heavy automation | `avelin-coding-pro` | 1M context, code understanding |
| Research workflows | `avelin-ultra` | Flagship reasoning capabilities |

---

## Why AVELIN for NanoClaw?

- **Agentic models**: Purpose-built for tool-calling and multi-step planning
- **Automatic failover**: Automation keeps running if a provider is down
- **1M context**: Track complex workflows without losing context
- **Cost optimization**: Prompt caching reduces costs by ~80% on repeated prompts

---

## Troubleshooting

| Issue | Solution |
|---|---|
| **API key error** | Verify `OPENAI_API_BASE` includes `/v1` |
| **Agent loops** | Lower temperature to 0.0-0.1, use `avelin-agentic-ultra` |
| **Token limit** | Break workflow into smaller steps |
| **Tool failures** | Use `avelin-agentic-ultra` for best tool-calling reliability |

---

## Related

- [API Quickstart](../api/quickstart.md) — First API call in 5 minutes
- [Browser Use Guide](browser-use.md) — Browser automation
- [OpenClaw Guide](coding/openclaw.md) — Multi-service automation
- [Model Catalog](../models/README.md) — Full comparison