2026년 3월 14일·Y Build Team

OpenClaw Config Edit: 완벽한 설정 및 구성 가이드 (2026)

WhatsApp, Discord, Telegram, Ollama 등을 위한 openclaw config edit 명령어를 마스터하세요. 채널, 모델, 공급자 구성 및 일반적인 OpenClaw 구성 오류 해결을 위한 단계별 가이드.

OpenClawConfigurationTutorialWhatsAppDiscordTelegramOllamaAI Assistant

요약

가장 많이 사용하는 OpenClaw 구성 명령어 빠른 참조:

bash

# 구성 편집기 열기
openclaw config edit

# 특정 값 설정
openclaw config set channels.whatsapp.enabled true
openclaw config set model.provider openai
openclaw config set model.name gpt-4o

# 현재 구성 보기
openclaw config show

# 구성 문제 검증 및 수정
openclaw doctor
openclaw doctor --fix

# 기본값으로 재설정
openclaw config reset

OpenClaw란?

OpenClaw는 대규모 언어 모델을 WhatsApp, Discord, Telegram, Slack과 같은 메시징 채널에 연결하는 오픈소스 AI 어시스턴트 프레임워크입니다. OpenAI, Anthropic, Ollama(로컬 모델), Google 등 여러 모델 공급자를 지원하며, 커스텀 스킬과 플러그인으로 확장할 수 있습니다.

OpenClaw의 핵심은 구성 시스템입니다. 활성 채널, 사용할 모델, 로드된 스킬 등 거의 모든 것이 구성 파일을 통해 제어됩니다. openclaw config edit를 마스터하는 것이 OpenClaw를 원하는 대로 실행하는 핵심입니다.

openclaw config edit: 기본 사항

구성 편집기 열기

OpenClaw를 구성하는 기본 명령어는 다음과 같습니다:

bash

openclaw config edit

이 명령어는 기본 터미널 편집기(보통 nano, vim 또는 $EDITOR에 설정된 편집기)에서 구성 파일을 엽니다. 구성 파일은 일반적으로 설치에 따라 ~/.openclaw/config.yaml 또는 ~/.config/openclaw/config.yaml에 위치합니다.

구성 파일 구조

OpenClaw 구성 파일은 YAML 형식이며 섹션별로 구성됩니다:

yaml

# 모델 구성
model:
  provider: openai        # openai, anthropic, ollama, google
  name: gpt-4o            # 모델 식별자 문자열
  temperature: 0.7
  max_tokens: 4096

# 채널 구성
channels:
  whatsapp:
    enabled: false
    phone_number_id: ""
    access_token: ""
  discord:
    enabled: false
    bot_token: ""
  telegram:
    enabled: false
    bot_token: ""
  slack:
    enabled: false
    bot_token: ""
    app_token: ""

# 스킬 및 플러그인
skills:
  - web_search
  - calculator
  - weather

# 음성-텍스트 변환
stt:
  provider: whisper
  model: whisper-1

# 시스템 프롬프트
system_prompt: "You are a helpful assistant."

개별 값 설정

전체 파일을 편집하는 대신 명령줄에서 개별 구성 값을 설정할 수 있습니다:

bash

openclaw config set model.provider anthropic
openclaw config set model.name claude-sonnet-4-6
openclaw config set model.temperature 0.5

이는 스크립팅이나 편집기를 열지 않고 빠르게 변경할 때 유용합니다.

Early Access

Be first to build with AI

Y Build is the AI-era operating system for startups. Join the waitlist and get early access.

채널 설정

WhatsApp 연동에는 Meta Business 계정과 WhatsApp Business API 접근이 필요합니다.

bash

# WhatsApp 채널 활성화
openclaw config set channels.whatsapp.enabled true
openclaw config set channels.whatsapp.phone_number_id "YOUR_PHONE_NUMBER_ID"
openclaw config set channels.whatsapp.access_token "YOUR_ACCESS_TOKEN"
openclaw config set channels.whatsapp.verify_token "YOUR_VERIFY_TOKEN"

