openclaw configure

기존 설정의 자격 증명, 기기, 에이전트 기본값, Gateway, 채널, Plugin, Skills, 상태 확인을 대상으로 변경하는 대화형 프롬프트입니다.

전체 안내형 최초 실행 과정에는 openclaw onboard 또는 openclaw setup을 사용하고, 기준 구성/워크스페이스만 필요하면 openclaw setup --baseline을 사용하며, 채널 계정 설정만 필요하면 openclaw channels add를 사용하세요.

configure가 공급자 인증 선택에서 시작되면 기본 모델 및 허용 목록 선택기는 해당 공급자를 자동으로 우선합니다. Volcengine과 BytePlus 같은 쌍을 이루는 공급자의 경우 동일한 우선 설정이 코딩 계획 변형(volcengine-plan/*, byteplus-plan/*)에도 일치합니다. 선호 공급자 필터로 인해 빈 목록이 생성될 경우 configure는 빈 선택기를 표시하는 대신 필터링되지 않은 카탈로그로 대체합니다.

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

• Grok은 동일한 xAI OAuth 프로필 또는 API 키로 선택적 x_search 설정을 제공하고 x_search 모델을 선택하게 할 수 있습니다.
• Kimi는 Moonshot API 리전(api.moonshot.ai와 api.moonshot.cn 중 하나)과 기본 Kimi 웹 검색 모델을 요청할 수 있습니다.

관련 항목:

• Gateway 구성 참조: 구성
• 구성 CLI: 구성

옵션

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

사용 가능한 섹션:

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

참고:

• 전체 마법사와 Gateway 관련 섹션은 Gateway가 실행되는 위치를 묻고 gateway.mode를 업데이트합니다. gateway, daemon, health를 포함하지 않는 섹션 필터는 요청한 설정으로 바로 이동합니다.
• 로컬 구성 쓰기 후, configure는 선택한 설정 경로에 필요한 경우 선택된 다운로드 가능한 Plugin을 설치합니다. 원격 Gateway 구성은 로컬 Plugin 패키지를 설치하지 않습니다.
• 채널 지향 서비스(Slack/Discord/Matrix/Microsoft Teams)는 설정 중 채널/룸 허용 목록을 묻습니다. 이름이나 ID를 입력할 수 있으며, 마법사는 가능하면 이름을 ID로 확인합니다.
• 데몬 설치 단계를 실행하고 토큰 인증에 토큰이 필요하며 gateway.auth.token이 SecretRef로 관리되는 경우, configure는 SecretRef를 검증하지만 확인된 일반 텍스트 토큰 값을 supervisor 서비스 환경 메타데이터에 저장하지 않습니다.
• 토큰 인증에 토큰이 필요하고 구성된 토큰 SecretRef를 확인할 수 없는 경우, configure는 실행 가능한 해결 안내와 함께 데몬 설치를 차단합니다.
• gateway.auth.token과 gateway.auth.password가 모두 구성되어 있고 gateway.auth.mode가 설정되지 않은 경우, configure는 모드가 명시적으로 설정될 때까지 데몬 설치를 차단합니다.

예시

openclaw configureopenclaw configure --section webopenclaw configure --section model --section channelsopenclaw configure --section gateway --section daemon

관련 항목

• CLI 참조
• 구성