OpenClaw Web 관리 패널 사용 가이드

서문

OpenClaw은 브라우저를 통해 AI 게이트웨이의 모든 측면을 직관적으로 관리하고 모니터링할 수 있는 내장 Web Dashboard를 제공합니다. 실시간 대화부터 시스템 상태까지, 설정 조정부터 기기 관리까지, Dashboard는 일상 운영에서 가장 자주 사용되는 도구입니다. 이 글에서는 Dashboard의 각 기능과 사용 방법을 완전히 소개합니다.

Dashboard 시작

Dashboard는 두 가지 시작 방법이 있습니다:

게이트웨이와 함께 자동 시작

OpenClaw 게이트웨이를 시작하면 Dashboard가 기본적으로 함께 활성화됩니다:

openclaw gateway --port 18789
# Dashboard가 http://localhost:18789/dashboard에서 사용 가능

독립 시작

Dashboard 서비스만 별도로 시작할 수도 있습니다:

openclaw dashboard
# 기본적으로 http://localhost:18789/dashboard에서 시작

openclaw dashboard --port 8080
# 커스텀 포트 지정

접근 및 인증

브라우저에서 Dashboard 주소를 열면, 비밀번호가 설정된 경우 먼저 인증을 완료해야 합니다:

{
  "gateway": {
    "dashboardPassword": "your-strong-password"
  }
}

비밀번호를 입력하면, Dashboard가 세션 Token을 생성하고 브라우저를 닫기 전까지 로그인 상태를 유지합니다.

프로덕션 환경에서는 반드시 비밀번호를 설정하세요. 특히 host가 "0.0.0.0"으로 설정된 경우에는 더욱 중요합니다.

메인 페이지: 개요

로그인 후 처음 보이는 것은 개요 페이지로, 시스템의 핵심 상태를 카드 형태로 보여줍니다:

상태 카드

실행 시간: 게이트웨이가 실행된 시간
활성 채널: 현재 연결된 인스턴트 메시징 채널 수와 이름
오늘의 메시지: 당일 처리한 총 메시지 수
활성 세션: 현재 활성 대화가 있는 사용자 수
모델 상태: 각 모델 공급자의 가용성과 응답 지연시간
시스템 리소스: CPU, 메모리 사용량

실시간 메시지 스트림

개요 페이지 하단에는 모든 채널의 최신 메시지를 보여주는 실시간 메시지 스트림이 있습니다. 채널이나 사용자별로 필터링할 수 있어, AI의 응답 품질을 실시간으로 모니터링하기 편리합니다.

세션 관리

Dashboard의 세션 관리 기능은 일상적으로 가장 자주 사용하는 모듈입니다.

세션 목록

좌측 패널에 모든 활성 및 과거 세션이 최근 활동 시간순으로 나열됩니다. 각 세션 항목은 다음을 보여줍니다:

사용자 이름과 프로필 사진(있는 경우)
출처 채널 아이콘
마지막 메시지의 요약
마지막 활동 시간

대화 인터페이스

세션을 클릭하면, 오른쪽에 전체 대화 내용이 표시됩니다. 여기에서 할 수 있는 것들:

기록 열람: 스크롤하여 전체 대화 기록 확인
직접 대화: AI 어시스턴트 신분으로 메시지 전송 (테스트 또는 수동 개입 용도)
분기 확인: 트리 형태 세션의 분기를 시각화하여 표시하고, 분기 노드를 클릭하여 전환하여 볼 수 있음
메시지 삭제: 지정된 메시지와 모든 하위 노드를 삭제
대화 내보내기: 현재 세션을 JSON 또는 일반 텍스트 형식으로 내보내기

새 대화

Dashboard에서 직접 AI와 대화를 시작하여 설정 효과를 빠르게 테스트할 수도 있습니다:

"새 대화" 버튼 클릭
대상 Agent 선택
메시지 입력 시작

Dashboard 대화의 세션 데이터는 web_dashboard.jsonl 파일에 저장됩니다.

채널 모니터링

채널 모니터링 페이지는 설정된 모든 채널의 상세 상태를 보여줍니다:

정보 항목	설명
연결 상태	온라인 / 오프라인 / 재연결 중
마지막 하트비트	가장 최근 하트비트 시간
메시지 통계	당일 송수신 메시지 수
오류 횟수	최근 24시간의 오류 횟수
지연시간	메시지 처리 평균 지연시간

문제가 있는 채널의 경우, "재연결" 버튼을 클릭하여 재연결을 시도하거나, "로그 보기"를 클릭하여 해당 채널의 상세 로그를 확인할 수 있습니다.

Agent 관리

