WebChat 채널 설정

OpenClaw에 내장된 웹 채팅 인터페이스를 사용하는 방법을 안내합니다.

개요

WebChat은 OpenClaw에 기본 내장된 웹 기반 채팅 UI입니다:

• 별도 설정 불필요 - Gateway 시작 시 자동으로 활성화
• 브라우저에서 바로 접근 가능
• 마크다운 렌더링 지원
• 파일 업로드 지원

사용 방법

기본 접근

# Gateway 시작
openclaw gateway start

# 브라우저에서 접근
# http://localhost:3000

Gateway가 실행되면 http://localhost:3000에서 웹 채팅 UI를 사용할 수 있습니다.

설정

포트 변경

{
  "gateway": {
    "port": 8080,
    "host": "0.0.0.0"
  }
}

# 또는 CLI로
openclaw gateway start --port 8080

외부 접근 허용

{
  "channels": {
    "webchat": {
      "enabled": true,
      "cors": {
        "origins": ["https://your-website.com"],
        "allowAll": false
      }
    }
  }
}

기본 메시지 커스터마이징

{
  "channels": {
    "webchat": {
      "welcome": "안녕하세요! AI 어시스턴트입니다. 무엇을 도와드릴까요?",
      "placeholder": "메시지를 입력하세요...",
      "title": "My AI Assistant"
    }
  }
}

웹 앱에 임베드

다른 웹 서비스에 채팅 위젯으로 삽입할 수 있습니다:

<!-- 채팅 위젯 삽입 -->
<script>
  window.OpenClawConfig = {
    gatewayUrl: 'http://localhost:3000',
    theme: 'light'
  };
</script>
<script src="http://localhost:3000/widget.js"></script>

트러블슈팅

포트가 이미 사용 중

# 다른 포트로 시작
openclaw gateway start --port 3001

# 또는 기존 프로세스 확인
lsof -i :3000

외부에서 접근 불가

방화벽에서 포트 개방:

# Linux (ufw)
sudo ufw allow 3000

# 또는 설정에서 host 변경
openclaw config set gateway.host "0.0.0.0"

다음 단계:

• Telegram 설정 - 모바일 앱에서 사용
• Slack 설정 - 팀에서 사용