Chuyển đến nội dung chính
OpenClaw có thể kết nối với 4096bytes thông qua Provider mô hình tùy chỉnh. Ghi cấu hình tương thích OpenAI, đặt mô hình mặc định cho agent, khởi động lại gateway và kích hoạt mô hình mới.

​
Điều kiện cần có

  • Bạn đã hoàn tất Tạo tài khoản.
  • Bạn đã hoàn tất Lấy API Key.
  • OpenClaw đã được cài đặt và openclaw --version hoạt động.
  • Bạn có API Key, Base URL và tên mô hình của 4096bytes.
Các lệnh dưới đây ghi API Key vào cấu hình OpenClaw cục bộ. Không commit lệnh, tệp cấu hình, ảnh chụp màn hình hoặc đầu ra terminal có chứa API Key thật.

​
Cấu hình Provider tùy chỉnh

Chạy lệnh này để thêm 4096bytes làm Provider mô hình tùy chỉnh. 
openclaw config set models.providers.4096bytes '{
  "api": "openai-completions",
  "baseUrl": "https://api.4096bytes.com/v1",
  "apiKey": "YOUR_4096BYTES_API_KEY",
  "auth": "api-key",
  "headers": {
    "User-Agent": "Mozilla/5.0"
  },
  "models": [
    {
      "id": "gpt-5.5",
      "name": "GPT-5.5",
      "contextWindow": 200000,
      "reasoning": true,
      "input": [
        "text"
      ]
    }
  ]
}' --strict-json --merge
Thay YOUR_4096BYTES_API_KEY bằng API Key bạn tạo trong bảng điều khiển. Dùng giá trị hiện tại trong bảng điều khiển cho id, name, contextWindow và reasoning.
Lệnh dùng --strict-json. JSON không được có dấu phẩy cuối, nếu không OpenClaw sẽ từ chối cấu hình.

​
Đặt mô hình mặc định cho agent

Đặt mô hình 4096bytes làm mô hình mặc định cho agent và gán bí danh ngắn. 
openclaw config set agents.defaults.models '{"4096bytes/gpt-5.5": {"alias": "G55"}}' --strict-json --merge
Nếu tên mô hình của bạn không phải gpt-5.5, hãy thay 4096bytes/gpt-5.5 trong lệnh.

​
Khởi động lại gateway

Sau khi ghi cấu hình, khởi động lại OpenClaw gateway. 
openclaw gateway restart

​
Kích hoạt mô hình mới

Đặt phiên hiện tại dùng mô hình 4096bytes. 
openclaw models set 4096bytes/gpt-5.5
Nếu bạn dùng tên mô hình khác, thay gpt-5.5 bằng ID mô hình hiển thị trong bảng điều khiển.

​
Kiểm tra lệnh gọi mô hình

Gửi một tin nhắn ngắn để xác minh kết nối. 
openclaw chat --message "hi"
Nếu OpenClaw phản hồi mà không có lỗi xác thực hoặc không tìm thấy mô hình, cấu hình đã có hiệu lực.

​
Sự cố thường gặp

Kiểm tra dấu phẩy cuối, dấu ngoặc kép chưa escape hoặc thiếu ngoặc. Với --strict-json, giá trị phải là JSON hợp lệ.
Kiểm tra apiKey đã đầy đủ và được sao chép không có khoảng trắng thừa hoặc xuống dòng. Xác nhận API Key chưa bị xóa, hết hạn hoặc vượt hạn mức.
Xác nhận id trong models khớp với ID dùng trong openclaw models set. Sao chép tên mô hình từ bảng điều khiển, không dùng ảnh chụp cũ hoặc cấu hình của người khác.
Trước tiên chạy openclaw gateway restart. Nếu vẫn lỗi, kiểm tra cả models.providers.4096bytes và agents.defaults.models đã được ghi thành công.