여러 Agent를 설정한 경우, Dashboard는 시각적 Agent 관리 인터페이스를 제공합니다:

Agent 목록 조회: 설정된 모든 Agent의 개요
Agent 편집: Agent의 이름, 모델, 시스템 프롬프트 등 설정 수정
통계 조회: 각 Agent의 메시지 수, 활성 사용자 수, 평균 응답 시간
라우팅 규칙: 다중 Agent 라우팅 설정 조회 및 편집

Dashboard에서 수정한 설정은 자동으로 openclaw.json에 반영되며, 수동으로 파일을 편집할 필요가 없습니다.

모델 테스트

모델 테스트(Playground) 페이지에서는 어떤 채널도 거치지 않고 모델과 직접 대화할 수 있습니다:

모델 공급자와 구체적인 모델 선택
시스템 프롬프트와 매개변수 커스터마이징 (temperature, maxTokens 등)
이미지를 업로드하여 비전 능력 테스트
원본 API 요청과 응답 확인

이 기능은 모델 설정을 디버깅하거나 다른 모델의 응답 품질을 비교할 때 매우 유용합니다.

기기 관리

기기 관리 페이지는 페어링된 모바일 기기를 관리하는 데 사용됩니다:

기기 목록 조회: 페어링된 모든 기기의 이름, 플랫폼, 마지막 활동 시간
페어링 코드 생성: 버튼을 클릭하여 새 페어링 코드 또는 QR 코드 생성
기기 제거: 기기의 접근 권한 철회
푸시 테스트: 지정된 기기에 테스트 푸시 알림 전송

로그 조회

Dashboard에는 다음을 지원하는 로그 뷰어가 내장되어 있습니다:

실시간 추적: tail -f와 유사한 실시간 로그 스트림
레벨 필터링: debug, info, warn, error별 필터링
검색: 로그 내용 전문 검색
시간 범위: 특정 시간대의 로그 선택 조회

설정 편집기

Dashboard는 openclaw.json을 직접 수정할 수 있는 온라인 설정 편집기를 제공합니다:

구문 강조 및 자동 완성
저장 전 자동으로 설정 유효성 검증
원클릭 핫 리로드 (게이트웨이 재시작 불필요)
수정 기록으로 이전 버전으로 롤백 가능

# 핫 리로드는 명령줄로도 트리거 가능
openclaw reload

시스템 정보

시스템 정보 페이지는 OpenClaw의 실행 환경을 보여줍니다:

OpenClaw 버전 번호
Node.js 버전
운영 체제 정보
설정 파일 경로
데이터 디렉토리 크기
로드된 스킬 목록
MCP Server 연결 상태

Dashboard 설정 옵션

openclaw.json에서 Dashboard의 동작을 커스터마이징할 수 있습니다:

{
  "gateway": {
    "dashboard": {
      "enabled": true,
      "path": "/dashboard",
      "theme": "auto",
      "language": "ko",
      "refreshInterval": 5000,
      "maxLogLines": 1000
    }
  }
}

매개변수	설명
`path`	Dashboard의 URL 경로
`theme`	테마: `auto`, `light`, `dark`
`language`	인터페이스 언어
`refreshInterval`	데이터 새로고침 간격 (밀리초)
`maxLogLines`	로그 뷰어 최대 줄 수

모바일 접근

Dashboard는 반응형 디자인을 적용하여, 스마트폰 브라우저에서도 정상적으로 사용할 수 있습니다. Dashboard를 스마트폰 홈 화면에 추가하여 PWA(Progressive Web App)로 사용할 수도 있으며, 네이티브 앱에 가까운 경험을 얻을 수 있습니다.

iOS Safari에서: 공유 버튼 클릭 → 홈 화면에 추가. Android Chrome에서: 메뉴 클릭 → 앱 설치.

보안 권장사항

항상 dashboardPassword를 설정하세요
공용 인터넷에서 접근하는 경우 반드시 HTTPS를 활성화하세요
정기적으로 기기 관리 페이지를 확인하고 더 이상 사용하지 않는 기기를 제거하세요
리버스 프록시(Nginx/Caddy)를 사용하여 추가 접근 제어를 적용하는 것을 고려하세요

정리

OpenClaw의 Web Dashboard는 실시간 모니터링부터 설정 편집까지 모든 운영 요구사항을 다루는 종합적인 관리 인터페이스입니다. 명령줄 매개변수를 기억할 필요 없이, AI 게이트웨이의 모든 측면을 직관적으로 관리할 수 있습니다. Dashboard를 일상 관리의 주요 진입점으로 사용하고, 명령줄 도구는 자동화 및 일괄 작업에 활용하는 것을 권장합니다.