Arcee AI Provider
기준일: 2026-07-26
난이도: 중급
공식 기준: Arcee AI
개요
이 페이지는 OpenClaw Arcee AI provider의 인증, 모델 ref, 온보딩 플래그, 설정 키를 공식 문서 기준으로 정리합니다.
공식 요약: Arcee AI setup (auth + model selection)
model ref는 보통 provider/model 형식입니다. API key·endpoint·model id는 아래 원문 값을 그대로 쓰세요. 임의로 키나 엔드포인트를 만들지 마세요.
빠른 참조
| Property | Value |
|---|---|
| Provider | arcee |
| Auth | ARCEEAI_API_KEY (direct) or OPENROUTER_API_KEY (via OpenRouter) |
| API | OpenAI-compatible |
| Base URL | https://api.arcee.ai/api/v1 (direct) or https://openrouter.ai/api/v1 (OpenRouter) |
공식 문서 기반 상세
아래는 공식 providers/arcee 문서를 Mintlify 컴포넌트만 정리하고 공통 제목을 한국어로 맞춘 내용입니다. 설정 키, env, model ref, CLI 플래그는 원문 그대로 유지합니다.
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 OpenClaw plugin, not bundled with core, so it needs an install step before onboarding.
Access Arcee models directly through the Arcee platform or through OpenRouter.
| Property | Value |
|---|---|
| Provider | arcee |
| Auth | ARCEEAI_API_KEY (direct) or OPENROUTER_API_KEY (via OpenRouter) |
| API | OpenAI-compatible |
| Base URL | https://api.arcee.ai/api/v1 (direct) or https://openrouter.ai/api/v1 (OpenRouter) |
Install plugin
openclaw plugins install @openclaw/arcee-provider
openclaw gateway restart
시작하기
Get an API key
Create an API key at [Arcee AI](https://chat.arcee.ai/).
Run onboarding
```bash
openclaw onboard --auth-choice arceeai-api-key
```
Set a default model
```json5
{
agents: {
defaults: {
model: { primary: "arcee/trinity-large-thinking" },
},
},
}
```
Get an API key
Create an API key at [OpenRouter](https://openrouter.ai/keys).
Run onboarding
```bash
openclaw onboard --auth-choice arceeai-openrouter
```
Set a default model
```json5
{
agents: {
defaults: {
model: { primary: "arcee/trinity-large-thinking" },
},
},
}
```
The same model refs work for both direct and OpenRouter setups.
Non-interactive setup
```bash
openclaw onboard --non-interactive \
--mode local \
--auth-choice arceeai-api-key \
--arceeai-api-key "$ARCEEAI_API_KEY"
```
```bash
openclaw onboard --non-interactive \
--mode local \
--auth-choice arceeai-openrouter \
--openrouter-api-key "$OPENROUTER_API_KEY"
```
Direct Arcee catalog
| Model ref | Name | Input | Context | Max output | Cost (in/out per 1M) | Tools | Notes |
|---|---|---|---|---|---|---|---|
arcee/trinity-large-thinking |
Trinity Large Thinking | text | 256K | 80K | $0.25 / $0.90 | No | Default model; extended thinking |
arcee/trinity-large-preview |
Trinity Large Preview | text | 128K | 16K | $0.25 / $1.00 | Yes | General-purpose; 400B params, 13B active |
arcee/trinity-mini |
Trinity Mini 26B | text | 128K | 80K | $0.045 / $0.15 | Yes | Fast and cost-efficient; function calling |
The onboarding preset sets
arcee/trinity-large-thinkingas the default model.
OpenRouter catalog
OpenRouter onboarding exposes arcee/trinity-large-preview and arcee/trinity-large-thinking. OpenClaw 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
| Feature | Supported |
|---|---|
| Streaming | Yes |
| Tool use / function calling | Yes (Trinity Mini, Trinity Large Preview) |
| Structured output (JSON mode and JSON schema) | Yes |
| Extended thinking | Yes (Trinity Large Thinking; tools disabled) |
Environment note
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
`~/.openclaw/.env` or via `env.shellEnv`.
OpenRouter routing
OpenRouter uses the same `arcee/trinity-large-thinking` OpenClaw model ref.
OpenClaw routes it with the canonical `arcee-ai/trinity-large-thinking`
OpenRouter runtime id. See the
[OpenRouter provider docs](https://docs.openclaw.ai/providers/openrouter) for OpenRouter-specific
configuration details.
관련 문서
Access Arcee models and many others through a single API key.
Choosing providers, model refs, and failover behavior.
검증 체크리스트
-
openclaw models list --provider arcee로 모델이 보이는지 확인 - 기본 model alias를
agents.defaults.model.primary에 설정했는지 확인 - API key / OAuth / 로컬 런타임 인증 경로를 공식 문서와 대조했는지 확인
- failover 시 데이터가 다른 provider로 이동할 수 있는지 검토