Hướng dẫn kết nối OpenClaw với API trung chuyển: Cấu hình khung làm việc AI Agent tự chủ

I. OpenClaw là gì?

OpenClaw là một khung làm việc (framework) cho AI Agent mã nguồn mở: Chỉ cần trỏ nó tới một mô hình (cục bộ hoặc cổng kết nối đám mây), nó có thể tự động hoàn thành các tác vụ trên máy tính của bạn như vận hành giao diện, chạy lệnh, quản lý tệp, v.v. Cốt lõi của nó là "cấu hình một endpoint mô hình", vì vậy nó cực kỳ phù hợp để kết nối với cổng kết nối (gateway) của trang web này.

II. Cài đặt OpenClaw

Khuyến nghị sử dụng tập lệnh cài đặt một cú nhấp chuột:

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

Bạn cũng có thể cài đặt bằng Docker hoặc mã nguồn:

git clone https://github.com/openclaw/openclaw.git
cd openclaw
# Docker：./scripts/docker/setup.sh
# Mã nguồn (pnpm)：corepack enable && pnpm install && pnpm openclaw setup

III. Kết nối với cổng kết nối của trang web (hai cách)

Cách 1: Hướng dẫn tương tác (onboard)

Chạy openclaw onboard, khi chọn Provider, hãy chọn tùy chọn hỗ trợ địa chỉ tùy chỉnh (custom address) và nhập:

Base URL : https://www.relay-api.com
API Key  : sk-mã_khóa_của_bạn
Model ID : claude-sonnet-5

(Các endpoint openai / gemini tương ứng với https://www.relay-api.com/v1 và https://www.relay-api.com/v1beta)

Cách 2: Chỉnh sửa trực tiếp tệp cấu hình

OpenClaw đọc tệp ~/.openclaw/openclaw.json (Linux/macOS) hoặc %USERPROFILE%\.openclaw\openclaw.json (Windows). Trong models.providers, hãy thêm một Provider mới:

{
  "gateway": {
    "mode": "local"
  },
  "agents": {
    "defaults": {
      "model": {"primary": "jizhi/claude-sonnet-5"}
    }
  },
  "models": {
    "providers": {
      "jizhi": {
        "baseUrl": "https://www.relay-api.com",
        "apiKey": "sk-mã_khóa_của_bạn",
        "api": "openai-completions"
      }
    }
  }
}

Thay primary bằng slug mô hình bạn đang sử dụng để tất cả các tác vụ AI Agent của OpenClaw đều đi qua cổng kết nối của trang web.

IV. Khởi chạy và các lệnh thường dùng

openclaw gateway --port 18789

Sau khi khởi chạy, truy cập http://localhost:18789 để vào bảng điều khiển. Các lệnh thường dùng:

openclaw doctor              # Chẩn đoán sự cố
openclaw security audit      # Kiểm tra bảo mật
openclaw config set key x    # Sửa đổi cấu hình
openclaw channels add --channel telegram  # Thêm kênh tin nhắn

V. Khắc phục sự cố thường gặp

Hiện tượng	Cách xử lý
401 / 403	Khóa không hợp lệ, chưa được kích hoạt hoặc không đủ số dư; xác nhận sk- chính xác và nạp thêm tiền.
404 / Mô hình không khả dụng	Slug mô hình không khớp với nền tảng hoặc mô hình chưa được kích hoạt; kiểm tra lại ID mô hình.
Không thể kết nối với mô hình	Xác nhận rằng Base URL đang sử dụng đúng địa chỉ cổng vào của trang web.

Lưu ý bảo mật: Không đẩy khóa sk- lên các kho lưu trữ công khai; các tác vụ AI Agent tiêu tốn token khá nhiều, hãy chú ý đến số dư.

Giải thích về Base URL: Trang web này chấp nhận cả /v1beta/models/... và /v1beta/v1beta/models/... (cũng như /v1/... và /v1/v1/...), vì vậy việc ứng dụng khách có tự động thêm /v1, /v1beta hay không đều không ảnh hưởng đến việc gọi API: Bạn có thể nhập địa chỉ gốc của tên miền hoặc địa chỉ có kèm /v1beta vào Base URL đều hoạt động được. Vui lòng truy cập trang "Token" trong bảng điều khiển, tìm ở góc trên bên phải mục "Model ID" để sao chép chính xác.