Source: https://ailoot.ai/docs/vi/integrations/openclaw/
Canonical: https://ailoot.ai/docs/vi/integrations/openclaw/
Language: vi

[Tác nhân trong terminal](https://ailoot.ai/docs/vi/integrations/#agents) 

# OpenClaw

[Markdown](https://ailoot.ai/docs/vi/integrations/openclaw/index.md)

Tác nhân dòng lệnh · OpenAI Chat, OpenAI Responses, Anthropic Messages, Gemini

| Định dạng | Nơi cấu hình |
| --- | --- |
| OpenAI Chat, OpenAI Responses, Anthropic Messages, Gemini | Cấu hình OpenClaw (~/.openclaw/openclaw.json) → models.providers.\<id\>; mô hình mặc định — agents.defaults.model.primary; chỉnh sửa an toàn — openclaw config set models.providers.\<id\> '\<json\>' --strict-json --merge |

## [](https://ailoot.ai/docs/vi/integrations/openclaw/#setup)Cấu hình

Sao chép cấu hình và thay `sk-...` bằng khóa của bạn từ trang quản lý tài khoản Ailoot. Nên lưu khóa trong biến môi trường `AILOOT_API_KEY`, nếu ứng dụng hỗ trợ.

Trước khi chạy, gọi GET /v1/models bằng khóa Ailoot của bạn. Chọn ID mô hình chính xác có các phương thức POST /v1/chat/completions, POST /v1/responses, POST /v1/messages, POST /v1beta/models/{model}:generateContent rồi dùng ID đó trong cấu hình. Với tác tử, hãy kiểm tra cả công cụ và tính năng mà phiên bản ứng dụng của bạn cần.

```json
{
  "agents": {
    "defaults": {
      "model": {
        "primary": "ailoot/claude-sonnet-5-5"
      }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "ailoot": {
        "baseUrl": "https://api.ailoot.ai/v1",
        "apiKey": "${AILOOT_API_KEY}",
        "api": "openai-completions",
        "models": [
          {
            "id": "claude-sonnet-5-5",
            "name": "Claude Sonnet 5.5",
            "reasoning": true,
            "input": [
              "text"
            ],
            "contextWindow": 1000000,
            "maxTokens": 128000
          },
          {
            "id": "deepseek-v4-pro",
            "name": "DeepSeek V4 Pro",
            "reasoning": true,
            "input": [
              "text"
            ],
            "contextWindow": 1000000,
            "maxTokens": 131072
          }
        ]
      },
      "ailoot-claude": {
        "baseUrl": "https://api.ailoot.ai",
        "apiKey": "${AILOOT_API_KEY}",
        "api": "anthropic-messages",
        "models": [
          {
            "id": "claude-opus-5-5",
            "name": "Claude Opus 5.5",
            "reasoning": true,
            "input": [
              "text"
            ],
            "contextWindow": 1000000,
            "maxTokens": 131072
          }
        ]
      }
    }
  }
}
```

Cấu hình này đọc khóa từ biến `AILOOT_API_KEY`. Hãy đặt biến trước khi khởi động ứng dụng:

```bash
export AILOOT_API_KEY="sk-..."   # thêm vào ~/.zshrc hoặc ~/.bashrc
```

```powershell
setx AILOOT_API_KEY "sk-..."   # sau đó khởi động lại terminal
```

Mô hình ví dụ: `claude-sonnet-5-5`. Chọn bất kỳ mô hình khác từ [danh mục](https://ailoot.ai/models/vi/) — kiểm tra xem mô hình đó có định dạng cần thiết hay không.

## [](https://ailoot.ai/docs/vi/integrations/openclaw/#notes)Điều cần biết

Các bộ chuyển đổi api: openai-completions (mặc định khi đặt baseUrl), openai-responses (chỉ khi máy chủ hỗ trợ /v1/responses — Ailoot có hỗ trợ), anthropic-messages, google-generative-ai và các loại khác. Với anthropic-messages, các ví dụ OpenClaw đặt baseUrl không có /v1. OpenClaw có thể truyền hình ảnh khi input của mô hình chứa "image". Các ví dụ Claude chỉ giữ văn bản: trong bản chụp danh mục ngày 2026-09-30, những phương thức này không khai báo đầu vào image. Chỉ thêm "image" cho mô hình cụ thể có thẻ trong danh mục hiện tại khai báo đầu vào hình ảnh và định dạng API đã chọn. Ví dụ, gemini-3.6-flash trong bản chụp này khai báo đầu vào image cho OpenAI Chat; hỗ trợ thực tế phụ thuộc vào thẻ mô hình và định dạng. Đường dẫn tệp cấu hình chính được lấy từ thông lệ OpenClaw; trang đã đọc cũng nhắc đến ~/.openclaw/agents/\<agentId\>/agent/models.json.

## [](https://ailoot.ai/docs/vi/integrations/openclaw/#check)Kiểm tra

- Với định dạng OpenAI, địa chỉ là `https://api.ailoot.ai/v1` (hoặc đường dẫn đầy đủ nếu ứng dụng yêu cầu địa chỉ đầy đủ).
- Với định dạng Anthropic, địa chỉ là `https://api.ailoot.ai` không có `/v1`.
- Với định dạng Gemini, địa chỉ là `https://api.ailoot.ai` — địa chỉ gốc API. Ví dụ bên trên không trình bày đầy đủ cách cấu hình định dạng này; kiểm tra đường dẫn cần nhập vào trường của máy khách trong tài liệu của máy khách. Tiền tố tuyến API là `/v1beta`.
- Đặt một câu hỏi ngắn. Nếu nhận được lỗi, hãy xem mã lỗi và Request ID rồi đối chiếu với trang [Lỗi và giới hạn](https://ailoot.ai/docs/vi/errors/).
- Lỗi 404 ngay sau khi cấu hình hầu như luôn là do địa chỉ sai: thừa hoặc thiếu `/v1`.
- 402 — số dư không đủ cho khoản giữ trước. Tác nhân giữ trước nhiều tiền hơn ứng dụng trò chuyện: [lý do](https://ailoot.ai/docs/vi/billing/reserve/).

Tài liệu của ứng dụng: [https://docs.openclaw.ai/gateway/config-tools/custom-providers](https://docs.openclaw.ai/gateway/config-tools/custom-providers)

Còn câu hỏi? Hãy gửi Request ID và mô tả — chúng tôi sẽ giúp tìm hiểu.[Liên hệ hỗ trợ](mailto:support@ailoot.ai)

## Ailoot · Công ty và danh mục dự án của công ty





Ailoot dựa trên kinh nghiệm vận hành tích lũy, cơ sở khách hàng lớn, dịch vụ ổn định và việc kiểm soát KPI liên tục.





Công ty và danh mục dự án của công ty: hàng triệu khách hàng; doanh số hàng tỷ mỗi tháng.





Ailoot áp dụng kinh nghiệm vận hành này để cung cấp quyền truy cập API vào các tính năng AI trong sản phẩm của khách hàng, tác tử, ứng dụng và quy trình tự động hóa.