환경 변수 참조
OpenClaw에서 사용할 수 있는 모든 환경 변수를 빠르게 찾아보세요.
개요
환경 변수 사용법
# 셸 설정 파일 (~/.bashrc, ~/.zshrc, etc.)
export OPENCLAW_VAR_NAME="value"
# 또는 명령행에서 직접
OPENCLAW_VAR_NAME="value" openclaw gateway
우선 순위
- 환경 변수 (가장 높음)
- 설정 파일 (
~/.openclaw/openclaw.json) - 기본값 (가장 낮음)
주요 환경 변수
연결 설정
OPENCLAW_API_KEY
OpenClaw API 인증 키
| 항목 | 값 |
|---|---|
| 필수 여부 | 선택 (일부 배포에서 필수) |
| 기본값 | 없음 |
| 예시 | sk-... |
export OPENCLAW_API_KEY="sk-your-api-key"
OPENCLAW_URL
OpenClaw 게이트웨이 URL
| 항목 | 값 |
|---|---|
| 필수 여부 | 아니오 |
| 기본값 | http://localhost:3000 |
| 예시 | https://gateway.example.com |
export OPENCLAW_URL="https://gateway.example.com"
워크스페이스
OPENCLAW_WORKSPACE
OpenClaw 워크스페이스 경로
| 항목 | 값 |
|---|---|
| 필수 여부 | 아니오 |
| 기본값 | ~/.openclaw/workspace |
| 예시 | /var/lib/openclaw |
export OPENCLAW_WORKSPACE="/var/lib/openclaw"
설정
OPENCLAW_CONFIG
설정 파일 경로
| 항목 | 값 |
|---|---|
| 필수 여부 | 아니오 |
| 기본값 | ~/.openclaw/openclaw.json |
| 예시 | /etc/openclaw/config.json |
export OPENCLAW_CONFIG="/etc/openclaw/config.json"
로깅
OPENCLAW_LOG_LEVEL
로그 레벨
| 항목 | 값 |
|---|---|
| 필수 여부 | 아니오 |
| 기본값 | info |
| 가능한 값 | debug, info, warn, error, silent |
export OPENCLAW_LOG_LEVEL="debug"
OPENCLAW_LOG_FILE
로그 파일 경로
| 항목 | 값 |
|---|---|
| 필수 여부 | 아니오 |
| 기본값 | ~/.openclaw/logs/openclaw.log |
| 예시 | /var/log/openclaw/gateway.log |
export OPENCLAW_LOG_FILE="/var/log/openclaw/gateway.log"
네트워크
OPENCLAW_PORT
게이트웨이 포트
| 항목 | 값 |
|---|---|
| 필수 여부 | 아니오 |
| 기본값 | 3000 |
| 예시 | 8080 |
export OPENCLAW_PORT="8080"
OPENCLAW_HOST
게이트웨이 호스트
| 항목 | 값 |
|---|---|
| 필수 여부 | 아니오 |
| 기본값 | 0.0.0.0 |
| 예시 | 127.0.0.1 |
export OPENCLAW_HOST="127.0.0.1"
OPENCLAW_TIMEOUT
요청 타임아웃 (초)
| 항목 | 값 |
|---|---|
| 필수 여부 | 아니오 |
| 기본값 | 30 |
| 예시 | 60 |
export OPENCLAW_TIMEOUT="60"
채널별 환경 변수
Telegram
export TELEGRAM_BOT_TOKEN="123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11"
Slack
export SLACK_BOT_TOKEN="xoxb-1234567890-1234567890123-AbCdEfGhIjKlMnOpQrStUvWx"
export SLACK_SIGNING_SECRET="a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6"
Discord
export DISCORD_BOT_TOKEN="MTIzNDU2Nzg5MDEyMzQ1NjgwMA.GhIjKl.MnOpQrStUvWxYzAbCdEfGhIjKlMnOpQrStUvWx"
export WHATSAPP_API_KEY="your-api-key-here"
export WHATSAPP_PHONE_ID="123456789012345"
BlueBubbles
export BLUEBUBBLES_URL="http://localhost:8080"
export BLUEBUBBLES_PASSWORD="your-bb-password"
Signal
export SIGNAL_PHONE_NUMBER="+821012345678"
Matrix
export MATRIX_HOMESERVER_URL="https://matrix.org"
export MATRIX_ACCESS_TOKEN="syt_1234567890abcdef..."
AI 모델 설정
Anthropic Claude
export ANTHROPIC_API_KEY="sk-ant-your-key-here"
OpenAI
export OPENAI_API_KEY="sk-proj-your-key-here"
Google AI
export GOOGLE_AI_API_KEY="AIzaSy-your-key-here"
보안
인증
export OPENCLAW_SECRET="random-secret-string-here"
SSL/TLS
export OPENCLAW_CERT_FILE="/etc/ssl/certs/openclaw.crt"
export OPENCLAW_KEY_FILE="/etc/ssl/private/openclaw.key"
개발
# Node.js 환경
export NODE_ENV="development"
# 디버그 로그 활성화
export DEBUG="openclaw:*"
사용 예시
기본 설정
# ~/.bashrc 또는 ~/.zshrc
export OPENCLAW_API_KEY="sk-your-api-key"
export OPENCLAW_LOG_LEVEL="debug"
export OPENCLAW_WORKSPACE="~/.openclaw/workspace"
채널 설정
# Telegram
export TELEGRAM_BOT_TOKEN="123456:ABC-DEF..."
# Slack
export SLACK_BOT_TOKEN="xoxb-1234567890-1234567890123-..."
export SLACK_SIGNING_SECRET="a1b2c3d4e5f6..."
# Discord
export DISCORD_BOT_TOKEN="MTIzNDU2Nzg5MDEyMzQ1NjgwMA.GhIjKl..."
AI 모델 설정
export ANTHROPIC_API_KEY="sk-ant-your-key-here"
export OPENAI_API_KEY="sk-proj-your-key-here"
export GOOGLE_AI_API_KEY="AIzaSy-your-key-here"
주의사항
- 보안: API 키를 절대 커밋하지 마세요.
.env파일을.gitignore에 추가하세요. - 민감 정보: 로그에 토큰이 노출되지 않도록 주의하세요. 프로덕션에서는
OPENCLAW_LOG_LEVEL=warn권장. - 유효성 검사: 환경 변수 설정 후 게이트웨이 재시작이 필요합니다. 잘못된 값은 기본값으로 대체됩니다.
참고: