Chuyển đến nội dung chính
Sử dụng CometAPI làm nhà cung cấp model cho OpenClaw — hơn 500 model trong một API. Hướng dẫn này trình bày quy trình bắt đầu hiện tại (2026.3.8+).

​
Điều kiện tiên quyết

  • Node.js ≥ 22 — khuyến nghị cài qua nvm
  • Một tài khoản CometAPI với API key đang hoạt động — lấy tại đây
1

Lấy CometAPI API key của bạn

Đăng nhập vào CometAPI console. Nhấp vào Add API Key và sao chép key sk-xxxxx của bạn.
Bảng điều khiển CometAPI hiển thị nút Add API Key
Chi tiết CometAPI API key với base URL
2

Cài đặt hoặc cập nhật OpenClaw

Khuyến nghị — dùng trình cài đặt chính thức:
curl -fsSL https://openclaw.ai/install.sh | bash
Hoặc cài qua npm:
npm install -g openclaw@latest
Sau đó chạy trình thiết lập một lần:
openclaw onboard --install-daemon
Trong quá trình onboarding, chọn Skip ở bước Model/Auth nếu bạn muốn cấu hình CometAPI thủ công. Sau khi onboarding xong, xác nhận gateway đang chạy:
openclaw gateway status
openclaw dashboard
3

Lưu CometAPI key của bạn

Ghi key của bạn vào ~/.openclaw/.env để daemon có thể sử dụng mà không cần hardcode trong các file cấu hình:
printf 'COMETAPI_KEY=%s\n' 'your-sk-xxxxx-key' >> ~/.openclaw/.env
chmod 600 ~/.openclaw/.env
Nếu bạn đã inject COMETAPI_KEY thông qua shell, trình quản lý dịch vụ hoặc quy trình secrets, hãy bỏ qua bước này — cấu hình bên dưới dùng $\{COMETAPI_KEY\} bất kể biến được thiết lập theo cách nào.
4

Cấu hình các provider CometAPI

CometAPI hỗ trợ bốn định dạng API. Thêm một hoặc nhiều khối provider vào ~/.openclaw/openclaw.json:
ProviderĐịnh dạng APIEndpoint được gọiBase URL
cometapi-openaiopenai-completionsPOST /v1/chat/completionshttps://api.cometapi.com/v1
cometapi-openai-responsesopenai-responsesPOST /v1/responseshttps://api.cometapi.com/v1
cometapi-claudeanthropic-messagesPOST /messageshttps://api.cometapi.com
cometapi-googlegoogle-generative-aiPOST /v1beta/...https://api.cometapi.com/v1beta
{
  "agents": {
    "defaults": {
      "model": {
        "primary": "cometapi-claude/your-claude-model-id"
      }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "cometapi-openai": {
        "baseUrl": "https://api.cometapi.com/v1",
        "apiKey": "${COMETAPI_KEY}",
        "api": "openai-completions",
        "models": [{ "id": "your-chat-model-id", "name": "OpenAI-compatible text model" }]
      },
      "cometapi-openai-responses": {
        "baseUrl": "https://api.cometapi.com/v1",
        "apiKey": "${COMETAPI_KEY}",
        "api": "openai-responses",
        "models": [{ "id": "your-responses-model-id", "name": "Responses API model" }]
      },
      "cometapi-claude": {
        "baseUrl": "https://api.cometapi.com",
        "apiKey": "${COMETAPI_KEY}",
        "api": "anthropic-messages",
        "models": [{ "id": "your-claude-model-id", "name": "Claude family model" }]
      },
      "cometapi-google": {
        "baseUrl": "https://api.cometapi.com/v1beta",
        "apiKey": "${COMETAPI_KEY}",
        "api": "google-generative-ai",
        "models": [{ "id": "your-gemini-model-id", "name": "Gemini family model" }]
      }
    }
  }
}
Bạn có thể chỉ giữ lại các provider mình cần, hoặc giữ cả bốn để định tuyến giữa các định dạng bằng tham chiếu provider/model.Thay từng placeholder your-...-model-id bằng model ID hiện tại từ trang Models của CometAPI tương ứng với khối provider.
Dùng cometapi-openai-responses (api: "openai-responses") cho các model yêu cầu OpenAI Responses API. Dùng cometapi-openai (api: "openai-completions") cho các model trên luồng Chat Completions cổ điển. Cả hai dùng chung baseUrl (https://api.cometapi.com/v1); khác biệt duy nhất là endpoint downstream mà OpenClaw gọi.
File auth-profiles.json không bắt buộc cho thiết lập này. Provider key được lấy từ models.providers.*.apiKey thông qua biến env $\{COMETAPI_KEY\}. auth-profiles.json chỉ cần nếu bạn muốn xoay vòng thông tin xác thực theo từng profile trên nhiều key.
5

Khởi động lại và xác minh

Khởi động lại gateway sau khi thêm .env hoặc thay đổi cấu hình provider:
openclaw gateway restart
Sau đó chạy chẩn đoán:
openclaw models status
openclaw models list --provider cometapi-claude
openclaw doctor
Thiết lập thành công sẽ trông như sau:
  • openclaw models status phân giải model chính thành cometapi-claude/your-claude-model-id mà không có cảnh báo thiếu auth cho các provider CometAPI
  • openclaw models list --provider cometapi-claude liệt kê các model bạn đã cấu hình
  • openclaw doctor báo không có lỗi cấu hình hoặc auth cho các provider CometAPI
OpenClaw models status hiển thị các provider CometAPI đã được xác thực
6

Chuyển đổi model

# Set the default model in config
openclaw models set cometapi-claude/your-claude-model-id

# Switch for the current chat session
/model cometapi-openai/your-chat-model-id
/model cometapi-openai-responses/your-responses-model-id
/model cometapi-claude/your-claude-model-id
/model cometapi-google/your-gemini-model-id
Nếu bạn đang sửa một thiết lập cũ bị lỗi, hãy dừng gateway, xóa ~/.openclaw, rồi chạy lại onboarding trước khi áp dụng cấu hình CometAPI:
openclaw gateway stop
rm -rf ~/.openclaw
openclaw onboard --install-daemon
Thao tác này sẽ xóa toàn bộ cấu hình cục bộ, phiên làm việc, log, trạng thái auth và workspaces. Sau đó làm lại Bước 3–5.