CometAPI × OpenClaw

Cấu hình
OpenClaw
via CometAPI

Sử dụng CometAPI làm nhà cung cấp mô hình tùy chỉnh cho OpenClaw: một API, 500+ mô hình, giảm giá tới 20%. Hướng dẫn này phù hợp với quy trình onboarding OpenClaw hiện tại (2026.3.8+) và bao gồm cài đặt, cấu hình nhà cung cấp, xác minh và chuyển đổi mô hình.

~/.openclaw/openclaw.json
# Chỉ là ví dụ—xác minh với phiên bản OpenClaw của bạn trước khi đưa vào production
{
  "agents": {
    "defaults": {
      "model": {
        "primary": "cometapi-claude/claude-sonnet-4-6"
      }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "cometapi-openai": {
        "baseUrl": "https://api.cometapi.com/v1",
        "apiKey": "${COMETAPI_KEY}",
        "api": "openai-completions",
        "models": [{ "id": "gpt-5.4", "name": "GPT-5.4" }]
      },
      "cometapi-claude": {
        "baseUrl": "https://api.cometapi.com",
        "apiKey": "${COMETAPI_KEY}",
        "api": "anthropic-messages",
        "models": [{ "id": "claude-sonnet-4-6", "name": "Claude Sonnet 4.6" }]
      },
      "cometapi-google": {
        "baseUrl": "https://api.cometapi.com/v1beta",
        "apiKey": "${COMETAPI_KEY}",
        "api": "google-generative-ai",
        "models": [{ "id": "gemini-3.1-pro-preview", "name": "Gemini 3.1 Pro" }]
      }
    }
  }
}
00 — Bắt đầu tại đây

Phạm vi hướng dẫn
và điều kiện tiên quyết

Tổng quan hướng dẫn

Cấu hình OpenClaw với CometAPI

Sử dụng CometAPI làm nhà cung cấp mô hình tùy chỉnh cho OpenClaw để truy cập 500+ mô hình qua một API, giảm giá tới 20% trên các tuyến được hỗ trợ. Trang này theo dõi quy trình onboarding OpenClaw hiện tại (2026.3.8+).

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

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

Cần có Node.js >= 22 và API key CometAPI. Với cài đặt daemon, lưu COMETAPI_KEY vào ~/.openclaw/.env để openclaw.json có thể tham chiếu ${COMETAPI_KEY} mà không cần hardcode secrets.

Lệnh nhanh
openclaw onboard --install-daemon
openclaw gateway status
openclaw dashboard

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

Sau khi thêm ~/.openclaw/.env hoặc chỉnh sửa cấu hình nhà cung cấp, khởi động lại một lần với openclaw gateway restart, sau đó chạy chẩn đoán. Sử dụng tham chiếu provider/model đầy đủ trong tất cả các lệnh và phiên. Khi có sự lệch phiên bản, kiểm tra lại Tài liệu cấu hình.

01 — Ghi chú thiết lập nhà cung cấp

Tại sao cần ba nhà cung cấp
cho một API key CometAPI

Định tuyến nhà cung cấp dựa trên hình dạng API
OpenClaw định tuyến theo tính tương thích API (không chỉ nhãn nhà cung cấp), vì vậy hãy sử dụng các nhà cung cấp riêng biệt cho openai-completions, anthropic-messages và google-generative-ai.
Một key, cấu hình nhiều nhà cung cấp
Giữ một COMETAPI_KEY duy nhất và tái sử dụng trong các khối cometapi-openai, cometapi-claude và cometapi-google. Sử dụng tham chiếu provider/model rõ ràng ở mọi nơi.
Xác minh quy trình hiện tại
Chạy onboarding một lần, khởi động lại gateway sau khi thay đổi, sau đó xác nhận với models status, models list theo phạm vi nhà cung cấp và chẩn đoán doctor.
02 — Kết nối vào OpenClaw

Cài đặt, onboard, cấu hình,
xác minh, chuyển đổi

Ghi chú theo phiên bản

OpenClaw sử dụng ~/.openclaw/openclaw.json là cấu hình nguồn bạn chỉnh sửa. Các nhà cung cấp tùy chỉnh được hiện thực hóa thành các tệp models.json theo từng agent dưới ~/.openclaw/agents/<agentId>/. Kiểm tra lại keys và hành vi sau khi nâng cấp bằng các hướng dẫn Tài liệu cấu hình Biến môi trường . Coi URL cơ sở CometAPI chỉ như được định nghĩa trong tài liệu trực tiếp.

