OpenClaw 설정 편집: 전체 설정 가이드 (2026)

Q: OpenClaw 설정 파일은 어디에 저장되나요?

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

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

```bash pip install --upgrade openclaw

Q: 설정을 기본값으로 어떻게 초기화하나요?

```bash openclaw config reset ```

요약 (TL;DR)

가장 일반적인 OpenClaw 설정 명령어에 대한 빠른 참조:

bash

# Open the config editor
openclaw config edit

# Set a specific value
openclaw config set channels.whatsapp.enabled true
openclaw config set model.provider openai
openclaw config set model.name gpt-4o

# View current config
openclaw config show

# Validate and fix config issues
openclaw doctor
openclaw doctor --fix

# Reset to defaults
openclaw config reset

OpenClaw란 무엇인가요?

OpenClaw는 대규모 언어 모델(LLM)을 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 configuration
model:
  provider: openai        # openai, anthropic, ollama, google
  name: gpt-4o            # model identifier string
  temperature: 0.7
  max_tokens: 4096

# Channel configuration
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 and plugins
skills:
  - web_search
  - calculator
  - weather

# Speech-to-text
stt:
  provider: whisper
  model: whisper-1

# System prompt
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

이 방법은 스크립트를 작성하거나 편집기를 열지 않고 빠르게 변경할 때 유용합니다.

채널 설정하기

WhatsApp 연동을 위해서는 Meta Business 계정과 WhatsApp Business API 액세스 권한이 필요합니다.

bash

# Enable WhatsApp channel
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은 웹훅(webhook) URL이 필요합니다. 역방향 프록시(nginx, Caddy) 또는 터널 서비스(ngrok, Cloudflare Tunnel)를 사용하여 OpenClaw를 인터넷에 노출해야 합니다.

bash

# Set the webhook URL
openclaw config set channels.whatsapp.webhook_url "https://your-domain.com/webhook/whatsapp"

Discord

Discord 설정은 더 간단합니다. Discord 개발자 포털에서 봇 토큰만 있으면 됩니다.

bash

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

팁: Discord 봇이 메시지를 읽을 수 있도록 개발자 포털에서 "Message Content" 특권 인텐트(privileged intent)를 활성화했는지 확인하세요.

Telegram은 @BotFather로부터 받은 봇 토큰이 필요합니다:

bash

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

Telegram은 폴링(polling)과 웹훅 모드를 모두 지원합니다. 폴링은 개발 시 더 간편합니다(공용 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"

소켓 모드는 공용 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

# Install Ollama first
# https://ollama.ai

# Pull a model
ollama pull llama3.3

# Configure OpenClaw to use Ollama
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 uses OpenAI-compatible 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-..."   # Use xAI key with OpenAI provider

일반적인 설정 오류 및 해결 방법

오류: "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

# Explicitly disable channels you're not using
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             # auto-detect or specify "en", "es", etc.

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

자주 묻는 질문 (FAQ)

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 및 분석을 포함한 전체 스택을 처리합니다. 설정 파일도, 터미널도 필요 없습니다. 그저 만들고 출시하세요. 무료로 시작하기 →

출처:

요약 (TL;DR)

가장 일반적인 OpenClaw 설정 명령어에 대한 빠른 참조:

bash

# Open the config editor
openclaw config edit

# Set a specific value
openclaw config set channels.whatsapp.enabled true
openclaw config set model.provider openai
openclaw config set model.name gpt-4o

# View current config
openclaw config show

# Validate and fix config issues
openclaw doctor
openclaw doctor --fix

# Reset to defaults
openclaw config reset

OpenClaw란 무엇인가요?

openclaw config edit: 기본 사항

설정 편집기 열기

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

bash

openclaw config edit

설정 파일 구조

OpenClaw 설정 파일은 YAML 형식이며 다음과 같은 섹션으로 구성됩니다:

yaml

# Model configuration
model:
  provider: openai        # openai, anthropic, ollama, google
  name: gpt-4o            # model identifier string
  temperature: 0.7
  max_tokens: 4096

# Channel configuration
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 and plugins
skills:
  - web_search
  - calculator
  - weather

# Speech-to-text
stt:
  provider: whisper
  model: whisper-1

# System prompt
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

이 방법은 스크립트를 작성하거나 편집기를 열지 않고 빠르게 변경할 때 유용합니다.

채널 설정하기

WhatsApp 연동을 위해서는 Meta Business 계정과 WhatsApp Business API 액세스 권한이 필요합니다.

bash

# Enable WhatsApp channel
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

# Set the webhook URL
openclaw config set channels.whatsapp.webhook_url "https://your-domain.com/webhook/whatsapp"

Discord

Discord 설정은 더 간단합니다. Discord 개발자 포털에서 봇 토큰만 있으면 됩니다.

bash

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

팁: Discord 봇이 메시지를 읽을 수 있도록 개발자 포털에서 "Message Content" 특권 인텐트(privileged intent)를 활성화했는지 확인하세요.

Telegram은 @BotFather로부터 받은 봇 토큰이 필요합니다:

bash

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

Telegram은 폴링(polling)과 웹훅 모드를 모두 지원합니다. 폴링은 개발 시 더 간편합니다(공용 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"

소켓 모드는 공용 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 (로컬 모델)

bash

# Install Ollama first
# https://ollama.ai

# Pull a model
ollama pull llama3.3

# Configure OpenClaw to use Ollama
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 uses OpenAI-compatible 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-..."   # Use xAI key with OpenAI provider

일반적인 설정 오류 및 해결 방법

오류: "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

# Explicitly disable channels you're not using
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             # auto-detect or specify "en", "es", etc.

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

자주 묻는 질문 (FAQ)

OpenClaw 설정 파일은 어디에 저장되나요?

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

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

bash

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

업데이트 후에는 openclaw doctor를 실행하여 설정 형식에 변경 사항이 있는지 확인하세요.

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

네. 원하는 만큼 채널을 활성화할 수 있습니다. OpenClaw는 이들을 동시에 처리합니다. 각 채널은 동일한 모델 및 스킬 설정을 공유합니다.

설정을 기본값으로 어떻게 초기화하나요?

bash

openclaw config reset

이 명령어는 설정 파일을 기본 템플릿으로 덮어씁니다. 필요한 경우 기존 설정을 먼저 백업해 두세요.

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

출처: