OpenClaw Dashboard 웹 패널 사용 가이드

서문

OpenClaw Dashboard는 내장된 웹 관리 패널로, 브라우저를 통해 대화 관리, 모델 전환, 설정 조정 등을 직관적으로 수행할 수 있습니다. 이 글에서는 Dashboard의 모든 기능을 전면적으로 안내합니다.

Dashboard 시작 및 접속

Dashboard 시작

OpenClaw 게이트웨이 서비스가 이미 실행 중인지 확인합니다:

openclaw up -d

그런 다음 아래 명령으로 브라우저에서 Dashboard를 엽니다:

openclaw dashboard

이 명령은 기본 브라우저를 자동으로 열어 Dashboard 주소로 접속합니다.

수동 접속

브라우저에서 직접 주소를 입력하여 접속할 수도 있습니다:

http://localhost:18789/dashboard

기본 포트를 변경한 경우 해당 포트 번호로 대체하면 됩니다.

원격 접속

OpenClaw가 원격 서버에 배포되어 있는 경우 포트가 개방되어 있는지 확인한 후 서버 IP로 접속합니다:

http://your-server-ip:18789/dashboard

보안을 위해 Nginx 리버스 프록시와 HTTPS를 설정하여 원격 Dashboard에 접속하는 것을 권장합니다.

인터페이스 개요

Dashboard 메인 인터페이스는 다음과 같은 영역으로 구성됩니다:

사이드바 내비게이션

사이드바에는 다음과 같은 주요 메뉴 항목이 포함되어 있습니다:

• 대화 - 모든 대화 기록 조회
• 채널 - 연결된 메시지 채널 관리
• 스킬 - 설치된 스킬 플러그인 탐색 및 관리
• 모델 - AI 모델 및 파라미터 설정
• 설정 - 시스템 레벨 설정
• 로그 - 실시간 실행 로그 확인

대화 관리

대화 목록 조회

사이드바에서 "대화"를 클릭하면 각 채널의 모든 대화 기록을 확인할 수 있습니다. 대화 목록은 다음 기능을 지원합니다:

• 채널별 필터링 - 채널 아이콘을 클릭하여 해당 채널의 대화만 표시
• 시간순 정렬 - 기본적으로 최신 메시지 시간순으로 정렬
• 대화 검색 - 상단 검색 바에 키워드를 입력하여 대화 내용을 전문 검색

검색 구문 예시:
- 일반 텍스트: 키워드를 직접 입력
- 채널 지정: channel:whatsapp 키워드
- 날짜 지정: date:2026-03-20 키워드
- 조합 검색: channel:telegram date:2026-03 배포 튜토리얼

대화 상세

대화를 클릭하면 메인 패널에 전체 대화 내용이 표시됩니다. 여기서 다음을 수행할 수 있습니다:

1. 메시지 흐름 확인 - 사용자 메시지와 AI 응답 포함
2. 메타데이터 확인 - 각 메시지의 타임스탬프, 사용된 모델, 토큰 소비량
3. 대화 계속 - 하단 입력 상자에서 직접 메시지를 보내 대화 계속
4. 대화 내보내기 - 우측 상단 내보내기 버튼을 클릭하여 JSON 및 Markdown 형식 지원

수동 대화 시작

Dashboard에서 메시지 채널에 의존하지 않고 직접 새 대화를 시작할 수 있습니다:

1. 사이드바 상단의 "새 대화" 버튼 클릭
2. 사용할 AI 모델 선택
3. 입력 상자에 내용을 입력하고 전송

이 기능은 모델 설정 테스트 및 스킬 플러그인 디버깅에 매우 유용합니다.

모델 전환

상단 바에서 모델 전환

상단 바에는 현재 사용 중인 모델을 표시하는 모델 선택 드롭다운이 있습니다. 클릭하면 이미 설정된 다른 모델로 전환할 수 있습니다:

선택 가능한 모델 예시:
├── Claude 3.5 Sonnet (claude)
├── GPT-4o (openai)
├── Gemini 1.5 Pro (gemini)
├── Llama 3 70B (ollama)
└── Mixtral 8x7B (openrouter)

모델 파라미터 조정

모델 선택 상자 옆의 톱니바퀴 아이콘을 클릭하면 현재 모델의 파라미터를 조정할 수 있습니다:

파라미터 수정 후 즉시 적용되며, 현재 세션에만 영향을 미칩니다. 글로벌 기본값으로 설정하려면 "설정" 페이지에서 수정해야 합니다.

채널 관리

채널 상태 확인