01 Cài đặt hoặc cập nhật OpenClaw
Khuyến nghị: curl -fsSL https://openclaw.ai/install.sh | bash. Hoặc npm install -g openclaw@latest nếu bạn duy trì cài đặt npm toàn cục.
02 Chạy onboarding một lần
Chạy: openclaw onboard --install-daemon. Trong Model/Auth chọn Skip để cài đặt cơ bản, giữ workspace mặc định trừ khi cần, để wizard hoàn thành daemon và health check.
03 Lưu trữ COMETAPI_KEY
Với cài đặt daemon, thêm COMETAPI_KEY vào ~/.openclaw/.env và chạy chmod 600. Tiếp tục sử dụng quy trình secrets shell/dịch vụ nếu bạn đã có.
04 Thêm nhà cung cấp CometAPI vào openclaw.json
Thêm cometapi-openai (openai-completions), cometapi-claude (anthropic-messages) và cometapi-google (google-generative-ai), sau đó đặt primary thành cometapi-claude/claude-sonnet-4-6.
05 Khởi động lại và xác minh
Chạy openclaw gateway restart, sau đó openclaw models status, openclaw models list --provider cometapi-claude và openclaw doctor. Không có lỗi schema cấu hình/xác thực cho nhà cung cấp CometAPI.
06 Chuyển đổi mô hình với provider/model
Đặt mặc định với openclaw models set cometapi-claude/claude-sonnet-4-6. Trong chat, chuyển qua /model cometapi-openai/gpt-5.4 hoặc /model cometapi-google/gemini-3.1-pro-preview.
07 Cài đặt lại sạch tùy chọn
Khi sửa chữa cài đặt cũ bị hỏng: dừng gateway, xóa ~/.openclaw, chạy lại onboarding, sau đó áp dụng lại cấu hình CometAPI. Điều này đặt lại cấu hình cục bộ, phiên, nhật ký và trạng thái xác thực.
Đoạn cấu hình (hợp nhất vào openclaw.json)
{
  "agents": {
    "defaults": {
      "model": {
        "primary": "cometapi-claude/claude-sonnet-4-6"
      }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "cometapi-openai": {
        "baseUrl": "https://api.cometapi.com/v1",
        "apiKey": "${COMETAPI_KEY}",
        "api": "openai-completions",
        "models": [{ "id": "gpt-5.4", "name": "GPT-5.4" }]
      },
      "cometapi-claude": {
        "baseUrl": "https://api.cometapi.com",
        "apiKey": "${COMETAPI_KEY}",
        "api": "anthropic-messages",
        "models": [{ "id": "claude-sonnet-4-6", "name": "Claude Sonnet 4.6" }]
      },
      "cometapi-google": {
        "baseUrl": "https://api.cometapi.com/v1beta",
        "apiKey": "${COMETAPI_KEY}",
        "api": "google-generative-ai",
        "models": [{ "id": "gemini-3.1-pro-preview", "name": "Gemini 3.1 Pro" }]
      }
    }
  }
}

Thiết lập cơ bản không yêu cầu tạo thủ công auth-profiles.json. Sử dụng ${COMETAPI_KEY} trong nhà cung cấp và chèn biến qua ~/.openclaw/.env, shell hoặc trình quản lý dịch vụ.

03 — Giá tham khảo

Giá trực tiếp trên
trang CometAPI

Bảng dưới sử dụng giá minh họa theo triệu token. Danh mục mô hình, giảm giá và SLA tương ứng với những gì Tài liệu và bảng điều khiển CometAPI hiển thị ngay bây giờ.

Mô hình (mẫu)Đầu vào / 1M tokenĐầu ra / 1M tokenGhi chú
Claude Opus 4.6$4.00$20.00Từ dữ liệu tham khảo
MiniMax-M2.7$0.24$0.96Từ dữ liệu tham khảo
GLM 5 Turbo$0.96$3.26Từ dữ liệu tham khảo
GPT-5.4 pro$24.00$144Từ dữ liệu tham khảo
Gemini 3.1 Pro$1.60$9.60Từ dữ liệu tham khảo
qwen3.5-plus$0.32$1.92Từ dữ liệu tham khảo
Minh họa chi phí sử dụng
Ước tính từ giá theo triệu token so với tham chiếu minh họa "kênh chính thức"—chỉ để hiểu, không phải bảo đảm giá. Luôn theo dõi giá trực tiếp trên trang CometAPI.
Giá đồng bộ với tài liệu
Giá đầu vào
$4.00 / 1M
Giá đầu ra
$20.00 / 1M
Đọc tự động từ cấu hình mô hình đã chọn
CometAPI (1M đầu vào + 1M đầu ra)
$24.00
Tham chiếu chính thức (cùng mức sử dụng)
$30.00
Tiết kiệm minh họa
$6.00
~20% thấp hơn tham chiếu (minh họa)
04 — Câu hỏi thường gặp

Kiểm tra điều này
trước khi tích hợp

Tôi có cần auth-profiles.json cho thiết lập này không?

Không cho thiết lập cơ bản. OpenClaw có thể giải quyết apiKey nhà cung cấp từ models.providers.*.apiKey qua ${COMETAPI_KEY}. Chỉ sử dụng auth-profiles.json cho secrets được lưu theo từng hồ sơ hoặc xoay vòng.

Tại sao có 3 mục nhà cung cấp cho một nhà cung cấp?

OpenClaw định tuyến theo tính tương thích định dạng API. Giữ các mục riêng biệt cho openai-completions, anthropic-messages và google-generative-ai nếu bạn cần cả ba họ API.

Cấu hình thực sự được chỉnh sửa và hiện thực hóa ở đâu?

Chỉnh sửa ~/.openclaw/openclaw.json. Các nhà cung cấp tùy chỉnh được hiện thực hóa thành models.json theo từng agent dưới ~/.openclaw/agents/<agentId>/ sau khi đồng bộ/tải.

ID mô hình nào được sử dụng trong hướng dẫn này?

gpt-5.4, claude-sonnet-4-6 và gemini-3.1-pro-preview. Bạn có thể thêm bất kỳ mô hình nào từ trang mô hình CometAPI vào khối nhà cung cấp tương ứng.