openclaw configure로 개발 환경 설정하기

새로운 도구를 프로젝트에 도입할 때 가장 번거로운 단계가 바로 초기 설정입니다. 설정 파일을 직접 열어서 API 키를 입력하고, 모델 옵션을 하나하나 형식을 맞춰 작성하다 보면 예상치 못한 오타나 에러를 마주하기 마련이죠.

이런 반복적이고 실수가 잦은 작업을 줄이려면 대화형 CLI 도구를 활용하는 것이 가장 좋습니다. openclaw configure를 사용하면 복잡한 설정 과정을 단계별 안내에 따라 손쉽게 마칠 수 있어요.

필요한 것

시작하기 전에 아래 항목들이 준비되었는지 확인해 주세요.

• OpenClaw CLI 설치 완료
• 연결할 서비스의 API 자격 증명 및 장치 정보
• Gateway 설정 참조 문서 (필요 시)
• Config CLI 문서 (필요 시)

빠른 시작

5분 안에 설정을 마치는 가장 빠른 방법입니다. 터미널을 열고 아래 과정을 따라오세요.

1. 설정 위저드 실행하기

가장 기본적인 명령어는 openclaw configure입니다. 이 명령어를 입력하면 자격 증명, 장치, Agent 기본값을 설정할 수 있는 인터랙티브 프롬프트가 시작됩니다.

openclaw configure

openclaw config를 입력해도 동일한 위저드가 실행되니 편한 방식을 선택하세요.

2. 특정 섹션만 지정해서 설정하기

모든 단계를 거칠 필요 없이 특정 부분만 수정하고 싶다면 --section 플래그를 사용하면 됩니다. 예를 들어 모델 리스트와 채널 설정만 업데이트하고 싶을 때는 다음과 같이 입력하세요.

openclaw configure --section models --section channels

3. 주요 설정 포인트

• Model 선택: agents.defaults.models 허용 리스트를 멀티 셀렉트로 선택할 수 있습니다. 여기서 선택한 모델들이 /model 명령어와 모델 피커에 나타납니다.
• Gateway 모드: Gateway가 실행될 위치를 선택하면 gateway.mode가 자동으로 업데이트됩니다. 다른 설정 없이 이 부분만 수정하고 싶다면 “Continue”를 선택해 빠르게 마칠 수 있어요.

문제 해결

설정 과정에서 발생할 수 있는 상황과 해결 방법입니다.

• 채널/룸 식별 문제: Slack, Discord, Matrix, Microsoft Teams 같은 채널 기반 서비스를 설정할 때 이름이나 ID를 입력하게 됩니다. 위저드는 가능한 경우 이름을 ID로 자동 변환하여 해결해 주지만, 정확한 연결을 위해 가급적 고유 ID를 사용하는 것이 좋습니다.
• 비대화형 편집: 인터랙티브 위저드 대신 직접 값을 수정하고 싶다면 openclaw config get|set|unset 명령어를 사용해 보세요.

설정 과정에서 막히는 부분이 있다면 AI Setup Assistant에게 바로 물어보세요!

다음 단계

• Gateway configuration reference
• Config CLI