Skip to main content

​
Xác thực

Đối với tài khoản Anthropic, chúng tôi khuyến nghị sử dụng API key. Đối với các tài khoản Anthropic, chúng tôi khuyến nghị sử dụng API key. Đối với quyền truy cập thuê bao Claude, hãy dùng token tồn tại lâu được tạo bởi claude setup-token. Xem /concepts/oauth để biết đầy đủ luồng OAuth và cách bố trí lưu trữ.

​
Thiết lập Anthropic được khuyến nghị (khóa API)

Nếu bạn dùng Anthropic trực tiếp, hãy dùng khóa API.
  1. Tạo khóa API trong Anthropic Console.
  2. Đặt khóa trên máy chủ gateway (máy đang chạy openclaw gateway).
  1. Nếu Gateway chạy dưới systemd/launchd, nên đặt khóa trong ~/.openclaw/.env để daemon có thể đọc:
Sau đó khởi động lại daemon (hoặc khởi động lại tiến trình Gateway) và kiểm tra lại:
Nếu bạn không muốn tự quản lý biến môi trường, trình hướng dẫn ban đầu có thể lưu khóa API để daemon sử dụng: openclaw onboard. Xem Help để biết chi tiết về kế thừa env (env.shellEnv, ~/.openclaw/.env, systemd/launchd).

​
Anthropic: setup-token (xác thực thuê bao)

Đối với Anthropic, đường dẫn được khuyến nghị là API key. Nếu bạn đang dùng thuê bao Claude, luồng setup-token cũng được hỗ trợ. Chạy nó trên gateway host:
Sau đó dán vào OpenClaw:
Nếu token được tạo trên máy khác, hãy dán thủ công:
Nếu bạn thấy lỗi Anthropic như:
…hãy dùng khóa API của Anthropic thay thế. Nhập token thủ công (mọi nhà cung cấp; ghi auth-profiles.json + cập nhật cấu hình):
Kiểm tra thân thiện cho tự động hóa (thoát 1 khi hết hạn/thiếu, 2 khi sắp hết hạn):
Các script vận hành tùy chọn (systemd/Termux) được tài liệu hóa tại đây: /automation/auth-monitoring
claude setup-token yêu cầu TTY tương tác.

​
Kiểm tra trạng thái xác thực mô hình

​
Kiểm soát thông tin xác thực được sử dụng

​
Theo phiên (lệnh chat)

Dùng /model <alias-or-id>@<profileId> để ghim một thông tin xác thực của nhà cung cấp cho phiên hiện tại (ví dụ id hồ sơ: anthropic:default, anthropic:work). Dùng /model (hoặc /model list) cho bộ chọn gọn nhẹ; dùng /model status cho chế độ xem đầy đủ (các ứng viên + hồ sơ xác thực kế tiếp, kèm chi tiết endpoint của nhà cung cấp khi đã cấu hình).

​
Theo từng tác tử (ghi đè CLI)

Đặt ghi đè thứ tự hồ sơ xác thực cho một tác tử (lưu trong auth-profiles.json của tác tử đó):
Dùng --agent <id> để nhắm tới một tác tử cụ thể; bỏ qua để dùng tác tử mặc định đã cấu hình.

​
Xử lý sự cố

​
“Không tìm thấy thông tin xác thực”

Nếu thiếu hồ sơ token Anthropic, hãy chạy claude setup-token trên máy chủ gateway, rồi kiểm tra lại:

​
Token sắp hết hạn/đã hết hạn

Nếu profile bị thiếu, hãy chạy lại claude setup-token và dán lại token. Nếu hồ sơ bị thiếu, hãy chạy lại claude setup-token và dán token lần nữa.

​
Yêu cầu

  • Gói thuê bao Claude Max hoặc Pro (cho claude setup-token)
  • Đã cài Claude Code CLI (có sẵn lệnh claude)