75 lines
2.3 KiB
Markdown
75 lines
2.3 KiB
Markdown
---
|
||
summary: "Sign in to GitHub Copilot from Clawdbot using the device flow"
|
||
read_when:
|
||
- You want to use GitHub Copilot as a model provider
|
||
- You need the `clawdbot models auth login-github-copilot` flow
|
||
---
|
||
# Github Copilot
|
||
|
||
## What is GitHub Copilot?
|
||
|
||
GitHub Copilot is GitHub's AI coding assistant. It provides access to Copilot
|
||
models for your GitHub account and plan. Clawdbot can use Copilot as a model
|
||
provider in two different ways.
|
||
|
||
## Two ways to use Copilot in Clawdbot
|
||
|
||
### 1) Built-in GitHub Copilot provider (`github-copilot`)
|
||
|
||
Use the native device-login flow to obtain a GitHub token and use it directly
|
||
against the Copilot API. This is the **default** and simplest path because it
|
||
does not require VS Code. Enterprise domains are supported.
|
||
|
||
### 2) Copilot Proxy plugin (`copilot-proxy`)
|
||
|
||
Use the **Copilot Proxy** VS Code extension as a local bridge. Clawdbot talks to
|
||
the proxy’s `/v1` endpoint and uses the model list you configure there. Choose
|
||
this when you already run Copilot Proxy in VS Code or need to route through it.
|
||
You must enable the plugin and keep the VS Code extension running.
|
||
|
||
Use GitHub Copilot as a model provider (`github-copilot`). The login command runs
|
||
the GitHub device flow, saves an auth profile, and updates your config to use that
|
||
profile.
|
||
|
||
## CLI setup
|
||
|
||
```bash
|
||
clawdbot models auth login-github-copilot
|
||
```
|
||
|
||
You'll be prompted to visit a URL and enter a one-time code. Keep the terminal
|
||
open until it completes.
|
||
If you're on GitHub Enterprise, the login will ask for your enterprise URL or
|
||
domain (for example `company.ghe.com`).
|
||
|
||
### Optional flags
|
||
|
||
```bash
|
||
clawdbot models auth login-github-copilot --profile-id github-copilot:work
|
||
clawdbot models auth login-github-copilot --yes
|
||
```
|
||
|
||
## Set a default model
|
||
|
||
```bash
|
||
clawdbot models set github-copilot/gpt-4o
|
||
```
|
||
|
||
### Config snippet
|
||
|
||
```json5
|
||
{
|
||
agents: { defaults: { model: { primary: "github-copilot/gpt-4o" } } }
|
||
}
|
||
```
|
||
|
||
## Notes
|
||
|
||
- Requires an interactive TTY; run it directly in a terminal.
|
||
- Copilot model availability depends on your plan; if a model is rejected, try
|
||
another ID (for example `github-copilot/gpt-4.1`).
|
||
- The login stores a GitHub token in the auth profile store and uses it directly
|
||
for Copilot API calls.
|
||
- Base URL: `https://api.githubcopilot.com` (public) or `https://copilot-api.<domain>`
|
||
for GitHub Enterprise.
|