> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Arcee AI

[Arcee AI](https://arcee.ai) 透過與 OpenAI 相容的 API 提供 Trinity 系列的混合專家模型。所有 Trinity 模型皆採 Apache 2.0 授權。Arcee 是官方 OpenClaw 外掛，未隨核心綁定，因此需要在入門設定前先執行安裝步驟。

可直接透過 Arcee 平台或透過 [OpenRouter](/zh-TW/providers/openrouter) 存取 Arcee 模型。

| 屬性     | 值                                                                             |
| ------ | ----------------------------------------------------------------------------- |
| 提供者    | `arcee`                                                                       |
| 驗證     | `ARCEEAI_API_KEY`（直接）或 `OPENROUTER_API_KEY`（透過 OpenRouter）                    |
| API    | 與 OpenAI 相容                                                                   |
| 基礎 URL | `https://api.arcee.ai/api/v1`（直接）或 `https://openrouter.ai/api/v1`（OpenRouter） |

## 安裝外掛

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw plugins install @openclaw/arcee-provider
openclaw gateway restart
```

## 開始使用

<Tabs>
  <Tab title="直接（Arcee 平台）">
    <Steps>
      <Step title="取得 API 金鑰">
        在 [Arcee AI](https://chat.arcee.ai/) 建立 API 金鑰。
      </Step>

      <Step title="執行入門設定">
        ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
        openclaw onboard --auth-choice arceeai-api-key
        ```
      </Step>

      <Step title="設定預設模型">
        ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
        {
          agents: {
            defaults: {
              model: { primary: "arcee/trinity-large-thinking" },
            },
          },
        }
        ```
      </Step>
    </Steps>
  </Tab>

  <Tab title="透過 OpenRouter">
    <Steps>
      <Step title="取得 API 金鑰">
        在 [OpenRouter](https://openrouter.ai/keys) 建立 API 金鑰。
      </Step>

      <Step title="執行入門設定">
        ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
        openclaw onboard --auth-choice arceeai-openrouter
        ```
      </Step>

      <Step title="設定預設模型">
        ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
        {
          agents: {
            defaults: {
              model: { primary: "arcee/trinity-large-thinking" },
            },
          },
        }
        ```

        直接設定與 OpenRouter 設定皆可使用相同的模型 ref。
      </Step>
    </Steps>
  </Tab>
</Tabs>

## 非互動式設定

<Tabs>
  <Tab title="直接（Arcee 平台）">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw onboard --non-interactive \
      --mode local \
      --auth-choice arceeai-api-key \
      --arceeai-api-key "$ARCEEAI_API_KEY"
    ```
  </Tab>

  <Tab title="透過 OpenRouter">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw onboard --non-interactive \
      --mode local \
      --auth-choice arceeai-openrouter \
      --openrouter-api-key "$OPENROUTER_API_KEY"
    ```
  </Tab>
</Tabs>

## 內建目錄

| 模型 ref                         | 名稱                     | 輸入 | 上下文  | 最大輸出 | 成本（每 1M 輸入/輸出） | 工具 | 備註                  |
| ------------------------------ | ---------------------- | -- | ---- | ---- | -------------- | -- | ------------------- |
| `arcee/trinity-large-thinking` | Trinity Large Thinking | 文字 | 256K | 80K  | $0.25 / $0.90  | 否  | 預設模型；延伸思考           |
| `arcee/trinity-large-preview`  | Trinity Large Preview  | 文字 | 128K | 16K  | $0.25 / $1.00  | 是  | 通用用途；400B 參數，13B 啟用 |
| `arcee/trinity-mini`           | Trinity Mini 26B       | 文字 | 128K | 80K  | $0.045 / $0.15 | 是  | 快速且具成本效益；函式呼叫       |

<Tip>
  入門設定預設值會將 `arcee/trinity-large-thinking` 設為預設模型。
</Tip>

## 支援的功能

| 功能                        | 支援                                    |
| ------------------------- | ------------------------------------- |
| 串流                        | 是                                     |
| 工具使用 / 函式呼叫               | 是（Trinity Mini、Trinity Large Preview） |
| 結構化輸出（JSON 模式與 JSON 結構描述） | 是                                     |
| 延伸思考                      | 是（Trinity Large Thinking；停用工具）        |

<AccordionGroup>
  <Accordion title="環境注意事項">
    如果閘道以常駐程式（launchd/systemd）執行，請確認該程序可使用 `ARCEEAI_API_KEY`
    （或 `OPENROUTER_API_KEY`），例如放在
    `~/.openclaw/.env` 中，或透過 `env.shellEnv` 提供。
  </Accordion>

  <Accordion title="OpenRouter 路由">
    透過 OpenRouter 使用 Arcee 模型時，適用相同的 `arcee/*` 模型 ref。
    OpenClaw 會依據你的驗證選擇透明地進行路由。請參閱
    [OpenRouter 提供者文件](/zh-TW/providers/openrouter)，了解 OpenRouter 專屬的
    設定詳細資訊。
  </Accordion>
</AccordionGroup>

## 相關

<CardGroup cols={2}>
  <Card title="OpenRouter" href="/zh-TW/providers/openrouter" icon="shuffle">
    使用單一 API 金鑰存取 Arcee 模型及許多其他模型。
  </Card>

  <Card title="模型選擇" href="/zh-TW/concepts/model-providers" icon="layers">
    選擇提供者、模型 ref 與容錯移轉行為。
  </Card>
</CardGroup>