Chuyển đến nội dung chính
Một trợ lý AI cá nhân mã nguồn mở, tự lưu trữ. Trang: https://openclaw.ai (tài liệu: https://docs.openclaw.ai, repo: https://github.com/openclaw/openclaw).
Giao thức: tương thích OpenAI
  • Base URL: https://api.orcarouter.ai/v1 (phải chứa /v1)

​
Cài đặt

Yêu cầu Node 22+. Cài lệnh openclaw: 
npm install -g openclaw
Hoặc trên macOS/Linux: 
curl -fsSL https://openclaw.ai/install.sh | bash

​
Cấu hình

Sửa ~/.openclaw/openclaw.json: 
{
  "models": {
    "mode": "merge",
    "providers": {
      "orcarouter": {
        "baseUrl": "https://api.orcarouter.ai/v1",
        "apiKey": "sk-orca-...",
        "api": "openai-completions",
        "models": [ { "id": "orcarouter/auto", "name": "OrcaRouter Auto" } ]
      }
    }
  },
  "agents": { "defaults": { "model": { "primary": "orcarouter/orcarouter/auto" } } },
  "gateway": { "mode": "local" }
}

​
Chạy

openclaw agent --local --agent main --session-id s1 -m "Reply with exactly: OK"
Mong đợi câu trả lời OK.

​
Ghi chú

  • baseUrl phải nằm dưới models.providers.<name>, không phải bên trong từng mục model. Đặt nó trên một model sẽ cho lỗi Unrecognized key: "baseUrl".
  • Base URL giữ phần đuôi /v1. Tham chiếu model dùng provider/model, nên router auto là orcarouter/orcarouter/auto.
  • Tên agent mặc định là main (không phải default). Với các lần chạy không tương tác, dùng --local cùng một --session-id.
  • Tên model dùng định dạng vendor/model. Thay orcarouter/auto bằng một model cụ thể như anthropic/claude-opus-4.8 hoặc google/gemini-2.5-flash (và cập nhật tham chiếu primary cho phù hợp).

​
Thinking / suy luận

OpenClaw giao tiếp với OrcaRouter qua API tương thích OpenAI tiêu chuẩn (api: "openai-completions"), nên suy luận theo hành vi riêng của model — hãy chọn một model có khả năng suy luận (ví dụ một model suy luận anthropic/claude-*) và nó sẽ suy nghĩ theo cấu hình ở upstream.