Chuyển đến nội dung chính

Documentation Index

Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt

Use this file to discover all available pages before exploring further.

Sử dụng CometAPI làm provider model cho OpenClaw — hơn 500 model trong một API.

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

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

​
Cài đặt

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 khóa <COMETAPI_KEY> của bạn.
Bảng điều khiển CometAPI hiển thị nút Add API Key
Chi tiết API key CometAPI 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 hướng dẫn 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

​
Cấu hình

1

Lưu CometAPI key của bạn

Ghi khóa 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-<COMETAPI_KEY>-key' >> ~/.openclaw/.env
chmod 600 ~/.openclaw/.env
Nếu bạn đã inject COMETAPI_KEY thông qua shell, service manager 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.
2

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 đường dẫn Chat Completions cổ điển. Cả hai dùng chung baseUrl (https://api.cometapi.com/v1); điểm 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. Khóa provider được resolve từ models.providers.*.apiKey qua biến môi trường $\{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 khóa.

​
Xác minh

1

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
Một thiết lập thành công sẽ trông như sau:
  • openclaw models status resolve model chính thành cometapi-claude/your-claude-model-id mà không có cảnh báo thiếu xác thực 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 xác thực cho các provider CometAPI
Trạng thái model OpenClaw cho thấy các provider CometAPI đã được xác thực

​
Chuyển đổi model

1

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

​
Khắc phục sự cố

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
Việc này sẽ xóa toàn bộ cấu hình cục bộ, phiên, log, trạng thái xác thực và workspace. Sau đó làm lại các Bước 3–5.