"채널" 페이지에서 설정된 모든 채널의 상태를 확인할 수 있습니다:

채널 상태 설명:
🟢 연결됨 - 채널이 정상 작동 중
🟡 연결 중 - 연결을 수립하는 중
🔴 연결 끊김 - 연결이 끊어졌으며 설정 확인이 필요
⚪ 미활성 - 채널이 설정되었으나 활성화되지 않음

채널 작업

각 채널에 대해 다음 작업을 수행할 수 있습니다:

• 활성화/비활성화 - 채널의 실행 상태 전환
• 재연결 - 연결 끊김 후 재연결 시도
• 로그 조회 - 해당 채널의 전용 로그 확인
• 설정 편집 - 채널의 설정 파라미터 수정

설정 패널

일반 설정

"설정" 페이지의 "일반" 탭에서 다음 내용을 조정할 수 있습니다:

{
  // 게이트웨이 포트
  port: 18789,
  // 기본 언어
  language: "zh-CN",
  // 기본 모델
  defaultModel: "claude",
  // 메시지 이력 보존 일수
  historyRetention: 30,
  // 최대 동시 대화 수
  maxConcurrent: 10
}

보안 설정

보안 설정에서는 다음을 구성할 수 있습니다:

• Dashboard 접속 비밀번호 - 패널 보호를 위한 로그인 비밀번호 설정
• API 키 관리 - 각 모델의 API 키 확인 및 갱신 (키는 마스킹 처리되어 표시)
• IP 화이트리스트 - Dashboard에 접근할 수 있는 IP 주소 제한
• 세션 타임아웃 - 자동 로그아웃 시간 설정

커맨드 라인을 통해서도 비밀번호를 빠르게 설정할 수 있습니다:

openclaw config set dashboard.password "your-secure-password"
openclaw restart

테마 전환

Dashboard에는 여러 테마가 내장되어 있어 선택할 수 있습니다:

• 라이트 테마 - 주간 사용에 적합한 흰색 테마
• 다크 테마 - 야간 사용에 적합한 어두운 테마
• 시스템 따라가기 - 운영체제의 다크/라이트 모드를 자동으로 따름

전환 방법: 우측 상단 사용자 아바타 클릭 → 테마 설정 → 선호하는 테마 선택

설정 파일을 통해 기본 테마를 설정할 수도 있습니다:

{
  dashboard: {
    theme: "dark",  // "light", "dark", "system"
  }
}

키보드 단축키

Dashboard는 작업 효율을 높이기 위한 풍부한 키보드 단축키를 제공합니다:

macOS에서는 Ctrl을 Cmd로 대체하면 됩니다.

실시간 로그 조회

"로그" 페이지에서 OpenClaw의 실행 로그를 실시간으로 확인할 수 있으며, 다음 기능을 포함합니다:

• 실시간 스트리밍 출력 - 로그가 스트리밍 방식으로 실시간 표시
• 로그 레벨 필터링 - DEBUG, INFO, WARN, ERROR 레벨별 필터링 가능
• 키워드 필터 - 키워드를 입력하여 일치하는 로그 항목만 표시
• 일시정지/계속 - 로그 스크롤을 일시정지하여 자세히 확인
• 로그 다운로드 - 현재 필터링 결과를 파일로 내보내기

# 커맨드 라인으로도 로그를 확인할 수 있습니다
openclaw logs

# 오류 로그만 확인
openclaw logs --level error

# 실시간 로그 추적
openclaw logs -f

모바일 대응

Dashboard는 모바일 환경에 맞게 반응형으로 최적화되어 있습니다. 모바일 브라우저에서 접속 시:

• 사이드바가 자동으로 접히며 햄버거 메뉴를 통해 열기 가능
• 메시지 입력 상자가 하단에 고정
• 모델 전환은 상단 드롭다운 메뉴에 배치
• 제스처 조작 지원 (좌측 스와이프로 사이드바 열기, 당겨서 새로고침)

요약

OpenClaw Dashboard는 AI 어시스턴트 플랫폼을 관리할 수 있는 직관적인 웹 인터페이스를 제공합니다. 핵심 작업 요약:

• openclaw dashboard를 통해 빠르게 패널 시작 및 열기
• 상단 바를 이용하여 모델을 빠르게 전환하고 파라미터 조정
• 검색 기능과 키보드 단축키를 활용하여 효율 향상
• 설정 패널에서 보안 옵션을 구성하여 인스턴스 보호
• 로그 페이지를 활용하여 실시간 모니터링 및 문제 해결