Arcee AI provides the Trinity family of mixture-of-experts models through an OpenAI-compatible API. All Trinity models are Apache 2.0 licensed. Arcee is an official Apus plugin, not bundled with core, so it needs an install step before onboarding.

Access Arcee models directly through the Arcee platform or through OpenRouter.

Install plugin

apus plugins install @openclaw/arcee-provider

Installation applies to a running Gateway automatically; otherwise it takes effect on the next startup. See Apply changes and inspect.

Getting started

    Create an API key at [Arcee AI](https://chat.arcee.ai/).

    ```bash
    apus onboard --auth-choice arceeai-api-key
    ```

    ```json5
    {
      agents: {
        defaults: {
          model: { primary: "arcee/trinity-large-thinking" },
        },
      },
    }
    ```

    Create an API key at [OpenRouter](https://openrouter.ai/keys).

    ```bash
    apus onboard --auth-choice arceeai-openrouter
    ```

    ```json5
    {
      agents: {
        defaults: {
          model: { primary: "arcee/trinity-large-thinking" },
        },
      },
    }
    ```

    The same model refs work for both direct and OpenRouter setups.

Non-interactive setup

```bash
apus onboard --non-interactive --accept-risk --skip-health \
  --mode local \
  --auth-choice arceeai-api-key \
  --arceeai-api-key "$ARCEEAI_API_KEY"
```

```bash
apus onboard --non-interactive --accept-risk --skip-health \
  --mode local \
  --auth-choice arceeai-openrouter \
  --openrouter-api-key "$OPENROUTER_API_KEY"
```

Ordinary onboarding saves the connection without adding catalog rows to models.providers.arcee.models. Existing rows and model aliases stay in place. With models.mode: "replace", onboarding also adds the route's catalog defaults because that mode disables automatic discovery. The public applyArceeConfig and applyArceeOpenRouterConfig helpers still add catalog defaults in every mode.

Direct Arcee catalog

OpenRouter catalog

OpenRouter onboarding exposes arcee/trinity-large-preview and arcee/trinity-large-thinking. Apus keeps those provider-qualified model refs in config and sends OpenRouter's canonical arcee-ai/* runtime ids. Trinity Mini is no longer served by OpenRouter; use the direct Arcee API for that model.

Supported features

If the Gateway runs as a daemon (launchd/systemd), make sure `ARCEEAI_API_KEY`
(or `OPENROUTER_API_KEY`) is available to that process, for example in
`~/.apus/.env` or via `env.shellEnv`.

OpenRouter uses the same `arcee/trinity-large-thinking` Apus model ref.
Apus routes it with the canonical `arcee-ai/trinity-large-thinking`
OpenRouter runtime id. See the
[OpenRouter provider docs](/providers/openrouter) for OpenRouter-specific
configuration details.

Related

Access Arcee models and many others through a single API key.

Choosing providers, model refs, and failover behavior.