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)
Plugin bộ điều phối Copilot SDK (copilot)
Plugin Copilot Proxy (copilot-proxy)

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-copilot

Bạ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.7

Hoặc trong cấu hình:

{
  agents: {
    defaults: { model: { primary: "github-copilot/claude-opus-4.7" } },
  },
}

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/copilot

Sau đó 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.

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-default

Chọn cách này khi bạn đã chạy Copilot Proxy trong VS Code hoặc cần định tuyến qua tiện ích này. Tiện ích mở rộng VS Code phải luôn chạy.

GitHub 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-enterprise

Miề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.

Việc chuyển đổi miền luôn chạy lại quy trình đăng nhập thiết bị. Nếu bạn đã lưu mã thông báo Copilot và chọn một miền khác (github.com công khai ↔ một đối tượng thuê *.ghe.com, hoặc từ đối tượng thuê này sang đối tượng thuê khác), OpenClaw sẽ không tái sử dụng mã thông báo hiện có — hệ thống buộc đăng nhập mới để mã thông báo chỉ có phạm vi đối với miền đang được ghi vào cấu hình. Việc chạy lại đăng nhập cho cùng một miền vẫn cung cấp lựa chọn tái sử dụng mã thông báo hiện tại. Chuyển lại sang github.com công khai sẽ xóa githubDomain đã lưu để cấu hình trở về mặc định.

Biến môi trường COPILOT_GITHUB_DOMAIN ghi đè miền đã phân giải cho mọi đường dẫn Copilot có phân giải miền này — quy trình đăng nhập thiết bị Enterprise (--method device-enterprise), lối tắt độc lập openclaw models auth login-github-copilot, quá trình làm mới mã thông báo, nội dung nhúng và yêu cầu hoàn tất. Đặt biến này thành máy chủ *.ghe.com của bạn cho các thiết lập hoàn toàn không giao diện hoặc CI. Không đặt biến này (và không có tham số cấu hình) để sử dụng github.com công khai. Các lần đăng nhập lưu lại miền mà mã thông báo được cấp cho miền đó (và xóa miền khi đăng nhập với github.com công khai), vì vậy việc định tuyến vẫn chính xác ngay cả sau khi biến môi trường bị bỏ đặt.

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ại
openclaw models auth login-github-copilot --yes

# Đăng nhập và đặt mô hình mặc định trong một bước
openclaw models auth login --provider github-copilot --method device --set-default

Thiế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-health

Bạ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 /models củ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 /embeddings củ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.

Nội dung liên quan

Lựa chọn mô hình

Chọn nhà cung cấp, tham chiếu mô hình và cơ chế chuyển đổi dự phòng.

OAuth và xác thực

Chi tiết xác thực và quy tắc tái sử dụng thông tin xác thực.

Overview

Concepts and configuration

Providers

Ba cách sử dụng Copilot trong OpenClaw

GitHub Enterprise (vị trí lưu trú dữ liệu)

Cờ tùy chọn

Thiết lập ban đầu không tương tác

Nội dung nhúng tìm kiếm bộ nhớ

Cấu hình

Cách hoạt động

Nội dung liên quan

Lựa chọn mô hình

OAuth và xác thực

​Ba cách sử dụng Copilot trong OpenClaw

​GitHub Enterprise (vị trí lưu trú dữ liệu)

​Cờ tùy chọn

​Thiết lập ban đầu không tương tác

​Nội dung nhúng tìm kiếm bộ nhớ

​Cấu hình

​Cách hoạt động

​Nội dung liên quan

Lựa chọn mô hình

OAuth và xác thực

Ba cách sử dụng Copilot trong OpenClaw

GitHub Enterprise (vị trí lưu trú dữ liệu)

Cờ tùy chọn

Thiết lập ban đầu không tương tác

Nội dung nhúng tìm kiếm bộ nhớ

Cấu hình

Cách hoạt động

Nội dung liên quan