> ## 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.

# Cohere

[Cohere](https://cohere.com) 透過其相容性 API 提供與 OpenAI 相容的推論。OpenClaw 在 Cohere 提供者外部化的過渡期間將其內建，並同時將其發布為官方外部外掛。

| 屬性      | 值                                        |
| ------- | ---------------------------------------- |
| 提供者 ID  | `cohere`                                 |
| 外掛      | 過渡期間內建；官方外部套件                            |
| 驗證環境變數  | `COHERE_API_KEY`                         |
| 初始設定旗標  | `--auth-choice cohere-api-key`           |
| 直接命令列旗標 | `--cohere-api-key <key>`                 |
| API     | 與 OpenAI 相容（`openai-completions`）        |
| 基礎 URL  | `https://api.cohere.ai/compatibility/v1` |
| 預設模型    | `cohere/command-a-plus-05-2026`          |
| 上下文視窗   | 128,000 個權杖                              |

## 內建目錄

| 模型參照                                 | 輸入    | 上下文     | 最大輸出   | 備註               |
| ------------------------------------ | ----- | ------- | ------ | ---------------- |
| `cohere/command-a-plus-05-2026`      | 文字、圖片 | 128,000 | 64,000 | 預設；旗艦代理式推理模型     |
| `cohere/command-a-03-2025`           | 文字    | 256,000 | 8,000  | 前一代 Command A 模型 |
| `cohere/command-a-reasoning-08-2025` | 文字    | 256,000 | 32,000 | 代理式推理與工具使用       |
| `cohere/command-a-vision-07-2025`    | 文字、圖片 | 128,000 | 8,000  | 視覺與文件分析；不支援工具使用  |
| `cohere/north-mini-code-1-0`         | 文字、圖片 | 256,000 | 64,000 | 代理式程式設計；推理；免費額度  |

具備推理能力的 Cohere 模型支援兩種相容性 API 推理模式。OpenClaw 將**關閉**對應至 `none`，並將每個已啟用的思考層級對應至 `high`。Command A Vision 不支援工具使用，因此 OpenClaw 會為該模型停用代理工具。

## 開始使用

1. 目前的 OpenClaw 套件已隨附 Cohere。若缺少 Cohere，請安裝外部套件並重新啟動閘道：

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

2. 建立 Cohere API 金鑰。
3. 執行初始設定：

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw onboard --non-interactive \
  --auth-choice cohere-api-key \
  --cohere-api-key "$COHERE_API_KEY"
```

4. 確認目錄可用：

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw models list --provider cohere
```

只有在尚未設定主要模型時，初始設定才會將 Cohere 設為主要模型。

## 僅使用環境變數設定

讓閘道程序可存取 `COHERE_API_KEY`，然後選取 Cohere 模型：

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  agents: {
    defaults: {
      model: { primary: "cohere/command-a-plus-05-2026" },
    },
  },
}
```

<Note>
  若閘道以常駐程式或在 Docker 中執行，請為該服務設定 `COHERE_API_KEY`。僅在互動式 Shell 中匯出此變數，無法讓已在執行中的閘道存取它。
</Note>

## 相關內容

* [模型提供者](/zh-TW/concepts/model-providers)
* [模型命令列介面](/zh-TW/cli/models)
* [提供者目錄](/zh-TW/providers/index)