Configuration 참조

OpenClaw 설정 파일의 모든 옵션을 상세히 설명합니다.

개요

설정 파일 위치

기본 구조

{
  "agents": {},
  "channels": {},
  "sessions": {},
  "workspace": {},
  "skills": {},
  "automation": {}
}

섹션별 상세

1. Agents (에이전트)

{
  "agents": {
    "defaults": {
      "model": "claude-sonnet-4-20250514",
      "maxTokens": 200000,
      "temperature": 0.7,
      "workspace": "~/.openclaw/workspace"
    },
    "custom": {
      "research-agent": {
        "model": "claude-opus-4-20250514",
        "temperature": 0.3
      }
    }
  }
}

지원되는 모델

2. Channels (채널)

Slack

{
  "channels": {
    "slack": {
      "enabled": true,
      "botToken": "xoxb-your-bot-token-here",
      "appToken": "xapp-your-app-token-here",
      "channels": ["#general", "#random"],
      "signingSecret": "..."
    }
  }
}

Telegram

{
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "123456:ABC-DEF1234ghIkl-zyx57W2v1",
      "allowedChatIds": [123456789, 987654321],
      "allowAllChats": false
    }
  }
}

Discord

{
  "channels": {
    "discord": {
      "enabled": true,
      "botToken": "MTI234567890ABCDEFGHIJKLMNO",
      "guildId": "1234567890123456789",
      "commandPrefix": "/",
      "adminRoleIds": ["12345678901234567890"]
    }
  }
}

3. Sessions (세션)

{
  "sessions": {
    "maxSessions": 100,
    "timeout": 3600,
    "maxHistory": 50,
    "storagePath": "~/.openclaw/sessions/",
    "persistMemory": true,
    "memoryPath": "~/.openclaw/memory/"
  }
}

4. Workspace (워크스페이스)

{
  "workspace": {
    "path": "~/.openclaw/workspace",
    "maxSize": 10737418240,
    "autoCleanup": {
      "enabled": true,
      "ageDays": 30,
      "tempDir": "temp/"
    }
  }
}

5. Skills (스킬)

{
  "skills": {
    "builtin": [
      "file-read",
      "file-write",
      "web-search",
      "web-scrape",
      "email-send"
    ],
    "custom": [
      "~/.openclaw/skills/my-skill/",
      "/opt/company/skills/"
    ],
    "clawhub": [
      "github-user:slack-notifier",
      "community:weather-forecast"
    ]
  }
}

6. Automation (자동화)

{
  "automation": {
    "heartbeat": {
      "enabled": false,
      "intervalMinutes": 10,
      "message": "상태 확인"
    },
    "cron": [
      {
        "name": "아침 리포트",
        "enabled": true,
        "schedule": "0 9 * * *",
        "message": "아침 리포트 생성"
      }
    ]
  }
}

전체 예시

{
  "agents": {
    "defaults": {
      "model": "claude-sonnet-4-20250514",
      "maxTokens": 200000,
      "temperature": 0.7,
      "workspace": "~/.openclaw/workspace"
    }
  },
  "channels": {
    "slack": {
      "enabled": true,
      "botToken": "xoxb-your-token",
      "appToken": "xapp-your-app-token",
      "channels": ["#general"]
    },
    "telegram": {
      "enabled": true,
      "botToken": "123456:ABC-DEF",
      "allowedChatIds": [123456789]
    },
    "discord": {
      "enabled": false,
      "botToken": "MTI...",
      "guildId": "1234567890"
    }
  },
  "sessions": {
    "maxSessions": 100,
    "timeout": 3600,
    "maxHistory": 50,
    "persistMemory": true
  },
  "workspace": {
    "path": "~/.openclaw/workspace",
    "maxSize": 10737418240,
    "autoCleanup": {
      "enabled": true,
      "ageDays": 30
    }
  },
  "skills": {
    "builtin": ["file-read", "web-search"],
    "custom": ["~/.openclaw/skills/my-skill/"]
  },
  "automation": {
    "heartbeat": {
      "enabled": false,
      "intervalMinutes": 30
    },
    "cron": [
      {
        "name": "주간 리포트",
        "enabled": false,
        "schedule": "0 17 * * 5",
        "message": "주간 보고서 생성"
      }
    ]
  }
}

설정 검증

설정 유효성 검사

# 설정 문법 확인
openclaw config validate

# 특정 섹션 확인
openclaw config validate --section agents
openclaw config validate --section channels

설정 테스트

# 설정 테스트 (dry-run)
openclaw gateway start --dry-run

# 채널 연결 테스트
openclaw channel test --type slack

환경 변수 우선순위

1. 명령행 옵션 (--config, --workspace)
2. 환경 변수 (OPENCLAW_CONFIG, OPENCLAW_WORKSPACE)
3. 기본 경로 (~/.openclaw/)

참고:

• 공식 문서: Configuration