Hướng dẫn kết nối OpenClaw với API trung chuyển: Cấu hình khung tác nhân tự chủ

1. OpenClaw là gì?

OpenClaw là một khung tác nhân AI (AI Agent Framework) mã nguồn mở: bạn chỉ cần trỏ nó đến một mô hình (cục bộ hoặc cổng kết nối đám mây), nó sẽ tự động hoàn thành các tác vụ trên máy tính của bạn như thao tác 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 điểm cuối mô hình (model endpoint)", 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 chúng tôi.

2. Cài đặt OpenClaw

Khuyên dùng tập lệnh cài đặt bằng 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

3. Kết nối với cổng kết nối (gateway) của chúng tôi (hai phương thức)

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 và điền:

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

(Điểm cuối 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). Thêm một Provider mới vào models.providers:

{
  "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 đổi primary thành slug mô hình bạn đang sử dụng, và tất cả các tác vụ tác nhân của OpenClaw sẽ chạy qua cổng kết nối của trang web chúng tôi.

4. Khởi động và các lệnh thường dùng

openclaw gateway --port 18789

Sau khi khởi động, 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 lỗi
openclaw security audit      # Kiểm tra bảo mật
openclaw config set key x    # Chỉnh sửa cấu hình
openclaw channels add --channel telegram  # Thêm kênh tin nhắn

5. Xử lý sự cố thường gặp

Hiện tượng	Xử lý
401 / 403	Mã 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 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 baseUrl đang sử dụng cổng kết nối của trang web này.

Khuyến nghị bảo mật: Không viết mã khóa sk- vào kho lưu trữ công khai; các tác vụ dạng tác nhân tiêu tốn nhiều token, hãy chú ý số dư.