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

# Hướng Dẫn Cấu Hình Venice AI Trong OpenClaw

# Venice AI (Điểm nổi bật của Venice)

**Venice** là thiết lập nổi bật của chúng tôi cho suy luận ưu tiên quyền riêng tư với quyền truy cập ẩn danh tùy chọn vào các mô hình độc quyền.

Venice AI cung cấp suy luận AI tập trung vào quyền riêng tư với hỗ trợ cho các mô hình không bị kiểm duyệt và truy cập vào các mô hình độc quyền lớn thông qua proxy ẩn danh của họ. Tất cả suy luận đều riêng tư theo mặc định — không đào tạo trên dữ liệu của bạn, không ghi nhật ký.

## Tại sao chọn Venice trong OpenClaw

* **Suy luận riêng tư** cho các mô hình mã nguồn mở (không ghi nhật ký).
* **Mô hình không bị kiểm duyệt** khi bạn cần.
* **Truy cập ẩn danh** vào các mô hình độc quyền (Opus/GPT/Gemini) khi chất lượng quan trọng.
* Các endpoint tương thích với OpenAI `/v1`.

## Chế độ quyền riêng tư

Venice cung cấp hai mức độ quyền riêng tư — hiểu rõ điều này là chìa khóa để chọn mô hình của bạn:

| Chế độ       | Mô tả                                                                                                                              | Mô hình                                                       |
| ------------ | ---------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------- |
| **Riêng tư** | Hoàn toàn riêng tư. Các yêu cầu/phản hồi **không bao giờ được lưu trữ hoặc ghi lại**. Tạm thời.                                    | Llama, Qwen, DeepSeek, Kimi, MiniMax, Venice Uncensored, v.v. |
| **Ẩn danh**  | Được proxy thông qua Venice với metadata bị loại bỏ. Nhà cung cấp cơ sở (OpenAI, Anthropic, Google, xAI) thấy các yêu cầu ẩn danh. | Claude, GPT, Gemini, Grok                                     |

## Tính năng

* **Tập trung vào quyền riêng tư**: Chọn giữa chế độ "riêng tư" (hoàn toàn riêng tư) và "ẩn danh" (proxy)
* **Mô hình không bị kiểm duyệt**: Truy cập vào các mô hình không có hạn chế nội dung
* **Truy cập mô hình lớn**: Sử dụng Claude, GPT, Gemini và Grok thông qua proxy ẩn danh của Venice
* **API tương thích OpenAI**: Endpoint chuẩn `/v1` để dễ dàng tích hợp
* **Streaming**: ✅ Hỗ trợ trên tất cả các mô hình
* **Gọi hàm**: ✅ Hỗ trợ trên một số mô hình (kiểm tra khả năng của mô hình)
* **Vision**: ✅ Hỗ trợ trên các mô hình có khả năng vision
* **Không giới hạn tốc độ cứng**: Có thể áp dụng giới hạn sử dụng công bằng cho việc sử dụng quá mức

## Cài đặt

### 1. Lấy API Key

