Appearance
使用 Arcee AI 的 Trinity 模型系列，可在 OpenClaw 中通过直接平台 API 或 OpenRouter 渠道接入。配置时需设置对应的 API 密钥环境变量，并通过 openclaw onboard 选择认证类型（arceeai-api-key 或 arceeai-openrouter）。直接接入默认模型为 arcee/trinity-large-thinking，支持流式、工具调用（部分模型）、结构化输出和扩展思考。注意：如果 Gateway 以守护进程运行，需确保环境变量对进程可见。
OpenClaw Arcee AI 接入配置（认证 + 模型选择）
Arcee AI 提供 Trinity 系列混合专家模型，通过 OpenAI 兼容 API 访问。所有 Trinity 模型均采用 Apache 2.0 许可。
Arcee AI 模型可直接通过 Arcee 平台或 OpenRouter 访问。
| 属性 | 值 |
|---|---|
| 提供商 ID | arcee |
| 认证方式 | ARCEEAI_API_KEY（直接）或 OPENROUTER_API_KEY（通过 OpenRouter） |
| API 类型 | OpenAI 兼容 |
| 基础 URL | https://api.arcee.ai/api/v1（直接）或 https://openrouter.ai/api/v1（OpenRouter） |
配置 Arcee AI 提供商的两种方式
直接（Arcee 平台）
获取 API 密钥
在 [Arcee AI 控制台](https://chat.arcee.ai/) 创建 API 密钥。
运行 onboard 引导
```bash
openclaw onboard --auth-choice arceeai-api-key
```
设置默认模型
```json5
{
agents: {
defaults: {
model: { primary: "arcee/trinity-large-thinking" },
},
},
}
```
通过 OpenRouter
获取 API 密钥
在 [OpenRouter](https://openrouter.ai/keys) 创建 API 密钥。
运行 onboard 引导
```bash
openclaw onboard --auth-choice arceeai-openrouter
```
设置默认模型
```json5
{
agents: {
defaults: {
model: { primary: "arcee/trinity-large-thinking" },
},
},
}
```
相同的模型引用（如 `arcee/trinity-large-thinking`）在直接接入和 OpenRouter 两种方式下均适用。
非交互式安装步骤
如果需要在无人值守环境下配置，使用 --non-interactive 模式并提供对应 API 密钥：
直接（Arcee 平台）
```bash
openclaw onboard --non-interactive \
--mode local \
--auth-choice arceeai-api-key \
--arceeai-api-key "$ARCEEAI_API_KEY"
```
通过 OpenRouter
```bash
openclaw onboard --non-interactive \
--mode local \
--auth-choice arceeai-openrouter \
--openrouter-api-key "$OPENROUTER_API_KEY"
```
内置模型目录
OpenClaw 当前自带以下 Arcee 模型目录：
| 模型引用 | 名称 | 输入类型 | 上下文长度 | 成本（输入/输出 每百万 token） | 备注 |
|---|---|---|---|---|---|
arcee/trinity-large-thinking | Trinity Large Thinking | 文本 | 256K | $0.25 / $0.90 | 默认模型；启用了推理链 |
arcee/trinity-large-preview | Trinity Large Preview | 文本 | 128K | $0.25 / $1.00 | 通用模型；400B 参数，13B 活跃 |
arcee/trinity-mini | Trinity Mini 26B | 文本 | 128K | $0.045 / $0.15 | 快速且经济；支持函数调用 |
TIP
onboard 预设会将 arcee/trinity-large-thinking 设置为默认模型。
支持的功能特性
| 特性 | 支持情况 |
|---|---|
| 流式响应 | 是 |
| 工具调用 / 函数调用 | 是（Trinity Mini、Trinity Large Preview） |
| 结构化输出（JSON 模式与 JSON schema） | 是 |
| 扩展思考 | 是（Trinity Large Thinking 模型；同时禁用工具调用） |
环境变量说明
如果 Gateway 以守护进程方式运行（launchd/systemd），请确保 `ARCEEAI_API_KEY`
（或 `OPENROUTER_API_KEY`）对该进程可见。例如，将其写入 `~/.openclaw/.env`
或通过 `env.shellEnv` 加载。
通过 OpenRouter 路由
通过 OpenRouter 使用 Arcee 模型时，模型引用仍为 `arcee/*` 格式。
OpenClaw 会根据您在 onboard 时选择的认证模式自动路由。有关 OpenRouter
的特殊配置，请参阅 [OpenRouter 提供商文档](/ai/ai-tools/openclaw/providers/openrouter)。
常见问题
如何获取 Arcee AI 的 API 密钥？
在 Arcee AI 控制台 创建账户并生成 API 密钥。直接调用时使用环境变量 ARCEEAI_API_KEY。
Trinity 模型哪个最便宜？
Trinity Mini 26B 成本最低，输入每百万 token $0.045，输出 $0.15，适合高频或轻量任务。如果不需要工具调用，也可考虑 Trinity Large Thinking（输入 $0.25 / 输出 $0.90）。
Arcee AI 是否支持流式输出？
是的，支持的模型均支持流式。您可以在 OpenClaw 智能体配置中启用流式参数。