@@ -14,12 +14,12 @@ the finished turn to OpenClaw.
1414Runtimes are easy to confuse with providers because both show up near model
1515configuration. They are different layers:
161617-| Layer | Examples | What it means |
18-| ------------- | ------------------------------------- | ------------------------------------------------------------------- |
19-| Provider | `openai`, `anthropic`, `openai-codex` | How OpenClaw authenticates, discovers models, and names model refs. |
20-| Model | `gpt-5.5`, `claude-opus-4-6` | The model selected for the agent turn. |
21-| Agent runtime | `openclaw`, `codex`, `claude-cli` | The low level loop or backend that executes the prepared turn. |
22-| Channel | Telegram, Discord, Slack, WhatsApp | Where messages enter and leave OpenClaw. |
17+| Layer | Examples | What it means |
18+| ------------- | -------------------------------------------- | ------------------------------------------------------------------- |
19+| Provider | `openai`, `anthropic`, `openai-codex` | How OpenClaw authenticates, discovers models, and names model refs. |
20+| Model | `gpt-5.5`, `claude-opus-4-6` | The model selected for the agent turn. |
21+| Agent runtime | `openclaw`, `codex`, `copilot`, `claude-cli` | The low level loop or backend that executes the prepared turn. |
22+| Channel | Telegram, Discord, Slack, WhatsApp | Where messages enter and leave OpenClaw. |
23232424You will also see the word **harness** in code. A harness is the implementation
2525that provides an agent runtime. For example, the bundled Codex harness
@@ -33,13 +33,17 @@ There are two runtime families:
33333434- **Embedded harnesses** run inside OpenClaw's prepared agent loop. Today this
3535 is the built-in `openclaw` runtime plus registered plugin harnesses such as
36-`codex`.
36+`codex` and `copilot`.
3737- **CLI backends** run a local CLI process while keeping the model ref
3838 canonical. For example, `anthropic/claude-opus-4-7` with
3939 a model-scoped `agentRuntime.id: "claude-cli"` means "select the Anthropic
4040 model, execute through Claude CLI." `claude-cli` is not an embedded harness id
4141 and must not be passed to AgentHarness selection.
424243+The `copilot` harness is a separate, opt-in plugin harness for the
44+GitHub Copilot CLI; see [GitHub Copilot agent runtime](/plugins/copilot)
45+for the user-facing decision between PI, Codex, and GitHub Copilot agent runtime.
46+4347## Codex surfaces
44484549Most confusion comes from several different surfaces sharing the Codex name:
@@ -201,6 +205,34 @@ If `openclaw doctor` warns that the `codex` plugin is enabled while
201205`openai-codex/*` remains in config, treat that as legacy route state. Run
202206`openclaw doctor --fix` to rewrite it to `openai/*` with the Codex runtime.
203207208+## GitHub Copilot agent runtime
209+210+The bundled `copilot` extension registers an opt-in `copilot` runtime
211+backed by the GitHub Copilot CLI (`@github/copilot-sdk`). It claims the
212+canonical subscription `github-copilot` provider and is **never** selected by
213+`auto`. Opt in per-model or per-provider via `agentRuntime.id`:
214+215+```json5
216+{
217+ agents: {
218+ defaults: {
219+ model: "github-copilot/gpt-5.5",
220+ models: {
221+"github-copilot/gpt-5.5": {
222+ agentRuntime: { id: "copilot" },
223+ },
224+ },
225+ },
226+ },
227+}
228+```
229+230+The harness claims its provider, runtime, CLI session key, and auth profile
231+prefix in `extensions/copilot/doctor-contract-api.ts`, which
232+`openclaw doctor` auto-loads. For configuration, auth, transcript mirroring,
233+compaction, the doctor probe surface, and the broader PI vs Codex vs Copilot
234+SDK decision, see [GitHub Copilot agent runtime](/plugins/copilot).
235+204236## Compatibility contract
205237206238When a runtime is not OpenClaw, it should document what OpenClaw surfaces it supports.
@@ -236,6 +268,7 @@ runtime policy first. Legacy session runtime pins no longer decide routing.
236268237269- [Codex harness](/plugins/codex-harness)
238270- [Codex harness runtime](/plugins/codex-harness-runtime)
271+- [GitHub Copilot agent runtime](/plugins/copilot)
239272- [OpenAI](/providers/openai)
240273- [Agent harness plugins](/plugins/sdk-agent-harness)
241274- [Agent loop](/concepts/agent-loop)
此内容由惯性聚合(RSS阅读器)自动聚合整理，仅供阅读参考。 原文来自 — 版权归原作者所有。