Chuyển đến nội dung chính
GitHub Copilot là trợ lý lập trình AI của GitHub. Công cụ 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ể dùng Copilot làm nhà cung cấp mô hình hoặc thời gian chạy tác tử theo ba cách khác nhau.

​
Ba cách dùng Copilot trong OpenClaw

Dùng luồng đăng nhập thiết bị gốc để lấy mã thông báo GitHub, rồi trao đổi mã đó 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.
1

Run the login command

openclaw models auth login-github-copilot
Bạn sẽ được nhắc truy cập một URL và nhập mã dùng một lần. Giữ terminal mở cho đến khi hoàn tất.
2

Set a default model

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ờ tùy chọn

CờMô tả
--yesBỏ qua lời nhắc xác nhận
--set-defaultĐồng thời áp dụng mô hình mặc định được nhà cung cấp đề xuất
# Skip confirmation
openclaw models auth login-github-copilot --yes

# Login and set the default model in one step
openclaw models auth login --provider github-copilot --method device --set-default

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

Nếu bạn đã có mã thông báo truy cập GitHub OAuth cho Copilot, hãy nhập mã đó trong quá trình thiết lập không giao diện 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ờ bị bỏ qua, quá trình thiết lập ban đầu sẽ dùng dự phòng lần lượt COPILOT_GITHUB_TOKEN, GH_TOKEN, rồi GITHUB_TOKEN. Dùng --secret-input-mode ref với COPILOT_GITHUB_TOKEN đã đặt để lưu tokenRef dựa trên env thay vì văn bản thuần trong auth-profiles.json.
Luồng đăng nhập thiết bị yêu cầu TTY tương tác. Chạy trực tiếp trong terminal, không chạy trong script không tương tác hoặc pipeline CI.
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ử ID 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.
Sau khi đường dẫn xác thực đăng nhập thiết bị (hoặc env-var) đã phân giải được mã thông báo GitHub, OpenClaw làm mới catalog mô hình theo yêu cầu từ ${baseUrl}/models (cùng endpoint mà VS Code Copilot dùng), để thời gian chạy theo dõi quyền 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 manifest. Các mô hình Copilot mới được 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 giới hạn thực theo 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).Catalog tĩnh đi kèm vẫn là 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, trao đổi mã thông báo thất bại, hoặc lệnh gọi HTTPS tới /models gặp lỗi. Để chọn không dùng và hoàn toàn dựa vào catalog manifest tĩnh (kịch bản ngoại tuyến / air-gapped):
{
  plugins: {
    entries: {
      "github-copilot": {
        config: { discovery: { enabled: false } },
      },
    },
  },
}
ID mô hình Claude tự động dùng transport Anthropic Messages. Các mô hình GPT, o-series, và Gemini giữ transport OpenAI Responses. OpenClaw chọn transport phù hợp dựa trên ref mô hình.
OpenClaw gửi các header yêu cầu kiểu IDE Copilot trên transport Copilot, bao gồm các lượt Compaction tích hợp sẵn, kết quả công cụ, và theo dõi hình ảnh. Công cụ này không bật tiếp diễn Responses ở cấp nhà cung cấp cho Copilot trừ khi hành vi đó đã được xác minh với API của Copilot.
OpenClaw phân giải xác thực Copilot từ biến môi trường theo thứ tự ưu tiên sau:
Ưu tiênBiếnGhi chú
1COPILOT_GITHUB_TOKENƯu tiên cao nhất, dành riêng cho Copilot
2GH_TOKENMã thông báo GitHub CLI (dự phòng)
3GITHUB_TOKENMã thông báo GitHub tiêu chuẩn (thấp nhất)
Khi nhiều biến được đặt, OpenClaw 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 của nó trong kho hồ sơ xác thực và được ưu tiên hơn mọi biến môi trường.
Lệnh đăng nhập lưu mã thông báo GitHub trong kho hồ sơ xác thực và trao đổi mã đó lấy mã thông báo API Copilot khi OpenClaw chạy. Bạn không cần quản lý mã thông báo theo cách thủ công.
Lệnh đăng nhập thiết bị yêu cầu TTY tương tác. Dùng thiết lập ban đầu không tương tác khi bạn cần thiết lập không giao diện.

​
Embedding cho tìm kiếm bộ nhớ

GitHub Copilot cũng có thể đóng vai trò nhà cung cấp embedding cho tìm kiếm bộ nhớ. Nếu bạn có gói đăng ký Copilot và đã đăng nhập, OpenClaw có thể dùng công cụ này cho embedding mà không cần khóa API riêng.

​
Cấu hình

Đặt rõ memorySearch.provider để dùng embedding GitHub Copilot. Nếu có mã thông báo GitHub, OpenClaw khám phá các mô hình embedding khả dụng từ API Copilot và tự động chọn mô hình tốt nhất. 
{
  agents: {
    defaults: {
      memorySearch: {
        provider: "github-copilot",
        // Optional: override the auto-discovered model
        model: "text-embedding-3-small",
      },
    },
  },
}

​
Cách hoạt động

  1. OpenClaw phân giải mã thông báo GitHub của bạn (từ env vars hoặc hồ sơ xác thực).
  2. Trao đổi mã đó lấy mã thông báo API Copilot tồn tại ngắn hạn.
  3. Truy vấn endpoint /models của Copilot để khám phá các mô hình embedding khả dụng.
  4. Chọn mô hình tốt nhất (ưu tiên text-embedding-3-small).
  5. Gửi yêu cầu embedding tới endpoint /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 embedding nào khả dụng, OpenClaw bỏ qua Copilot và thử nhà cung cấp tiếp theo.

​
Liên quan

Model selection

Chọn nhà cung cấp, ref mô hình, và hành vi chuyển đổi dự phòng.

OAuth and auth

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