1. Đăng ký tại [venice.ai](https://venice.ai)
2. Đi tới **Settings → API Keys → Create new key**
3. Sao chép API key của bạn (định dạng: `vapi_xxxxxxxxxxxx`)

### 2. Cấu hình OpenClaw

**Lựa chọn A: Biến môi trường**

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
export VENICE_API_KEY="vapi_xxxxxxxxxxxx"
```

**Lựa chọn B: Cài đặt tương tác (Khuyến nghị)**

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw onboard --auth-choice venice-api-key
```

Điều này sẽ:

1. Yêu cầu nhập API key của bạn (hoặc sử dụng `VENICE_API_KEY` hiện có)
2. Hiển thị tất cả các mô hình Venice có sẵn
3. Cho phép bạn chọn mô hình mặc định của mình
4. Tự động cấu hình nhà cung cấp

**Lựa chọn C: Không tương tác**

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

### 3. Xác minh cài đặt

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw agent --model venice/kimi-k2-5 --message "Hello, are you working?"
```

## Lựa chọn mô hình

Sau khi cài đặt, OpenClaw hiển thị tất cả các mô hình Venice có sẵn. Chọn dựa trên nhu cầu của bạn:

* **Mô hình mặc định**: `venice/kimi-k2-5` cho suy luận riêng tư mạnh mẽ cộng với vision.
* **Tùy chọn khả năng cao**: `venice/claude-opus-4-6` cho đường dẫn Venice ẩn danh mạnh nhất.
* **Quyền riêng tư**: Chọn mô hình "riêng tư" cho suy luận hoàn toàn riêng tư.
* **Khả năng**: Chọn mô hình "ẩn danh" để truy cập Claude, GPT, Gemini qua proxy của Venice.

Thay đổi mô hình mặc định của bạn bất cứ lúc nào:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw models set venice/kimi-k2-5
openclaw models set venice/claude-opus-4-6
```

Liệt kê tất cả các mô hình có sẵn:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw models list | grep venice
```

## Cấu hình qua `openclaw configure`

1. Chạy `openclaw configure`
2. Chọn **Model/auth**
3. Chọn **Venice AI**

## Nên sử dụng mô hình nào?

| Trường hợp sử dụng               | Mô hình khuyến nghị              | Lý do                                               |
| -------------------------------- | -------------------------------- | --------------------------------------------------- |
| **Trò chuyện chung (mặc định)**  | `kimi-k2-5`                      | Suy luận riêng tư mạnh mẽ cộng với vision           |
| **Chất lượng tổng thể tốt nhất** | `claude-opus-4-6`                | Tùy chọn Venice ẩn danh mạnh nhất                   |
| **Quyền riêng tư + mã hóa**      | `qwen3-coder-480b-a35b-instruct` | Mô hình mã hóa riêng tư với ngữ cảnh lớn            |
| **Vision riêng tư**              | `kimi-k2-5`                      | Hỗ trợ vision mà không rời khỏi chế độ riêng tư     |
| **Nhanh + rẻ**                   | `qwen3-4b`                       | Mô hình suy luận nhẹ                                |
| **Nhiệm vụ phức tạp riêng tư**   | `deepseek-v3.2`                  | Suy luận mạnh mẽ, nhưng không hỗ trợ công cụ Venice |
| **Không bị kiểm duyệt**          | `venice-uncensored`              | Không có hạn chế nội dung                           |

## Các mô hình có sẵn (Tổng cộng 41)

### Mô hình riêng tư (26) - Hoàn toàn riêng tư, không ghi nhật ký

| ID Mô hình                             | Tên                                 | Ngữ cảnh | Tính năng                                   |
| -------------------------------------- | ----------------------------------- | -------- | ------------------------------------------- |
| `kimi-k2-5`                            | Kimi K2.5                           | 256k     | Mặc định, suy luận, vision                  |
| `kimi-k2-thinking`                     | Kimi K2 Thinking                    | 256k     | Suy luận                                    |
| `llama-3.3-70b`                        | Llama 3.3 70B                       | 128k     | Chung                                       |
| `llama-3.2-3b`                         | Llama 3.2 3B                        | 128k     | Chung                                       |
| `hermes-3-llama-3.1-405b`              | Hermes 3 Llama 3.1 405B             | 128k     | Chung, công cụ bị vô hiệu hóa               |
| `qwen3-235b-a22b-thinking-2507`        | Qwen3 235B Thinking                 | 128k     | Suy luận                                    |
| `qwen3-235b-a22b-instruct-2507`        | Qwen3 235B Instruct                 | 128k     | Chung                                       |
| `qwen3-coder-480b-a35b-instruct`       | Qwen3 Coder 480B                    | 256k     | Mã hóa                                      |
| `qwen3-coder-480b-a35b-instruct-turbo` | Qwen3 Coder 480B Turbo              | 256k     | Mã hóa                                      |
| `qwen3-5-35b-a3b`                      | Qwen3.5 35B A3B                     | 256k     | Suy luận, vision                            |
| `qwen3-next-80b`                       | Qwen3 Next 80B                      | 256k     | Chung                                       |
| `qwen3-vl-235b-a22b`                   | Qwen3 VL 235B (Vision)              | 256k     | Vision                                      |
| `qwen3-4b`                             | Venice Small (Qwen3 4B)             | 32k      | Nhanh, suy luận                             |
| `deepseek-v3.2`                        | DeepSeek V3.2                       | 160k     | Suy luận, công cụ bị vô hiệu hóa            |
| `venice-uncensored`                    | Venice Uncensored (Dolphin-Mistral) | 32k      | Không bị kiểm duyệt, công cụ bị vô hiệu hóa |
| `mistral-31-24b`                       | Venice Medium (Mistral)             | 128k     | Vision                                      |
| `google-gemma-3-27b-it`                | Google Gemma 3 27B Instruct         | 198k     | Vision                                      |
| `openai-gpt-oss-120b`                  | OpenAI GPT OSS 120B                 | 128k     | Chung                                       |
| `nvidia-nemotron-3-nano-30b-a3b`       | NVIDIA Nemotron 3 Nano 30B          | 128k     | Chung                                       |
| `olafangensan-glm-4.7-flash-heretic`   | GLM 4.7 Flash Heretic               | 128k     | Suy luận                                    |
| `zai-org-glm-4.6`                      | GLM 4.6                             | 198k     | Chung                                       |
| `zai-org-glm-4.7`                      | GLM 4.7                             | 198k     | Suy luận                                    |
| `zai-org-glm-4.7-flash`                | GLM 4.7 Flash                       | 128k     | Suy luận                                    |
| `zai-org-glm-5`                        | GLM 5                               | 198k     | Suy luận                                    |
| `minimax-m21`                          | MiniMax M2.1                        | 198k     | Suy luận                                    |
| `minimax-m25`                          | MiniMax M2.5                        | 198k     | Suy luận                                    |

### Mô hình ẩn danh (15) - Qua Proxy Venice

| ID Mô hình                      | Tên                            | Ngữ cảnh | Tính năng                |
| ------------------------------- | ------------------------------ | -------- | ------------------------ |
| `claude-opus-4-6`               | Claude Opus 4.6 (qua Venice)   | 1M       | Suy luận, vision         |
| `claude-opus-4-5`               | Claude Opus 4.5 (qua Venice)   | 198k     | Suy luận, vision         |
| `claude-sonnet-4-6`             | Claude Sonnet 4.6 (qua Venice) | 1M       | Suy luận, vision         |
| `claude-sonnet-4-5`             | Claude Sonnet 4.5 (qua Venice) | 198k     | Suy luận, vision         |
| `openai-gpt-54`                 | GPT-5.4 (qua Venice)           | 1M       | Suy luận, vision         |
| `openai-gpt-53-codex`           | GPT-5.3 Codex (qua Venice)     | 400k     | Suy luận, vision, mã hóa |
| `openai-gpt-52`                 | GPT-5.2 (qua Venice)           | 256k     | Suy luận                 |
| `openai-gpt-52-codex`           | GPT-5.2 Codex (qua Venice)     | 256k     | Suy luận, vision, mã hóa |
| `openai-gpt-4o-2024-11-20`      | GPT-4o (qua Venice)            | 128k     | Vision                   |
| `openai-gpt-4o-mini-2024-07-18` | GPT-4o Mini (qua Venice)       | 128k     | Vision                   |
| `gemini-3-1-pro-preview`        | Gemini 3.1 Pro (qua Venice)    | 1M       | Suy luận, vision         |
| `gemini-3-pro-preview`          | Gemini 3 Pro (qua Venice)      | 198k     | Suy luận, vision         |
| `gemini-3-flash-preview`        | Gemini 3 Flash (qua Venice)    | 256k     | Suy luận, vision         |
| `grok-41-fast`                  | Grok 4.1 Fast (qua Venice)     | 1M       | Suy luận, vision         |
| `grok-code-fast-1`              | Grok Code Fast 1 (qua Venice)  | 256k     | Suy luận, mã hóa         |

## Khám phá mô hình

OpenClaw tự động phát hiện các mô hình từ API Venice khi `VENICE_API_KEY` được thiết lập. Nếu API không thể truy cập, nó sẽ sử dụng danh mục tĩnh.

Endpoint `/models` là công khai (không cần xác thực để liệt kê), nhưng suy luận yêu cầu một API key hợp lệ.

## Hỗ trợ Streaming & Công cụ

| Tính năng           | Hỗ trợ                                                               |
| ------------------- | -------------------------------------------------------------------- |
| **Streaming**       | ✅ Tất cả các mô hình                                                 |
| **Gọi hàm**         | ✅ Hầu hết các mô hình (kiểm tra `supportsFunctionCalling` trong API) |
| **Vision/Hình ảnh** | ✅ Các mô hình được đánh dấu với tính năng "Vision"                   |
| **Chế độ JSON**     | ✅ Hỗ trợ qua `response_format`                                       |

## Giá cả

Venice sử dụng hệ thống dựa trên tín dụng. Kiểm tra [venice.ai/pricing](https://venice.ai/pricing) để biết giá hiện tại:

* **Mô hình riêng tư**: Thường có chi phí thấp hơn
* **Mô hình ẩn danh**: Tương tự giá API trực tiếp + phí nhỏ của Venice

## So sánh: Venice vs API trực tiếp

| Khía cạnh          | Venice (Ẩn danh)                  | API trực tiếp                   |
| ------------------ | --------------------------------- | ------------------------------- |
| **Quyền riêng tư** | Metadata bị loại bỏ, ẩn danh      | Tài khoản của bạn được liên kết |
| **Độ trễ**         | +10-50ms (proxy)                  | Trực tiếp                       |
| **Tính năng**      | Hầu hết các tính năng được hỗ trợ | Đầy đủ tính năng                |
| **Thanh toán**     | Tín dụng Venice                   | Thanh toán nhà cung cấp         |

## Ví dụ sử dụng

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
# Sử dụng mô hình riêng tư mặc định
openclaw agent --model venice/kimi-k2-5 --message "Quick health check"

# Sử dụng Claude Opus qua Venice (ẩn danh)
openclaw agent --model venice/claude-opus-4-6 --message "Summarize this task"

# Sử dụng mô hình không bị kiểm duyệt
openclaw agent --model venice/venice-uncensored --message "Draft options"

# Sử dụng mô hình vision với hình ảnh
openclaw agent --model venice/qwen3-vl-235b-a22b --message "Review attached image"

# Sử dụng mô hình mã hóa
openclaw agent --model venice/qwen3-coder-480b-a35b-instruct --message "Refactor this function"
```

## Khắc phục sự cố

### API key không được nhận diện

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
echo $VENICE_API_KEY
openclaw models list | grep venice
```

Đảm bảo key bắt đầu với `vapi_`.

### Mô hình không có sẵn

Danh mục mô hình Venice cập nhật động. Chạy `openclaw models list` để xem các mô hình hiện có. Một số mô hình có thể tạm thời không hoạt động.

### Vấn đề kết nối

API Venice nằm tại `https://api.venice.ai/api/v1`. Đảm bảo mạng của bạn cho phép kết nối HTTPS.

## Ví dụ file cấu hình

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  env: { VENICE_API_KEY: "vapi_..." },
  agents: { defaults: { model: { primary: "venice/kimi-k2-5" } } },
  models: {
    mode: "merge",
    providers: {
      venice: {
        baseUrl: "https://api.venice.ai/api/v1",
        apiKey: "${VENICE_API_KEY}",
        api: "openai-completions",
        models: [
          {
            id: "kimi-k2-5",
            name: "Kimi K2.5",
            reasoning: true,
            input: ["text", "image"],
            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
            contextWindow: 256000,
            maxTokens: 65536,
          },
        ],
      },
    },
  },
}
```

## Liên kết

* [Venice AI](https://venice.ai)
* [Tài liệu API](https://docs.venice.ai)
* [Giá cả](https://venice.ai/pricing)
* [Trạng thái](https://status.venice.ai)