일반적인 문제: WhatsApp에는 웹훅 URL이 필요합니다. 리버스 프록시(nginx, Caddy) 또는 터널 서비스(ngrok, Cloudflare Tunnel)를 사용하여 OpenClaw를 인터넷에 노출해야 합니다.

bash

# 웹훅 URL 설정
openclaw config set channels.whatsapp.webhook_url "https://your-domain.com/webhook/whatsapp"

Discord

Discord 설정은 더 간단합니다 — Discord Developer Portal에서 봇 토큰만 있으면 됩니다.

bash

openclaw config set channels.discord.enabled true
openclaw config set channels.discord.bot_token "YOUR_DISCORD_BOT_TOKEN"

팁: Discord 봇이 Developer Portal에서 "Message Content" 특권 인텐트가 활성화되어 있는지 확인하세요. 그렇지 않으면 메시지를 읽을 수 없습니다.

Telegram에는 @BotFather에서 받은 봇 토큰이 필요합니다:

bash

openclaw config set channels.telegram.enabled true
openclaw config set channels.telegram.bot_token "YOUR_TELEGRAM_BOT_TOKEN"

Telegram은 폴링과 웹훅 모드를 모두 지원합니다. 폴링은 개발 시 더 쉽습니다(공개 URL 불필요):

bash

openclaw config set channels.telegram.mode polling

프로덕션에서는 웹훅 모드를 사용하세요:

bash

openclaw config set channels.telegram.mode webhook
openclaw config set channels.telegram.webhook_url "https://your-domain.com/webhook/telegram"

Slack

Slack 연동은 Socket Mode(권장) 또는 Events API를 사용합니다:

bash

openclaw config set channels.slack.enabled true
openclaw config set channels.slack.bot_token "xoxb-YOUR-BOT-TOKEN"
openclaw config set channels.slack.app_token "xapp-YOUR-APP-TOKEN"

Socket Mode는 공개 URL이 필요 없으므로 권장됩니다.

모델 공급자 구성

OpenAI

bash

openclaw config set model.provider openai
openclaw config set model.name gpt-4o

API 키는 환경 변수로 설정하세요(구성 파일에 넣지 마세요):

bash

export OPENAI_API_KEY="sk-..."

Anthropic (Claude)

bash

openclaw config set model.provider anthropic
openclaw config set model.name claude-sonnet-4-6

bash

export ANTHROPIC_API_KEY="sk-ant-..."

Ollama (로컬 모델)

이것은 개인정보를 중시하는 사용자에게 OpenClaw가 빛나는 부분입니다. Ollama는 API 키나 데이터 유출 없이 로컬에서 모델을 실행할 수 있게 합니다.

bash

# 먼저 Ollama 설치
# https://ollama.ai

# 모델 다운로드
ollama pull llama3.3

# Ollama를 사용하도록 OpenClaw 구성
openclaw config set model.provider ollama
openclaw config set model.name llama3.3
openclaw config set model.base_url "http://localhost:11434"

일반적인 문제: OpenClaw가 Ollama에 연결할 수 없다면, Ollama가 실행 중인지(ollama serve) 확인하고 기본 URL이 일치하는지 확인하세요. 기본 Ollama 포트는 11434입니다.

Google (Gemini)

bash

openclaw config set model.provider google
openclaw config set model.name gemini-2.5-pro

bash

export GOOGLE_API_KEY="..."

xAI (Grok)

bash

openclaw config set model.provider openai   # xAI는 OpenAI 호환 API를 사용
openclaw config set model.name grok-4.1
openclaw config set model.base_url "https://api.x.ai/v1"

bash

export OPENAI_API_KEY="xai-..."   # OpenAI 공급자에 xAI 키 사용

일반적인 구성 오류 및 해결 방법

오류: "Unknown config key"

Error: Unknown config key 'chanels.whatsapp.enabled'

보통 구성 키에 오타가 있을 때 발생합니다. 철자를 확인하세요. 흔한 실수:

chanels → channels

providr → provider

telgram → telegram

openclaw config show를 실행하여 모든 유효한 키를 확인하세요.

오류: "Channel auto-enabled without credentials"

