메인 콘텐츠로 건너뛰기

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

GitHub Copilot은 GitHub의 AI 코딩 어시스턴트입니다. GitHub 계정과 플랜에 맞는 Copilot 모델에 접근할 수 있게 해줍니다. OpenClaw는 두 가지 방식으로 Copilot을 모델 제공자로 사용할 수 있습니다.

​
OpenClaw에서 Copilot을 사용하는 두 가지 방법

네이티브 디바이스 로그인 플로우를 사용해 GitHub 토큰을 얻은 다음, OpenClaw가 실행될 때 이를 Copilot API 토큰으로 교환합니다. VS Code가 필요 없기 때문에 이것이 기본값이며 가장 간단한 경로입니다.
1

Run the login command

openclaw models auth login-github-copilot
URL을 방문하고 일회용 코드를 입력하라는 안내가 표시됩니다. 완료될 때까지 터미널을 열어 두세요.
2

Set a default model

openclaw models set github-copilot/claude-opus-4.7
또는 config에서:
{
  agents: {
    defaults: { model: { primary: "github-copilot/claude-opus-4.7" } },
  },
}

​
선택적 플래그

플래그설명
--yes확인 프롬프트 건너뛰기
--set-default제공자의 권장 기본 모델도 적용
# 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

​
비대화형 온보딩

Copilot용 GitHub OAuth 액세스 토큰이 이미 있다면, headless 설정 중 openclaw onboard --non-interactive로 가져오세요. 
openclaw onboard --non-interactive --accept-risk \
  --auth-choice github-copilot \
  --github-copilot-token "$COPILOT_GITHUB_TOKEN" \
  --skip-channels --skip-health
--auth-choice를 생략할 수도 있습니다. --github-copilot-token을 전달하면 GitHub Copilot 제공자 인증 선택이 추론됩니다. 플래그를 생략하면 온보딩은 COPILOT_GITHUB_TOKEN, GH_TOKEN, 그다음 GITHUB_TOKEN으로 폴백합니다. COPILOT_GITHUB_TOKEN이 설정된 상태에서 --secret-input-mode ref를 사용하면 auth-profiles.json에 평문 대신 env 기반 tokenRef가 저장됩니다.
디바이스 로그인 플로우에는 대화형 TTY가 필요합니다. 비대화형 스크립트나 CI 파이프라인이 아니라 터미널에서 직접 실행하세요.
Copilot 모델 사용 가능 여부는 GitHub 플랜에 따라 달라집니다. 모델이 거부되면 다른 ID를 시도하세요(예: github-copilot/gpt-4.1).
디바이스 로그인(또는 env-var) 인증 경로가 GitHub 토큰을 확인하면, OpenClaw는 ${baseUrl}/models에서 필요할 때 모델 카탈로그를 새로 고칩니다. 이는 VS Code Copilot이 사용하는 것과 같은 엔드포인트이므로 런타임은 매니페스트 변경 없이 계정별 권한과 정확한 컨텍스트 창을 추적합니다. 새로 게시된 Copilot 모델은 OpenClaw 업그레이드 없이 표시되며, 컨텍스트 창은 실제 모델별 제한을 반영합니다 (예: gpt-5.x 시리즈는 400k, 내부 claude-opus-*-1m 변형은 1M).검색이 비활성화되어 있거나, 사용자에게 GitHub 인증 프로필이 없거나, 토큰 교환이 실패하거나, /models HTTPS 호출에서 오류가 발생하면 번들된 정적 카탈로그가 표시되는 폴백으로 유지됩니다. 완전히 옵트아웃하고 정적 매니페스트 카탈로그에만 의존하려면(오프라인 / 에어갭 시나리오):
{
  plugins: {
    entries: {
      "github-copilot": {
        config: { discovery: { enabled: false } },
      },
    },
  },
}
Claude 모델 ID는 Anthropic Messages 전송을 자동으로 사용합니다. GPT, o-series, Gemini 모델은 OpenAI Responses 전송을 유지합니다. OpenClaw는 모델 ref를 기반으로 올바른 전송을 선택합니다.
OpenClaw는 내장 Compaction, 도구 결과, 이미지 후속 턴을 포함해 Copilot 전송에서 Copilot IDE 스타일 요청 헤더를 보냅니다. Copilot의 API에 대해 해당 동작이 검증되지 않은 경우, Copilot에 대해 제공자 수준 Responses continuation을 활성화하지 않습니다.
OpenClaw는 다음 우선순위에 따라 환경 변수에서 Copilot 인증을 확인합니다.
우선순위변수참고
1COPILOT_GITHUB_TOKEN가장 높은 우선순위, Copilot 전용
2GH_TOKENGitHub CLI 토큰(폴백)
3GITHUB_TOKEN표준 GitHub 토큰(가장 낮음)
여러 변수가 설정되어 있으면 OpenClaw는 우선순위가 가장 높은 변수를 사용합니다. 디바이스 로그인 플로우(openclaw models auth login-github-copilot)는 해당 토큰을 인증 프로필 저장소에 저장하며 모든 환경 변수보다 우선합니다.
로그인은 GitHub 토큰을 인증 프로필 저장소에 저장하고 OpenClaw가 실행될 때 이를 Copilot API 토큰으로 교환합니다. 토큰을 수동으로 관리할 필요가 없습니다.
디바이스 로그인 명령에는 대화형 TTY가 필요합니다. headless 설정이 필요할 때는 비대화형 온보딩을 사용하세요.

​
메모리 검색 임베딩

GitHub Copilot은 메모리 검색의 임베딩 제공자로도 사용할 수 있습니다. Copilot 구독이 있고 로그인되어 있다면, OpenClaw는 별도의 API 키 없이 임베딩에 이를 사용할 수 있습니다.

​
자동 감지

memorySearch.provider가 "auto"(기본값)일 때 GitHub Copilot은 우선순위 15에서 시도됩니다. 즉 로컬 임베딩 이후, OpenAI 및 기타 유료 제공자 이전입니다. GitHub 토큰이 있으면 OpenClaw는 Copilot API에서 사용 가능한 임베딩 모델을 검색하고 가장 적합한 모델을 자동으로 선택합니다.

​
명시적 config

{
  agents: {
    defaults: {
      memorySearch: {
        provider: "github-copilot",
        // Optional: override the auto-discovered model
        model: "text-embedding-3-small",
      },
    },
  },
}

​
작동 방식

  1. OpenClaw가 GitHub 토큰을 확인합니다(env vars 또는 인증 프로필에서).
  2. 이를 단기 Copilot API 토큰으로 교환합니다.
  3. Copilot /models 엔드포인트를 쿼리해 사용 가능한 임베딩 모델을 검색합니다.
  4. 가장 적합한 모델을 선택합니다(text-embedding-3-small 선호).
  5. 임베딩 요청을 Copilot /embeddings 엔드포인트로 보냅니다.
모델 사용 가능 여부는 GitHub 플랜에 따라 달라집니다. 사용 가능한 임베딩 모델이 없으면 OpenClaw는 Copilot을 건너뛰고 다음 제공자를 시도합니다.

​
관련 항목

Model selection

제공자, 모델 ref, 장애 조치 동작 선택.

OAuth and auth

인증 세부 정보와 자격 증명 재사용 규칙.