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

# Anthropic

# Anthropic (Claude)

Anthropic xây dựng họ mô hình **Claude** và cung cấp quyền truy cập thông qua API.
Trong OpenClaw, bạn có thể xác thực bằng API key hoặc **setup-token**.

## Tùy chọn A: Khóa API Anthropic

**Phù hợp nhất cho:** truy cập API tiêu chuẩn và thanh toán theo mức sử dụng.
Tạo API key của bạn trong Anthropic Console.

### Thiết lập CLI

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw onboard
# choose: Anthropic API key

# or non-interactive
openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"
```

### Mẫu cấu hình

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  env: { ANTHROPIC_API_KEY: "sk-ant-..." },
  agents: { defaults: { model: { primary: "anthropic/claude-opus-4-6" } } },
}
```

## Lưu đệm prompt (Anthropic API)

OpenClaw hỗ trợ tính năng lưu bộ đệm prompt của Anthropic. Đây là **chỉ-API**; xác thực bằng subscription không tôn trọng các thiết lập cache.

### Cấu hình

Dùng tham số `cacheRetention` trong cấu hình mô hình của bạn:

| Giá trị | Thời lượng lưu đệm | Mô tả                               |
| ------- | ------------------ | ----------------------------------- |
| `none`  | Không lưu đệm      | Tắt lưu đệm prompt                  |
| `short` | 5 phút             | Mặc định cho xác thực bằng khóa API |
| `long`  | 1 giờ              | Lưu đệm mở rộng (cần cờ beta)       |

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-4-6": {
          params: { cacheRetention: "long" },
        },
      },
    },
  },
}
```

### Mặc định

Khi sử dụng xác thực Anthropic API Key, OpenClaw tự động áp dụng `cacheRetention: "short"` (cache 5 phút) cho tất cả các mô hình Anthropic. Bạn có thể ghi đè điều này bằng cách đặt `cacheRetention` một cách tường minh trong cấu hình của bạn.

### Tham số cũ

Tham số cũ `cacheControlTtl` vẫn được hỗ trợ để tương thích ngược:

* `"5m"` ánh xạ sang `short`
* `"1h"` ánh xạ sang `long`

Chúng tôi khuyến nghị chuyển sang tham số mới `cacheRetention`.

OpenClaw bao gồm cờ beta `extended-cache-ttl-2025-04-11` cho các yêu cầu Anthropic API;
hãy giữ cờ này nếu bạn ghi đè header của nhà cung cấp (xem [/gateway/configuration](/gateway/configuration)).

## Tùy chọn B: Claude setup-token

**Phù hợp nhất cho:** dùng gói thuê bao Claude của bạn.

### Lấy setup-token ở đâu

Setup-token được tạo bởi **Claude Code CLI**, không phải Anthropic Console. Bạn có thể chạy điều này trên **bất kỳ máy nào**:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
claude setup-token
```

Dán token vào OpenClaw (trình hướng dẫn: **Anthropic token (dán setup-token)**), hoặc chạy lệnh trên máy chủ gateway:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw models auth setup-token --provider anthropic
```

Nếu bạn tạo token trên một máy khác, hãy dán nó:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw models auth paste-token --provider anthropic
```

### Thiết lập CLI (setup-token)

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
# Paste a setup-token during onboarding
openclaw onboard --auth-choice setup-token
```

### Mẫu cấu hình (setup-token)

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  agents: { defaults: { model: { primary: "anthropic/claude-opus-4-6" } } },
}
```

## Ghi chú

* Tạo setup-token bằng `claude setup-token` rồi dán vào, hoặc chạy `openclaw models auth setup-token` trên máy chủ gateway.
* Nếu bạn thấy “OAuth token refresh failed …” trên một Claude subscription, hãy xác thực lại bằng setup-token. Xem [/gateway/troubleshooting#oauth-token-refresh-failed-anthropic-claude-subscription](/gateway/troubleshooting#oauth-token-refresh-failed-anthropic-claude-subscription).
* Chi tiết xác thực + quy tắc tái sử dụng nằm tại [/concepts/oauth](/concepts/oauth).

## Xử lý sự cố

**Lỗi 401 / token đột nhiên không hợp lệ**

* Xác thực Claude subscription có thể hết hạn hoặc bị thu hồi. Chạy lại `claude setup-token`
  và dán nó vào **gateway host**.
* Nếu đăng nhập Claude CLI nằm trên một máy khác, dùng
  `openclaw models auth paste-token --provider anthropic` trên máy chủ gateway.

**Không tìm thấy khóa API cho nhà cung cấp "anthropic"**

* Xác thực là **theo từng agent**. Các tác nhân mới không kế thừa khóa của tác nhân chính.
* Chạy lại hướng dẫn ban đầu cho tác tử đó, hoặc dán setup-token / khóa API trên
  máy chủ gateway, rồi xác minh bằng `openclaw models status`.

**Không tìm thấy thông tin xác thực cho hồ sơ `anthropic:default`**

* Chạy `openclaw models status` để xem hồ sơ xác thực nào đang hoạt động.
* Chạy lại hướng dẫn ban đầu, hoặc dán setup-token / khóa API cho hồ sơ đó.

**Không có hồ sơ xác thực khả dụng (tất cả đang cooldown/không khả dụng)**

* Kiểm tra `openclaw models status --json` cho `auth.unusableProfiles`.
* Thêm một hồ sơ Anthropic khác hoặc chờ hết cooldown.

Xem thêm: [/gateway/troubleshooting](/gateway/troubleshooting) và [/help/faq](/help/faq).