일부 OpenClaw 버전은 자격 증명을 설정하면 명시적으로 활성화하지 않아도 채널을 자동 활성화합니다. 이로 인해 자격 증명이 불완전할 경우 시작 실패가 발생할 수 있습니다.

해결:

bash

# 사용하지 않는 채널을 명시적으로 비활성화
openclaw config set channels.whatsapp.enabled false
openclaw config set channels.discord.enabled false
openclaw config set channels.slack.enabled false

오류: "Model provider not configured"

Error: Model provider 'anthropic' requires ANTHROPIC_API_KEY

해당 환경 변수를 설정해야 합니다. OpenClaw는 보안상의 이유로 의도적으로 API 키를 구성 파일에 저장하지 않습니다.

해결: 셸 프로필(~/.bashrc, ~/.zshrc)에 API 키를 추가하거나 .env 파일을 사용하세요:

bash

echo 'export ANTHROPIC_API_KEY="sk-ant-..."' >> ~/.zshrc
source ~/.zshrc

openclaw doctor 사용

openclaw doctor 명령어는 전체 구성을 검증하고 문제를 보고합니다:

bash

openclaw doctor

출력 예시:

Checking configuration...
  ✓ Config file found
  ✓ Model provider configured
  ✗ WhatsApp: enabled but missing access_token
  ✗ Discord: bot token invalid format
  ✓ Telegram: configured correctly
  ✓ Ollama: connection successful

2 issues found. Run 'openclaw doctor --fix' to attempt auto-fix.

--fix 플래그는 문제를 자동으로 해결하려고 시도합니다:

bash

openclaw doctor --fix

이 명령은 자격 증명이 누락된 채널을 비활성화하고, 알려진 형식 문제를 수정하며, 자동으로 해결할 수 없는 문제에 대해 수동 수정을 제안합니다.

고급 구성

커스텀 스킬

OpenClaw는 어시스턴트의 기능을 확장하는 커스텀 스킬(플러그인)을 지원합니다:

yaml

skills:
  - web_search
  - calculator
  - weather
  - custom_skill:
      path: ./my-skills/custom_tool.py
      config:
        api_key_env: CUSTOM_API_KEY

또는 명령줄로:

bash

openclaw skills add web_search
openclaw skills add ./my-skills/custom_tool.py
openclaw skills list
openclaw skills remove calculator

음성-텍스트 변환(STT) 구성

WhatsApp과 Telegram에서의 음성 메시지 지원:

yaml

stt:
  provider: whisper          # whisper, deepgram, google
  model: whisper-1
  language: auto             # 자동 감지 또는 "en", "es" 등 지정

bash

openclaw config set stt.provider whisper
openclaw config set stt.model whisper-1

Tuya 스마트 홈 연동

OpenClaw는 Tuya 호환 스마트 홈 기기를 제어할 수 있습니다:

yaml

tuya:
  enabled: true
  access_id: "YOUR_TUYA_ACCESS_ID"
  access_key: "YOUR_TUYA_ACCESS_KEY"
  endpoint: "https://openapi.tuyaus.com"

이를 통해 연결된 모든 채널에서 자연어 명령으로 조명, 스위치, 온도 조절기 및 기타 Tuya 기기를 제어할 수 있습니다.

다중 모델 구성

모델 프리셋을 정의하고 전환할 수 있습니다:

yaml

models:
  default:
    provider: openai
    name: gpt-4o
  fast:
    provider: ollama
    name: llama3.3
  reasoning:
    provider: anthropic
    name: claude-opus-4-6

bash

openclaw config set model.active default
# 또는 런타임에 전환
openclaw --model fast

자주 묻는 질문

OpenClaw 구성 파일은 어디에 저장되나요?

기본 위치는 ~/.openclaw/config.yaml입니다. 일부 설치에서는 ~/.config/openclaw/config.yaml에 있을 수 있습니다. openclaw config show --path를 실행하여 정확한 위치를 확인하세요.

클라우드 API 없이 OpenClaw를 사용할 수 있나요?

네. Ollama를 모델 공급자로 구성하고 Telegram을 폴링 모드로 사용하세요. 이렇게 하면 데이터가 외부로 나가지 않는 완전히 로컬이고 프라이빗한 AI 어시스턴트를 사용할 수 있습니다.

