Signal 채널 설정

OpenClaw와 Signal 보안 메신저를 연동하는 방법을 안내합니다.

개요

Signal은 강력한 E2E 암호화로 유명한 보안 메신저입니다:

• 완전한 E2E 암호화
• 오픈소스
• 전화번호 기반 인증
• signal-cli를 통한 봇 구현

요구사항

• Signal 계정 (전화번호)
• 봇 전용 전화번호 (별도 SIM 카드 권장)
• Java 17+ (signal-cli 실행)
• signal-cli 설치

1단계: signal-cli 설치

# signal-cli 다운로드 (최신 버전 확인)
wget https://github.com/AsamK/signal-cli/releases/latest/download/signal-cli-*.tar.gz
tar xf signal-cli-*.tar.gz
sudo mv signal-cli-*/bin/signal-cli /usr/local/bin/

# Java 설치 확인
java --version

2단계: 전화번호 등록

# 전화번호 등록 (SMS 인증)
signal-cli -u +821012345678 register

# 인증 코드 확인
signal-cli -u +821012345678 verify 123456

3단계: OpenClaw 설정

{
  "channels": {
    "signal": {
      "enabled": true,
      "phoneNumber": "+821012345678",
      "signalCliPath": "/usr/local/bin/signal-cli",
      "dataPath": "~/.local/share/signal-cli"
    }
  }
}

# 환경 변수로 설정
export SIGNAL_PHONE_NUMBER="+821012345678"

접근 제한 설정

{
  "channels": {
    "signal": {
      "allowedNumbers": ["+821098765432"],
      "allowAll": false
    }
  }
}

그룹 채팅 지원

{
  "channels": {
    "signal": {
      "allowGroups": true,
      "allowedGroupIds": ["group-id-here"]
    }
  }
}

주의사항

• 봇 전용 전화번호를 사용하는 것을 강력히 권장합니다
• Signal 이용약관을 준수해야 합니다
• 자동화된 대량 메시지는 계정 차단 위험이 있습니다

트러블슈팅

signal-cli 등록 실패

# 로그 확인
signal-cli -u +821012345678 --verbose register

Java 버전 오류

java --version
# 17 이상 필요
sudo apt install openjdk-17-jdk  # Ubuntu/Debian

참고:

• signal-cli GitHub
• 공식 문서: Signal Channel