메인 콘텐츠로 건너뛰기

​
openclaw configure

자격 증명, 장치, 기본 에이전트 설정을 위한 대화형 프롬프트입니다. 참고: Model 섹션에는 이제 agents.defaults.models allowlist(/model과 모델 선택기에 표시되는 항목)에 대한 다중 선택이 포함됩니다. 구성이 provider 인증 선택에서 시작되면 기본 모델 및 allowlist 선택기는 해당 provider를 자동으로 우선합니다. Volcengine/BytePlus 같은 페어링된 provider의 경우, 동일한 우선순위는 해당 coding-plan 변형(volcengine-plan/*, byteplus-plan/*)에도 일치합니다. preferred-provider 필터로 인해 빈 목록이 생성될 경우, configure는 빈 선택기를 표시하는 대신 필터링되지 않은 카탈로그로 대체합니다. 팁: 하위 명령 없이 openclaw config를 실행하면 같은 마법사가 열립니다. 비대화형 편집에는 openclaw config get|set|unset을 사용하세요. 웹 검색의 경우 openclaw configure --section web을 사용하면 provider를 선택하고 그 자격 증명을 구성할 수 있습니다. 일부 provider는 provider별 후속 프롬프트도 표시합니다.
  • Grok는 동일한 XAI_API_KEY를 사용하는 선택적 x_search 설정을 제공할 수 있으며 x_search 모델을 선택하도록 할 수 있습니다.
  • Kimi는 Moonshot API 리전(api.moonshot.ai vs api.moonshot.cn)과 기본 Kimi 웹 검색 모델을 물을 수 있습니다.
관련 항목:

​
옵션

  • --section <section>: 반복 가능한 섹션 필터
사용 가능한 섹션:
  • workspace
  • model
  • web
  • gateway
  • daemon
  • channels
  • plugins
  • skills
  • health
참고:
  • Gateway가 실행되는 위치를 선택하면 항상 gateway.mode가 업데이트됩니다. 그것만 필요하다면 다른 섹션 없이 “Continue”를 선택할 수 있습니다.
  • 채널 지향 서비스(Slack/Discord/Matrix/Microsoft Teams)는 설정 중 채널/룸 allowlist를 묻습니다. 이름 또는 ID를 입력할 수 있으며, 가능하면 마법사가 이름을 ID로 해석합니다.
  • daemon 설치 단계를 실행하는 경우, 토큰 인증에는 토큰이 필요하고 gateway.auth.token이 SecretRef로 관리되면, configure는 SecretRef를 검증하지만 해석된 일반 텍스트 토큰 값을 supervisor 서비스 환경 메타데이터에 유지하지 않습니다.
  • 토큰 인증에 토큰이 필요하고 구성된 토큰 SecretRef가 해석되지 않으면, configure는 실행 가능한 해결 지침과 함께 daemon 설치를 차단합니다.
  • gateway.auth.token과 gateway.auth.password가 모두 구성되어 있고 gateway.auth.mode가 설정되지 않은 경우, configure는 mode가 명시적으로 설정될 때까지 daemon 설치를 차단합니다.

​
예시

openclaw configure
openclaw configure --section web
openclaw configure --section model --section channels
openclaw configure --section gateway --section daemon