CLI commands

구성

openclaw configure

자격 증명, 기기, 에이전트 기본값을 설정하는 대화형 프롬프트입니다.

configure가 제공자 인증 선택에서 시작되면 기본 모델 및 허용 목록 선택기는 해당 제공자를 자동으로 우선합니다. Volcengine 및 BytePlus처럼 쌍을 이루는 제공자의 경우 동일한 우선순위가 해당 coding-plan 변형(volcengine-plan/*, byteplus-plan/*)에도 일치합니다. 선호 제공자 필터가 빈 목록을 만들 경우 configure는 빈 선택기를 표시하지 않고 필터링되지 않은 카탈로그로 대체합니다.

웹 검색의 경우 openclaw configure --section web을 사용하면 제공자를 선택하고 해당 자격 증명을 설정할 수 있습니다. 일부 제공자는 제공자별 후속 프롬프트도 표시합니다.

  • Grok은 동일한 XAI_API_KEY로 선택적 x_search 설정을 제공하고 x_search 모델을 선택하게 할 수 있습니다.
  • Kimi는 Moonshot API 리전(api.moonshot.aiapi.moonshot.cn) 및 기본 Kimi 웹 검색 모델을 물어볼 수 있습니다.

관련 항목:

옵션

  • --section <section>: 반복 가능한 섹션 필터

사용 가능한 섹션:

  • workspace
  • model
  • web
  • gateway
  • daemon
  • channels
  • plugins
  • skills
  • health

참고:

  • Gateway가 실행되는 위치를 선택하면 항상 gateway.mode가 업데이트됩니다. 이것만 필요하다면 다른 섹션 없이 "계속"을 선택할 수 있습니다.
  • 로컬 설정 쓰기 후, configure는 선택한 설정 경로에 필요한 경우 선택된 다운로드 가능한 Plugin을 설치합니다. 원격 Gateway 설정은 로컬 Plugin 패키지를 설치하지 않습니다.
  • 채널 중심 서비스(Slack/Discord/Matrix/Microsoft Teams)는 설정 중 채널/룸 허용 목록을 묻습니다. 이름 또는 ID를 입력할 수 있으며, 가능한 경우 마법사가 이름을 ID로 해석합니다.
  • daemon 설치 단계를 실행할 때 토큰 인증에 토큰이 필요하고 gateway.auth.token이 SecretRef로 관리되는 경우, configure는 SecretRef를 검증하지만 해석된 평문 토큰 값을 supervisor 서비스 환경 메타데이터에 저장하지 않습니다.
  • 토큰 인증에 토큰이 필요하고 설정된 토큰 SecretRef가 해석되지 않으면, configure는 실행 가능한 해결 지침과 함께 daemon 설치를 차단합니다.
  • gateway.auth.tokengateway.auth.password가 모두 설정되어 있고 gateway.auth.mode가 설정되지 않은 경우, configure는 모드가 명시적으로 설정될 때까지 daemon 설치를 차단합니다.

예시

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

관련 항목