diff --git a/docs/zh-CN/providers/github-copilot.md b/docs/zh-CN/providers/github-copilot.md index 5af43b130..5d9f7d7fd 100644 --- a/docs/zh-CN/providers/github-copilot.md +++ b/docs/zh-CN/providers/github-copilot.md @@ -5,23 +5,24 @@ read_when: summary: 使用设备流程从 OpenClaw 登录 GitHub Copilot title: GitHub Copilot x-i18n: - generated_at: "2026-04-15T09:41:01Z" + generated_at: "2026-04-20T13:21:05Z" model: gpt-5.4 provider: openai - source_hash: b8258fecff22fb73b057de878462941f6eb86d0c5f775c5eac4840e95ba5eccf + source_hash: f7faafbd3bdcd8886e75fb0d40c3eec66355df3fca6160ebbbb9a0018b7839fe source_path: providers/github-copilot.md workflow: 15 --- # GitHub Copilot -GitHub Copilot 是 GitHub 的 AI 编码助手。它为你的 GitHub 账号和套餐提供对 Copilot 模型的访问。OpenClaw 可以通过两种不同方式将 Copilot 用作模型提供商。 +GitHub Copilot 是 GitHub 的 AI 编码助手。它会根据你的 GitHub 账户和套餐提供对 Copilot 模型的访问。OpenClaw 可以通过两种不同方式将 Copilot 用作模型提供商。 ## 在 OpenClaw 中使用 Copilot 的两种方式 - 使用原生设备登录流程获取 GitHub 令牌，然后在 OpenClaw 运行时将其交换为 Copilot API 令牌。这是**默认**且最简单的路径，因为它不需要 VS Code。 + 使用原生设备登录流程获取 GitHub token，然后在 OpenClaw 运行时将其交换为 + Copilot API token。这是**默认**且最简单的方式，因为它不需要 VS Code。 @@ -29,18 +30,20 @@ GitHub Copilot 是 GitHub 的 AI 编码助手。它为你的 GitHub 账号和套 openclaw models auth login-github-copilot ``` - 系统会提示你访问一个 URL 并输入一次性代码。在流程完成之前，请保持终端开启。 + 系统会提示你访问一个 URL 并输入一次性代码。请保持终端打开，直到流程完成。 ```bash - openclaw models set github-copilot/gpt-4o + openclaw models set github-copilot/claude-opus-4.6 ``` - 或者在配置中： + 或者在配置中设置： ```json5 { - agents: { defaults: { model: { primary: "github-copilot/gpt-4o" } } }, + agents: { + defaults: { model: { primary: "github-copilot/claude-opus-4.6" } }, + }, } ``` @@ -49,10 +52,11 @@ GitHub Copilot 是 GitHub 的 AI 编码助手。它为你的 GitHub 账号和套 - 使用 **Copilot Proxy** VS Code 扩展作为本地桥接。OpenClaw 与代理的 `/v1` 端点通信，并使用你在其中配置的模型列表。 + 使用 **Copilot Proxy** VS Code 扩展作为本地桥接。OpenClaw 会连接到 + 该代理的 `/v1` 端点，并使用你在其中配置的模型列表。 - 当你已经在 VS Code 中运行 Copilot Proxy，或需要通过它进行路由时，请选择此方式。你必须启用该插件，并保持 VS Code 扩展持续运行。 + 如果你已经在 VS Code 中运行 Copilot Proxy，或者需要通过它进行路由，请选择此方式。你必须启用该插件，并保持 VS Code 扩展持续运行。 @@ -60,61 +64,64 @@ GitHub Copilot 是 GitHub 的 AI 编码助手。它为你的 GitHub 账号和套 ## 可选标志 -| Flag | 描述 | -| --------------- | --------------------------------------------------- | -| `--yes` | 跳过确认提示 | -| `--set-default` | 同时应用该提供商推荐的默认模型 | +| 标志 | 说明 | +| --------------- | -------------------------------------------- | +| `--yes` | 跳过确认提示 | +| `--set-default` | 同时应用该提供商推荐的默认模型 | ```bash -# 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 ``` - 设备登录流程需要交互式 TTY。请直接在终端中运行，不要在非交互式脚本或 CI 流水线中运行。 + 设备登录流程需要交互式 TTY。请直接在终端中运行，而不是在非交互脚本或 CI 流水线中运行。 - Copilot 模型的可用性取决于你的 GitHub 套餐。如果某个模型被拒绝，请尝试另一个 ID（例如 `github-copilot/gpt-4.1`）。 + Copilot 模型的可用性取决于你的 GitHub 套餐。如果某个模型被拒绝，请尝试其他 ID（例如 `github-copilot/gpt-4.1`）。 - Claude 模型 ID 会自动使用 Anthropic Messages 传输方式。GPT、o-series 和 Gemini 模型继续使用 OpenAI Responses 传输方式。OpenClaw 会根据模型 ref 选择正确的传输方式。 + Claude 模型 ID 会自动使用 Anthropic Messages 传输方式。GPT、o-series 和 Gemini 模型会继续使用 OpenAI Responses 传输方式。OpenClaw 会根据模型 ref 选择正确的传输方式。 - - OpenClaw 按以下优先级顺序从环境变量中解析 Copilot 认证信息： + + OpenClaw 会按照以下优先级顺序，从环境变量中解析 Copilot 凭证： - | Priority | Variable | Notes | - | -------- | --------------------- | -------------------------------- | - | 1 | `COPILOT_GITHUB_TOKEN` | 最高优先级，Copilot 专用 | - | 2 | `GH_TOKEN` | GitHub CLI 令牌（回退） | - | 3 | `GITHUB_TOKEN` | 标准 GitHub 令牌（最低） | + | 优先级 | 变量 | 说明 | + | ------ | --------------------- | ------------------------------- | + | 1 | `COPILOT_GITHUB_TOKEN` | 最高优先级，Copilot 专用 | + | 2 | `GH_TOKEN` | GitHub CLI token（回退） | + | 3 | `GITHUB_TOKEN` | 标准 GitHub token（最低优先级） | - 当设置了多个环境变量时，OpenClaw 会使用优先级最高的那个。设备登录流程（`openclaw models auth login-github-copilot`）会将其令牌存储在认证配置文件存储中，并且优先于所有环境变量。 + 当设置了多个变量时，OpenClaw 会使用优先级最高的那个。 + 设备登录流程（`openclaw models auth login-github-copilot`）会将 + 其 token 存储在 auth profile 存储中，并且优先于所有环境变量。 - - 登录会将 GitHub 令牌存储在认证配置文件存储中，并在 OpenClaw 运行时将其交换为 Copilot API 令牌。你不需要手动管理该令牌。 + + 登录会将 GitHub token 存储在 auth profile 存储中，并在 OpenClaw 运行时将其交换为 Copilot API token。你无需手动管理该 token。 -需要交互式 TTY。请直接在终端中运行登录命令，不要在无头脚本或 CI 作业中运行。 +需要交互式 TTY。请直接在终端中运行登录命令，不要在无头脚本或 CI 任务中运行。 -## Memory search 嵌入 +## Memory search embeddings -GitHub Copilot 也可以用作 [memory search](/zh-CN/concepts/memory-search) 的嵌入提供商。如果你拥有 Copilot 订阅并且已经登录，OpenClaw 可以在不需要单独 API 密钥的情况下将其用于嵌入。 +GitHub Copilot 也可以作为 +[memory search](/zh-CN/concepts/memory-search) 的嵌入提供商。如果你拥有 Copilot 订阅并且已经登录，OpenClaw 可以在无需单独 API key 的情况下将其用于嵌入。 ### 自动检测 -当 `memorySearch.provider` 为 `"auto"`（默认值）时，GitHub Copilot 会以优先级 15 被尝试 —— 位于本地嵌入之后，但在 OpenAI 和其他付费提供商之前。如果 GitHub 令牌可用，OpenClaw 会从 Copilot API 发现可用的嵌入模型，并自动选择最佳模型。 +当 `memorySearch.provider` 为 `"auto"`（默认值）时，GitHub Copilot 会以优先级 15 尝试——排在本地嵌入之后、OpenAI 和其他付费提供商之前。如果 GitHub token 可用，OpenClaw 会从 Copilot API 发现可用的嵌入模型，并自动选择最佳模型。 ### 显式配置 @@ -124,7 +131,7 @@ GitHub Copilot 也可以用作 [memory search](/zh-CN/concepts/memory-search) defaults: { memorySearch: { provider: "github-copilot", - // Optional: override the auto-discovered model + // 可选：覆盖自动发现的模型 model: "text-embedding-3-small", }, }, @@ -134,21 +141,22 @@ GitHub Copilot 也可以用作 [memory search](/zh-CN/concepts/memory-search) ### 工作原理 -1. OpenClaw 解析你的 GitHub 令牌（来自环境变量或认证配置文件）。 -2. 将其交换为短期有效的 Copilot API 令牌。 +1. OpenClaw 解析你的 GitHub token（来自环境变量或 auth profile）。 +2. 将其交换为短期有效的 Copilot API token。 3. 查询 Copilot `/models` 端点以发现可用的嵌入模型。 4. 选择最佳模型（优先 `text-embedding-3-small`）。 5. 将嵌入请求发送到 Copilot `/embeddings` 端点。 -模型可用性取决于你的 GitHub 套餐。如果没有可用的嵌入模型，OpenClaw 会跳过 Copilot 并尝试下一个提供商。 +模型可用性取决于你的 GitHub 套餐。如果没有可用的嵌入模型， +OpenClaw 会跳过 Copilot 并尝试下一个提供商。 ## 相关内容 - 选择提供商、模型 ref 和故障转移行为。 + 选择提供商、模型 ref 和故障切换行为。 - - 认证细节和凭证复用规则。 + + 凭证细节和凭证复用规则。