OpenClaw에서 GitHub Copilot 연동하기: 5분 설정 가이드

개발 환경을 설정하다 보면 매번 새로운 API 키를 발급받고 관리하는 과정이 꽤 번거롭게 느껴질 때가 많습니다. 이미 사용 중인 도구들을 최대한 활용해 복잡한 설정 없이 바로 AI 기능을 연동하고 싶다면, 이번 가이드가 큰 도움이 될 것입니다.

OpenClaw는 GitHub Copilot을 모델 공급자로 활용하여 별도의 추가 API 키 없이도 강력한 AI 기능을 사용할 수 있게 해줍니다. 이 가이드에서는 OpenClaw와 GitHub Copilot을 연동하여 코딩 생산성을 높이는 방법을 단계별로 설명해 드릴게요.

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

OpenClaw는 두 가지 방식으로 GitHub Copilot을 모델 공급자로 활용할 수 있습니다. 상황에 맞는 방식을 선택해 보세요.

1. 내장 공급자 (github-copilot) 네이티브 장치 로그인 흐름을 사용하여 GitHub 토큰을 얻은 뒤, OpenClaw 실행 시 Copilot API 토큰으로 교환하는 방식입니다. VS Code가 필요 없으며 가장 간단한 기본 설정입니다.

   1. 로그인 명령 실행하기

      openclaw models auth login-github-copilot

      터미널에 표시된 URL에 접속하여 일회용 코드를 입력하세요. 완료될 때까지 터미널 창을 닫지 마세요.

   2. 기본 모델 설정하기

      openclaw models set github-copilot/claude-opus-4.6

      또는 설정 파일에서 다음과 같이 지정할 수 있습니다.

      {
        agents: {
          defaults: { model: { primary: "github-copilot/claude-opus-4.6" } },
        },
      }

2. Copilot Proxy 플러그인 (copilot-proxy) Copilot Proxy VS Code 확장 프로그램을 로컬 브리지로 사용하는 방식입니다. OpenClaw가 프록시의 /v1 엔드포인트와 통신하며, 설정된 모델 목록을 사용합니다. 이미 VS Code에서 Copilot Proxy를 실행 중이거나 이를 통해 라우팅해야 하는 경우 이 방식을 선택하세요. 플러그인을 활성화하고 VS Code 확장 프로그램을 계속 실행해 두어야 합니다.

선택적 플래그

명령어 실행 시 필요한 옵션을 추가하여 설정을 더 간편하게 만들 수 있습니다.

플래그	설명
--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

• 대화형 TTY 필요: 장치 로그인 흐름은 대화형 TTY가 필요합니다. 비대화형 스크립트나 CI 파이프라인이 아닌 터미널에서 직접 실행하세요.
• 플랜에 따른 모델 가용성: Copilot 모델 가용성은 GitHub 플랜에 따라 다릅니다. 모델이 거부되면 다른 ID(예: github-copilot/gpt-4.1)를 시도해 보세요.
• 전송 방식 선택: Claude 모델 ID는 Anthropic Messages 전송을 자동으로 사용합니다. GPT, o-시리즈, Gemini 모델은 OpenAI Responses 전송을 유지합니다. OpenClaw는 모델 참조를 기반으로 올바른 전송 방식을 선택합니다.
• 환경 변수 해결 순서: OpenClaw는 다음 우선순위에 따라 Copilot 인증을 해결합니다.

우선순위	변수	참고
1	COPILOT_GITHUB_TOKEN	최우선 순위, Copilot 전용
2	GH_TOKEN	GitHub CLI 토큰 (대체용)
3	GITHUB_TOKEN	표준 GitHub 토큰 (최하위)

여러 변수가 설정된 경우 OpenClaw는 가장 높은 우선순위의 변수를 사용합니다. 장치 로그인 흐름(openclaw models auth login-github-copilot)은 인증 프로필 저장소에 토큰을 저장하며, 모든 환경 변수보다 우선합니다.

• 토큰 저장: 로그인을 수행하면 GitHub 토큰이 인증 프로필 저장소에 저장되며, OpenClaw 실행 시 Copilot API 토큰으로 교환됩니다. 토큰을 수동으로 관리할 필요는 없습니다.

경고 대화형 TTY가 필요합니다. 로그인 명령은 헤드리스 스크립트나 CI 작업 내부가 아닌 터미널에서 직접 실행하세요.

메모리 검색 임베딩

GitHub Copilot은 메모리 검색을 위한 임베딩 공급자로도 사용할 수 있습니다. Copilot 구독이 있고 로그인이 완료된 상태라면, 별도의 API 키 없이도 임베딩 기능을 활용할 수 있습니다.

자동 감지

memorySearch.provider가 "auto"(기본값)로 설정되어 있으면, GitHub Copilot은 로컬 임베딩 다음이자 다른 유료 공급자보다 앞선 우선순위 15로 시도됩니다. GitHub 토큰을 사용할 수 있는 경우, OpenClaw는 Copilot API에서 사용 가능한 임베딩 모델을 자동으로 찾아 최적의 모델을 선택합니다.

명시적 설정

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

작동 원리

1. OpenClaw가 GitHub 토큰을 확인합니다(환경 변수 또는 인증 프로필에서).
2. 토큰을 단기 Copilot API 토큰으로 교환합니다.
3. Copilot /models 엔드포인트를 쿼리하여 사용 가능한 임베딩 모델을 찾습니다.
4. 최적의 모델을 선택합니다(text-embedding-3-small 선호).
5. Copilot /embeddings 엔드포인트로 임베딩 요청을 보냅니다.

모델 가용성은 GitHub 플랜에 따라 다릅니다. 사용 가능한 임베딩 모델이 없으면 OpenClaw는 Copilot을 건너뛰고 다음 공급자를 시도합니다.

관련 문서

추가적인 설정이나 인증 방식에 대해 더 자세히 알고 싶다면 아래 문서를 확인해 보세요.

• 모델 공급자 선택: 공급자 선택, 모델 참조 및 장애 조치 동작에 대해 알아보세요.
• Gateway 인증: 인증 세부 정보 및 자격 증명 재사용 규칙을 확인하세요.

더 궁금한 점이 있다면 AI Setup Assistant를 통해 언제든 도움을 받으실 수 있습니다!