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

    bash
    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

    bash
    openclaw models set github-copilot/claude-opus-4.7

    Hoặc trong cấu hình:

    json5
    {  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.

    bash
    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:

    json5
    {  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:

    bash
    openclaw models auth login --provider copilot-proxy --set-default

    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ê.

    bash
    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ê:

    json5
    {  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/tokenhttps://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
    bash
    # 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-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:

    bash
    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):

    json5
    {  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.

    json5
    {  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

    1. 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).
    2. Đổi mã này lấy mã thông báo API Copilot có thời hạn ngắn.
    3. Truy vấn điểm cuối /models của Copilot để khám phá các mô hình nhúng khả dụng.
    4. 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).
    5. 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

    Was this useful?
    On this page

    On this page