OpenClaw를 어떻게 업데이트하나요?

bash

pip install --upgrade openclaw
# 또는
npm update -g openclaw

업데이트 후 openclaw doctor를 실행하여 구성 형식 변경 사항을 확인하세요.

여러 채널을 동시에 실행할 수 있나요?

네. 원하는 만큼 채널을 활성화하세요 — OpenClaw가 동시에 처리합니다. 각 채널은 동일한 모델과 스킬 구성을 공유합니다.

구성을 기본값으로 어떻게 재설정하나요?

bash

openclaw config reset

이 명령은 구성 파일을 기본 템플릿으로 덮어씁니다. 필요한 경우 기존 구성을 먼저 백업하세요.

더 간단한 것을 원하시나요?

OpenClaw는 강력하지만 터미널에 익숙해야 하고 수동 구성이 필요합니다. 구성 파일, 모델 공급자, 채널 연동을 직접 관리하지 않고 AI 기반 제품을 만들고 출시하고 싶다면:

Y Build 가 전체 스택을 처리합니다 — 배포, 제품 영상, AI SEO, 분석. 구성 파일 없이. 터미널 없이. 그냥 만들고 출시하세요. 무료로 시작하기 →

출처:

Early Access

Be first to build with AI

Y Build is the AI-era operating system for startups. Join the waitlist and get early access.

블로그로 돌아가기

2026년 3월 14일·Y Build Team

OpenClaw Config Edit: 완벽한 설정 및 구성 가이드 (2026)

OpenClawConfigurationTutorialWhatsAppDiscordTelegramOllamaAI Assistant

요약

가장 많이 사용하는 OpenClaw 구성 명령어 빠른 참조:

bash

# 구성 편집기 열기
openclaw config edit

# 특정 값 설정
openclaw config set channels.whatsapp.enabled true
openclaw config set model.provider openai
openclaw config set model.name gpt-4o

# 현재 구성 보기
openclaw config show

# 구성 문제 검증 및 수정
openclaw doctor
openclaw doctor --fix

# 기본값으로 재설정
openclaw config reset

OpenClaw란?

openclaw config edit: 기본 사항

구성 편집기 열기

OpenClaw를 구성하는 기본 명령어는 다음과 같습니다:

bash

openclaw config edit

구성 파일 구조

OpenClaw 구성 파일은 YAML 형식이며 섹션별로 구성됩니다:

yaml

# 모델 구성
model:
  provider: openai        # openai, anthropic, ollama, google
  name: gpt-4o            # 모델 식별자 문자열
  temperature: 0.7
  max_tokens: 4096

# 채널 구성
channels:
  whatsapp:
    enabled: false
    phone_number_id: ""
    access_token: ""
  discord:
    enabled: false
    bot_token: ""
  telegram:
    enabled: false
    bot_token: ""
  slack:
    enabled: false
    bot_token: ""
    app_token: ""

# 스킬 및 플러그인
skills:
  - web_search
  - calculator
  - weather

# 음성-텍스트 변환
stt:
  provider: whisper
  model: whisper-1

# 시스템 프롬프트
system_prompt: "You are a helpful assistant."

개별 값 설정

전체 파일을 편집하는 대신 명령줄에서 개별 구성 값을 설정할 수 있습니다:

bash

openclaw config set model.provider anthropic
openclaw config set model.name claude-sonnet-4-6
openclaw config set model.temperature 0.5

이는 스크립팅이나 편집기를 열지 않고 빠르게 변경할 때 유용합니다.

Early Access

Be first to build with AI

Y Build is the AI-era operating system for startups. Join the waitlist and get early access.

채널 설정

WhatsApp 연동에는 Meta Business 계정과 WhatsApp Business API 접근이 필요합니다.

bash

# WhatsApp 채널 활성화
openclaw config set channels.whatsapp.enabled true
openclaw config set channels.whatsapp.phone_number_id "YOUR_PHONE_NUMBER_ID"
openclaw config set channels.whatsapp.access_token "YOUR_ACCESS_TOKEN"
openclaw config set channels.whatsapp.verify_token "YOUR_VERIFY_TOKEN"

