OpenAI

• 에이전트 모델 - 명시적인 agentRuntime 구성 또는 OpenAI의 암시적 경로 정책으로 선택된 런타임을 통해 openai/*을 사용합니다. ChatGPT/Codex 구독을 사용하려면 Codex 인증으로 로그인하고, 키 기반 결제를 원하면 API 키 인증 프로필을 구성하십시오.
• 비에이전트 OpenAI API - OPENAI_API_KEY 또는 openai API 키 인증 프로필을 통해 사용량에 따라 과금되는 직접 OpenAI Platform 액세스입니다.
• 레거시 구성 - openclaw doctor --fix이 codex/* 및 openai-codex/* 참조를 openai/*과 모델 범위의 agentRuntime.id: "codex"로 복구합니다.

​

사용량 및 비용 추적

• ChatGPT/Codex OAuth에는 구독 요금제, 할당량 기간 및 크레딧 잔액이 표시됩니다.
• OPENAI_ADMIN_KEY에는 일별 지출, 요청/토큰 합계, 상위 모델 및 비용 범주를 포함하여 제공자가 보고한 30일간의 조직 비용과 완료 사용량이 Control UI의 사용량에 표시됩니다.
• OPENAI_PROJECT_ID은 선택적으로 Admin API 기록의 범위를 한 프로젝트로 제한합니다.
• OpenClaw는 OPENAI_API_KEY 또는 openai 추론 프로필을 조직 API에 절대 전송하지 않습니다. 이러한 자격 증명은 사용자 지정, Azure 또는 에이전트 로컬 엔드포인트에 속할 수 있습니다.

​

빠른 선택

​

이름 매핑

​

암시적 에이전트 런타임

​

GPT-5.6 제한적 프리뷰

openclaw models list --provider openai

openclaw models set openai/gpt-5.5

​

OpenClaw 기능 지원 범위

​

메모리 임베딩

{
  agents: {
    defaults: {
      memorySearch: {
        provider: "openai",
        model: "text-embedding-3-small",
      },
    },
  },
}

​

시작하기

openclaw onboard --auth-choice openai-api-key

openclaw onboard --openai-api-key "$OPENAI_API_KEY"

openclaw models list --provider openai

{
  env: { OPENAI_API_KEY: "example-openai-key-not-real" },
  agents: { defaults: { model: { primary: "openai/gpt-5.6" } } },
}

{
  env: { OPENAI_API_KEY: "example-openai-key-not-real" },
  agents: { defaults: { model: { primary: "openai/chat-latest" } } },
}

openclaw onboard --auth-choice openai

openclaw models auth login --provider openai

openclaw models auth login --provider openai --device-code

openclaw config set agents.defaults.model.primary openai/gpt-5.6-sol

openclaw models list --provider openai

{
  plugins: { entries: { codex: { enabled: true } } },
  agents: {
    defaults: {
      model: { primary: "openai/gpt-5.6-sol" },
    },
  },
}

{
  plugins: { entries: { codex: { enabled: true } } },
  agents: {
    defaults: {
      model: { primary: "openai/gpt-5.6-sol" },
    },
  },
  auth: {
    order: {
      openai: [
        "openai:user@example.com",
        "openai:api-key-backup",
      ],
    },
  },
}

openclaw models status
openclaw models auth list --provider openai
openclaw config get agents.defaults.model --json
openclaw config get models.providers.openai.agentRuntime --json

openclaw models status --agent <id>
openclaw models auth list --agent <id> --provider openai

openclaw doctor --fix
openclaw config validate

openclaw models auth login --provider openai
openclaw models status --probe --probe-provider openai

openclaw models auth login --provider openai --profile-id openai:ritsuko
openclaw models auth login --provider openai --profile-id openai:lain

{
  models: {
    providers: {
      openai: {
        models: [{ id: "gpt-5.5", contextTokens: 160000 }],
      },
    },
  },
}

​

네이티브 Codex 앱 서버 인증

1. 에이전트에 대해 순서가 지정된 OpenAI 인증 프로필이며, 가급적 auth.order.openai 아래에 둡니다. 이전 레거시 Codex 인증 프로필 ID와 인증 순서를 마이그레이션하려면 openclaw doctor --fix을 실행하십시오.
2. 로컬 Codex CLI ChatGPT 로그인과 같은 앱 서버의 기존 계정입니다. 기본 격리 에이전트 홈의 경우 OpenClaw는 로그인 RPC를 통해 해당 네이티브 CLI 계정을 앱 서버에 연결합니다. CLI의 구성, Plugin 또는 스레드 저장소는 공유하지 않습니다.
3. 로컬 stdio 앱 서버 실행에만 해당하며, 앱 서버가 계정이 없다고 보고하는 경우에만 CODEX_API_KEY, 그다음 OPENAI_API_KEY을 사용합니다.

​

이미지 생성

{
  agents: {
    defaults: {
      imageGenerationModel: { primary: "openai/gpt-image-2" },
    },
  },
}

openclaw infer image generate \
  --model openai/gpt-image-1.5 \
  --output-format png \
  --background transparent \
  --prompt "투명한 배경의 단순한 빨간색 원형 스티커" \
  --json

/tool image_generate model=openai/gpt-image-2 prompt="macOS용 OpenClaw의 세련된 출시 포스터" size=3840x2160 count=1

/tool image_generate model=openai/gpt-image-1.5 prompt="투명한 배경의 단순한 빨간색 원형 스티커" outputFormat=png background=transparent

/tool image_generate model=openai/gpt-image-2 prompt="객체 모양은 유지하고 재질을 반투명 유리로 변경" image=/path/to/reference.png size=1024x1536

​

동영상 생성

{
  agents: {
    defaults: {
      videoGenerationModel: { primary: "openai/sora-2" },
    },
  },
}

​

GPT-5 프롬프트 기여

{
  agents: {
    defaults: {
      promptOverlays: {
        gpt5: { personality: "friendly" },
      },
    },
  },
}

openclaw config set agents.defaults.promptOverlays.gpt5.personality off

​

음성 및 말하기

{
  messages: {
    tts: {
      providers: {
        openai: { model: "gpt-4o-mini-tts", speakerVoice: "coral" },
      },
    },
  },
}

{
  tools: {
    media: {
      audio: {
        models: [
          {
            type: "provider",
            provider: "openai",
            model: "gpt-4o-transcribe",
          },
        ],
      },
    },
  },
}

​

Azure OpenAI 엔드포인트

• 이미 Azure OpenAI 구독, 할당량 또는 엔터프라이즈 계약이 있는 경우
• Azure에서 제공하는 지역별 데이터 상주 또는 규정 준수 제어가 필요한 경우
• 기존 Azure 테넌트 내에서 트래픽을 유지하려는 경우

​

구성

{
  models: {
    providers: {
      openai: {
        baseUrl: "https://<your-resource>.openai.azure.com",
        apiKey: "<azure-openai-api-key>",
      },
    },
  },
}

• *.openai.azure.com
• *.services.ai.azure.com
• *.cognitiveservices.azure.com

• Authorization: Bearer 대신 api-key 헤더를 전송합니다.
• 배포 범위 경로(/openai/deployments/{deployment}/...)를 사용합니다.
• 각 요청에 ?api-version=...을 추가합니다.
• Azure 이미지 생성 호출에 600초의 기본 요청 시간 제한을 사용합니다. 호출별 timeoutMs 값은 여전히 이 기본값보다 우선합니다.

​

API 버전

export AZURE_OPENAI_API_VERSION="2024-12-01-preview"

​

모델 이름은 배포 이름입니다

/tool image_generate model=openai/gpt-image-2-prod prompt="깔끔한 포스터" size=1024x1024 count=1

​

지역별 가용성

​

매개변수 차이

​

고급 구성

{
  agents: {
    defaults: {
      models: {
        "openai/gpt-5.5": {
          params: { transport: "auto" },
        },
      },
    },
  },
}

{
  agents: {
    defaults: {
      models: {
        "openai/gpt-5.5": { params: { fastMode: "auto", fastAutoOnSeconds: 30 } },
      },
    },
  },
}

{
  agents: {
    defaults: {
      models: {
        "openai/gpt-5.5": { params: { serviceTier: "priority" } },
      },
    },
  },
}

{
  agents: {
    defaults: {
      models: {
        "azure-openai-responses/gpt-5.5": {
          params: { responsesServerCompaction: true },
        },
      },
    },
  },
}

{
  agents: {
    defaults: {
      models: {
        "openai/gpt-5.5": {
          params: {
            responsesServerCompaction: true,
            responsesCompactThreshold: 120000,
          },
        },
      },
    },
  },
}

{
  agents: {
    defaults: {
      models: {
        "openai/gpt-5.5": {
          params: { responsesServerCompaction: false },
        },
      },
    },
  },
}

{
  agents: {
    defaults: {
      embeddedAgent: { executionContract: "default" },
    },
  },
}

​

관련 항목