Sử dụng OpenClaw với CometAPI

Sử dụng CometAPI làm nhà cung cấp 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

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

Đăng nhập vào bảng điều khiển CometAPI. Nhấp vào Add API Key và sao chép CometAPI API key của bạn.

Bảng điều khiển CometAPI hiển thị nút Add API Key

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

Khuyến nghị — sử dụng trình cài đặt chính thức:

curl -fsSL https://openclaw.ai/install.sh | bash

Hoặc cài đặt 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 onboard, hãy chọn Skip ở bước Model/Auth nếu bạn muốn cấu hình CometAPI thủ công. Sau khi onboard xong, xác nhận gateway đang chạy:

openclaw gateway status
openclaw dashboard

Cấu hình

Lưu khóa CometAPI 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 tệp cấu hình:

printf 'COMETAPI_KEY=%s\n' "$COMETAPI_KEY" >> ~/.openclaw/.env
chmod 600 ~/.openclaw/.env

Nếu bạn đã đưa COMETAPI_KEY vào 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 sử dụng $\{COMETAPI_KEY\} bất kể biến được thiết lập theo cách nào.

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	API Format	Endpoint called	Base URL
`cometapi-openai`	`openai-completions`	`POST /v1/chat/completions`	`https://api.cometapi.com/v1`
`cometapi-openai-responses`	`openai-responses`	`POST /v1/responses`	`https://api.cometapi.com/v1`
`cometapi-claude`	`anthropic-messages`	`POST /messages`	`https://api.cometapi.com`
`cometapi-google`	`google-generative-ai`	`POST /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 CometAPI Models tương ứng với khối provider.

Sử dụng cometapi-openai-responses (api: "openai-responses") cho các model yêu cầu OpenAI Responses API. Sử dụng cometapi-openai (api: "openai-completions") cho các model trên đường dẫn Chat Completions cổ điển. Cả hai đều 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.

Tệp auth-profiles.json không bắt buộc cho thiết lập này. Khóa provider được phân giải từ models.providers.*.apiKey thông qua biến môi trường $\{COMETAPI_KEY\}. auth-profiles.json chỉ cần thiết 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

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ẽ có dạng:

openclaw models status phân giải model chính thành cometapi-claude/your-claude-model-id và 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 cá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 models của OpenClaw hiển thị các provider CometAPI đã được xác thực

Chuyển 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ố

Cài đặt lại sạch (tùy chọn)

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, sau đó chạy lại quy trình thiết lập ban đầu 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, nhật ký, trạng thái xác thực và workspace. Sau đó hãy làm lại các Bước 3–5.

Tổng quan

Tác nhân lập trình AI

Tác nhân AI

Ứng dụng chat AI

Dịch thuật và ngôn ngữ

Nền tảng tự động hóa

Quan sát và đánh giá

Framework AI

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

Cài đặt

Cấu hình

Xác minh

Chuyển model

Khắc phục sự cố

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

​Cài đặt

​Cấu hình

​Xác minh

​Chuyển model

​Khắc phục sự cố

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

Cài đặt

Cấu hình

Xác minh

Chuyển model

Khắc phục sự cố