bash

# 웹훅 URL 설정
openclaw config set channels.whatsapp.webhook_url "https://your-domain.com/webhook/whatsapp"

Discord

Discord 설정은 더 간단합니다 — Discord Developer Portal에서 봇 토큰만 있으면 됩니다.

bash

openclaw config set channels.discord.enabled true
openclaw config set channels.discord.bot_token "YOUR_DISCORD_BOT_TOKEN"

팁: Discord 봇이 Developer Portal에서 "Message Content" 특권 인텐트가 활성화되어 있는지 확인하세요. 그렇지 않으면 메시지를 읽을 수 없습니다.

Telegram에는 @BotFather에서 받은 봇 토큰이 필요합니다:

bash

openclaw config set channels.telegram.enabled true
openclaw config set channels.telegram.bot_token "YOUR_TELEGRAM_BOT_TOKEN"

Telegram은 폴링과 웹훅 모드를 모두 지원합니다. 폴링은 개발 시 더 쉽습니다(공개 URL 불필요):

bash

openclaw config set channels.telegram.mode polling

프로덕션에서는 웹훅 모드를 사용하세요:

bash

openclaw config set channels.telegram.mode webhook
openclaw config set channels.telegram.webhook_url "https://your-domain.com/webhook/telegram"

Slack

Slack 연동은 Socket Mode(권장) 또는 Events API를 사용합니다:

bash

openclaw config set channels.slack.enabled true
openclaw config set channels.slack.bot_token "xoxb-YOUR-BOT-TOKEN"
openclaw config set channels.slack.app_token "xapp-YOUR-APP-TOKEN"

Socket Mode는 공개 URL이 필요 없으므로 권장됩니다.

모델 공급자 구성

OpenAI

bash

openclaw config set model.provider openai
openclaw config set model.name gpt-4o

API 키는 환경 변수로 설정하세요(구성 파일에 넣지 마세요):

bash

export OPENAI_API_KEY="sk-..."

Anthropic (Claude)

bash

openclaw config set model.provider anthropic
openclaw config set model.name claude-sonnet-4-6

bash

export ANTHROPIC_API_KEY="sk-ant-..."

Ollama (로컬 모델)

이것은 개인정보를 중시하는 사용자에게 OpenClaw가 빛나는 부분입니다. Ollama는 API 키나 데이터 유출 없이 로컬에서 모델을 실행할 수 있게 합니다.

bash

# 먼저 Ollama 설치
# https://ollama.ai

# 모델 다운로드
ollama pull llama3.3

# Ollama를 사용하도록 OpenClaw 구성
openclaw config set model.provider ollama
openclaw config set model.name llama3.3
openclaw config set model.base_url "http://localhost:11434"

Google (Gemini)

bash

openclaw config set model.provider google
openclaw config set model.name gemini-2.5-pro

bash

export GOOGLE_API_KEY="..."

xAI (Grok)

bash

openclaw config set model.provider openai   # xAI는 OpenAI 호환 API를 사용
openclaw config set model.name grok-4.1
openclaw config set model.base_url "https://api.x.ai/v1"

bash

export OPENAI_API_KEY="xai-..."   # OpenAI 공급자에 xAI 키 사용

일반적인 구성 오류 및 해결 방법

오류: "Unknown config key"

Error: Unknown config key 'chanels.whatsapp.enabled'

보통 구성 키에 오타가 있을 때 발생합니다. 철자를 확인하세요. 흔한 실수:

chanels → channels

providr → provider

telgram → telegram

openclaw config show를 실행하여 모든 유효한 키를 확인하세요.

오류: "Channel auto-enabled without credentials"

해결:

bash

# 사용하지 않는 채널을 명시적으로 비활성화
openclaw config set channels.whatsapp.enabled false
openclaw config set channels.discord.enabled false
openclaw config set channels.slack.enabled false

오류: "Model provider not configured"

Error: Model provider 'anthropic' requires ANTHROPIC_API_KEY

해당 환경 변수를 설정해야 합니다. OpenClaw는 보안상의 이유로 의도적으로 API 키를 구성 파일에 저장하지 않습니다.

