Providers
GitHub Copilot
GitHub Copilot là trợ lý lập trình AI của GitHub. Dịch vụ này cung cấp quyền truy cập vào các mô hình Copilot cho tài khoản và gói GitHub của bạn. OpenClaw có thể sử dụng Copilot làm nhà cung cấp mô hình hoặc môi trường thực thi tác tử theo ba cách khác nhau.
Ba cách sử dụng Copilot trong OpenClaw
Nhà cung cấp tích hợp sẵn (github-copilot)
Sử dụng luồng đăng nhập thiết bị gốc để lấy mã thông báo GitHub, sau đó đổi mã này lấy mã thông báo API Copilot khi OpenClaw chạy. Đây là đường dẫn mặc định và đơn giản nhất vì không yêu cầu VS Code.
Chạy lệnh đăng nhập
openclaw models auth login-github-copilotBạn sẽ được yêu cầu truy cập một URL và nhập mã dùng một lần. Giữ cửa sổ dòng lệnh mở cho đến khi quá trình hoàn tất.
Đặt mô hình mặc định
openclaw models set github-copilot/claude-opus-4.7Hoặc trong cấu hình:
{ agents: { defaults: { model: { primary: "github-copilot/claude-opus-4.7" } }, },}Plugin bộ điều phối Copilot SDK (copilot)
Cài đặt plugin bên ngoài @openclaw/copilot khi bạn muốn Copilot CLI và SDK
của GitHub quản lý vòng lặp tác tử cấp thấp cho các mô hình
github-copilot/* đã chọn.
openclaw plugins install @openclaw/copilotSau đó chọn dùng môi trường thực thi này cho một mô hình hoặc nhà cung cấp:
{ agents: { defaults: { model: "github-copilot/gpt-5.5", models: { "github-copilot/gpt-5.5": { agentRuntime: { id: "copilot" }, }, }, }, },}Chọn cách này khi bạn muốn các phiên Copilot CLI gốc, trạng thái luồng
do SDK quản lý và Compaction do Copilot quản lý cho các lượt tác tử đó. Nếu không
chủ động chọn agentRuntime một cách rõ ràng, các mô hình github-copilot/* vẫn sử dụng
nhà cung cấp tích hợp sẵn. Xem Bộ điều phối Copilot SDK để biết đầy đủ
hợp đồng môi trường thực thi.
Plugin Copilot Proxy (copilot-proxy)
Sử dụng tiện ích mở rộng Copilot Proxy cho VS Code làm cầu nối cục bộ. OpenClaw giao tiếp với
điểm cuối /v1 của proxy (mặc định là http://localhost:3000/v1) và sử dụng
danh sách mô hình mà bạn cấu hình.
Plugin copilot-proxy được phân phối cùng OpenClaw và được bật theo mặc định.
Cấu hình URL cơ sở và mã định danh mô hình bằng:
openclaw models auth login --provider copilot-proxy --set-defaultGitHub Enterprise (vị trí lưu trú dữ liệu)
Nếu tổ chức của bạn sử dụng một đối tượng thuê GitHub Enterprise có yêu cầu lưu trú dữ liệu (máy chủ
*.ghe.com, chẳng hạn như your-org.ghe.com), Copilot hoạt động trên các điểm cuối cục bộ
của đối tượng thuê thay vì github.com công khai. OpenClaw cung cấp đây như một
lựa chọn xác thực hạng nhất để bạn không phải chỉnh sửa URL thủ công.
Chọn phương thức xác thực Enterprise
Trong quy trình thiết lập ban đầu hoặc openclaw models auth, chọn
GitHub Copilot (Enterprise / data residency). Bạn sẽ được yêu cầu nhập
miền Enterprise của mình (ví dụ: your-org.ghe.com), sau đó quy trình
đăng nhập thiết bị sẽ chạy với đối tượng thuê đó.
Chỉ nhập miền gốc của đối tượng thuê (your-org.ghe.com). Các máy chủ dịch vụ dẫn xuất như
api.your-org.ghe.com hoặc copilot-api.your-org.ghe.com không được chấp nhận;
OpenClaw tự động suy ra các điểm cuối đó từ miền gốc của đối tượng thuê.
openclaw models auth login --provider github-copilot --method device-enterpriseMiền được lưu vào cấu hình
Máy chủ đã chọn được lưu trong các tham số của nhà cung cấp để các lần làm mới mã thông báo và hoàn tất sau đó tự động nhắm đến đối tượng thuê:
{ models: { providers: { "github-copilot": { params: { githubDomain: "your-org.ghe.com" } }, }, },}Luồng thiết bị, quá trình trao đổi mã thông báo và các yêu cầu hoàn tất lần lượt được phân giải thành
https://your-org.ghe.com/login/device/code,
https://api.your-org.ghe.com/copilot_internal/v2/token và
https://copilot-api.your-org.ghe.com. Mã thông báo lưu trú dữ liệu mang
dấu nhận diện đối tượng thuê và không có gợi ý proxy, vì vậy URL cơ sở cho yêu cầu hoàn tất sẽ dùng dự phòng
máy chủ Copilot của đối tượng thuê thay vì điểm cuối công khai.
Cờ tùy chọn
| Lệnh | Cờ | Mô tả |
|---|---|---|
openclaw models auth login-github-copilot |
--yes |
Ghi đè hồ sơ xác thực hiện có mà không yêu cầu xác nhận |
openclaw models auth login --provider github-copilot --method device |
--set-default |
Đồng thời áp dụng mô hình mặc định do nhà cung cấp đề xuất |
# Bỏ qua xác nhận đăng nhập lạiopenclaw models auth login-github-copilot --yes # Đăng nhập và đặt mô hình mặc định trong một bướcopenclaw models auth login --provider github-copilot --method device --set-defaultThiết lập ban đầu không tương tác
Luồng đăng nhập thiết bị yêu cầu TTY tương tác. Đối với thiết lập không giao diện, hãy nhập
mã thông báo truy cập GitHub OAuth hiện có bằng openclaw onboard --non-interactive:
openclaw onboard --non-interactive --accept-risk \ --auth-choice github-copilot \ --github-copilot-token "$COPILOT_GITHUB_TOKEN" \ --skip-channels --skip-healthBạn cũng có thể bỏ qua --auth-choice; việc truyền --github-copilot-token sẽ suy ra
lựa chọn xác thực nhà cung cấp GitHub Copilot. Nếu cờ này bị bỏ qua, quy trình thiết lập ban đầu sẽ
lần lượt dùng dự phòng COPILOT_GITHUB_TOKEN, GH_TOKEN, rồi GITHUB_TOKEN. Sử dụng
--secret-input-mode ref khi đã đặt COPILOT_GITHUB_TOKEN để lưu tokenRef
dựa trên biến môi trường thay vì văn bản thuần trong auth-profiles.json.
Yêu cầu TTY tương tác
Luồng đăng nhập thiết bị yêu cầu TTY tương tác. Hãy chạy trực tiếp trong cửa sổ dòng lệnh, không chạy trong tập lệnh không tương tác hoặc quy trình CI.
Tính khả dụng của mô hình phụ thuộc vào gói của bạn
Tính khả dụng của mô hình Copilot phụ thuộc vào gói GitHub của bạn. Nếu một mô hình bị
từ chối, hãy thử mã định danh khác (ví dụ: github-copilot/gpt-5.5). Xem
các mô hình được hỗ trợ theo từng gói Copilot
của GitHub để biết danh sách mô hình hiện tại.
Làm mới danh mục trực tiếp từ API Copilot
Sau khi đường dẫn xác thực bằng đăng nhập thiết bị (hoặc biến môi trường) phân giải được mã thông báo GitHub,
OpenClaw làm mới danh mục mô hình theo yêu cầu từ ${baseUrl}/models
(cùng điểm cuối mà VS Code Copilot sử dụng), nhờ đó môi trường thực thi theo dõi
quyền sử dụng theo từng tài khoản và cửa sổ ngữ cảnh chính xác mà không cần thay đổi
tệp kê khai. Các mô hình Copilot mới phát hành sẽ hiển thị mà không cần nâng cấp OpenClaw,
và cửa sổ ngữ cảnh phản ánh các giới hạn thực tế của từng mô hình
(ví dụ: 400k cho dòng gpt-5.x, 1M cho các biến thể nội bộ
claude-opus-*-1m).
Danh mục tĩnh đi kèm vẫn là phương án dự phòng hiển thị khi tính năng khám phá
bị tắt, người dùng không có hồ sơ xác thực GitHub, quá trình trao đổi mã thông báo
thất bại hoặc lệnh gọi HTTPS /models gặp lỗi. Để không sử dụng tính năng này và hoàn toàn
dựa vào danh mục tệp kê khai tĩnh (các trường hợp ngoại tuyến / cách ly mạng):
{ plugins: { entries: { "github-copilot": { config: { discovery: { enabled: false } }, }, }, },}Lựa chọn giao thức truyền tải
Mã định danh mô hình Claude tự động sử dụng giao thức truyền tải Anthropic Messages. Các mô hình Gemini sử dụng giao thức truyền tải OpenAI Chat Completions; các mô hình GPT và dòng o tiếp tục sử dụng giao thức truyền tải OpenAI Responses. OpenClaw chọn đúng giao thức truyền tải dựa trên tham chiếu mô hình.
Khả năng tương thích của yêu cầu
OpenClaw gửi các tiêu đề yêu cầu theo kiểu Copilot IDE trên giao thức truyền tải Copilot
(phiên bản trình soạn thảo/plugin VS Code và mã định danh tích hợp vscode-chat),
đánh dấu các lượt tiếp nối kết quả công cụ là do tác tử khởi tạo và đặt tiêu đề thị giác Copilot
khi một lượt có đầu vào hình ảnh.
Thứ tự phân giải biến môi trường
OpenClaw phân giải thông tin xác thực Copilot từ các biến môi trường theo thứ tự ưu tiên sau:
| Mức ưu tiên | Biến | Ghi chú |
|---|---|---|
| 1 | COPILOT_GITHUB_TOKEN |
Ưu tiên cao nhất, dành riêng cho Copilot |
| 2 | GH_TOKEN |
Mã thông báo GitHub CLI (dự phòng) |
| 3 | GITHUB_TOKEN |
Mã thông báo GitHub tiêu chuẩn (thấp nhất) |
Khi nhiều biến được đặt, OpenClaw sử dụng biến có mức ưu tiên cao nhất.
Luồng đăng nhập thiết bị (openclaw models auth login-github-copilot) lưu
mã thông báo vào kho hồ sơ xác thực và được ưu tiên hơn mọi biến môi trường.
Lưu trữ mã thông báo
Quá trình đăng nhập lưu mã thông báo GitHub trong kho hồ sơ xác thực (mã định danh hồ sơ
github-copilot:github) và đổi mã này lấy mã thông báo API Copilot có thời hạn ngắn
khi OpenClaw chạy. Bạn không cần quản lý mã thông báo theo cách thủ công.
Nội dung nhúng tìm kiếm bộ nhớ
GitHub Copilot cũng có thể đóng vai trò là nhà cung cấp nội dung nhúng cho tìm kiếm bộ nhớ. Nếu bạn có gói đăng ký Copilot và đã đăng nhập, OpenClaw có thể sử dụng dịch vụ này cho nội dung nhúng mà không cần khóa API riêng.
Cấu hình
Đặt rõ memorySearch.provider để sử dụng nội dung nhúng GitHub Copilot. Nếu có
mã thông báo GitHub, OpenClaw sẽ khám phá các mô hình nhúng khả dụng từ
API Copilot và tự động chọn mô hình phù hợp nhất.
{ agents: { defaults: { memorySearch: { provider: "github-copilot", // Tùy chọn: ghi đè mô hình được tự động phát hiện model: "text-embedding-3-small", }, }, },}Cách hoạt động
- OpenClaw phân giải mã thông báo GitHub của bạn (từ biến môi trường hoặc hồ sơ xác thực).
- Đổi mã này lấy mã thông báo API Copilot có thời hạn ngắn.
- Truy vấn điểm cuối
/modelscủa Copilot để khám phá các mô hình nhúng khả dụng. - Chọn mô hình phù hợp nhất (thứ tự ưu tiên:
text-embedding-3-small,text-embedding-3-large,text-embedding-ada-002). - Gửi yêu cầu nhúng đến điểm cuối
/embeddingscủa Copilot.
Tính khả dụng của mô hình phụ thuộc vào gói GitHub của bạn. Nếu không có mô hình nhúng nào khả dụng, OpenClaw sẽ bỏ qua Copilot và thử nhà cung cấp tiếp theo.