해결: 셸 프로필(~/.bashrc, ~/.zshrc)에 API 키를 추가하거나 .env 파일을 사용하세요:

bash

echo 'export ANTHROPIC_API_KEY="sk-ant-..."' >> ~/.zshrc
source ~/.zshrc

openclaw doctor 사용

openclaw doctor 명령어는 전체 구성을 검증하고 문제를 보고합니다:

bash

openclaw doctor

출력 예시:

Checking configuration...
  ✓ Config file found
  ✓ Model provider configured
  ✗ WhatsApp: enabled but missing access_token
  ✗ Discord: bot token invalid format
  ✓ Telegram: configured correctly
  ✓ Ollama: connection successful

2 issues found. Run 'openclaw doctor --fix' to attempt auto-fix.

--fix 플래그는 문제를 자동으로 해결하려고 시도합니다:

bash

openclaw doctor --fix

이 명령은 자격 증명이 누락된 채널을 비활성화하고, 알려진 형식 문제를 수정하며, 자동으로 해결할 수 없는 문제에 대해 수동 수정을 제안합니다.

고급 구성

커스텀 스킬

OpenClaw는 어시스턴트의 기능을 확장하는 커스텀 스킬(플러그인)을 지원합니다:

yaml

skills:
  - web_search
  - calculator
  - weather
  - custom_skill:
      path: ./my-skills/custom_tool.py
      config:
        api_key_env: CUSTOM_API_KEY

또는 명령줄로:

bash

openclaw skills add web_search
openclaw skills add ./my-skills/custom_tool.py
openclaw skills list
openclaw skills remove calculator

음성-텍스트 변환(STT) 구성

WhatsApp과 Telegram에서의 음성 메시지 지원:

yaml

stt:
  provider: whisper          # whisper, deepgram, google
  model: whisper-1
  language: auto             # 자동 감지 또는 "en", "es" 등 지정

bash

openclaw config set stt.provider whisper
openclaw config set stt.model whisper-1

Tuya 스마트 홈 연동

OpenClaw는 Tuya 호환 스마트 홈 기기를 제어할 수 있습니다:

yaml

tuya:
  enabled: true
  access_id: "YOUR_TUYA_ACCESS_ID"
  access_key: "YOUR_TUYA_ACCESS_KEY"
  endpoint: "https://openapi.tuyaus.com"

이를 통해 연결된 모든 채널에서 자연어 명령으로 조명, 스위치, 온도 조절기 및 기타 Tuya 기기를 제어할 수 있습니다.

다중 모델 구성

모델 프리셋을 정의하고 전환할 수 있습니다:

yaml

models:
  default:
    provider: openai
    name: gpt-4o
  fast:
    provider: ollama
    name: llama3.3
  reasoning:
    provider: anthropic
    name: claude-opus-4-6

bash

openclaw config set model.active default
# 또는 런타임에 전환
openclaw --model fast

자주 묻는 질문

OpenClaw 구성 파일은 어디에 저장되나요?

클라우드 API 없이 OpenClaw를 사용할 수 있나요?

OpenClaw를 어떻게 업데이트하나요?

bash

pip install --upgrade openclaw
# 또는
npm update -g openclaw

업데이트 후 openclaw doctor를 실행하여 구성 형식 변경 사항을 확인하세요.

여러 채널을 동시에 실행할 수 있나요?

네. 원하는 만큼 채널을 활성화하세요 — OpenClaw가 동시에 처리합니다. 각 채널은 동일한 모델과 스킬 구성을 공유합니다.

구성을 기본값으로 어떻게 재설정하나요?

bash

openclaw config reset

이 명령은 구성 파일을 기본 템플릿으로 덮어씁니다. 필요한 경우 기존 구성을 먼저 백업하세요.

더 간단한 것을 원하시나요?

Y Build 가 전체 스택을 처리합니다 — 배포, 제품 영상, AI SEO, 분석. 구성 파일 없이. 터미널 없이. 그냥 만들고 출시하세요. 무료로 시작하기 →

출처:

Early Access

Be first to build with AI

Y Build is the AI-era operating system for startups. Join the waitlist and get early access.