OpenClaw 설치 방법: Telegram 설정 가이드

단계별 안내

1. 실행할 장소 선택하기

   OpenClaw를 시험해 볼 때는 노트북도 괜찮지만, 언제든 접속할 수 있는 에이전트를 원한다면 가정용 서버나 임대한 VPS처럼 늘 켜져 있는 장비가 더 적합합니다. 컴퓨터가 실행 중일 때만 답변할 수 있기 때문입니다. 어디에서 실행하든 게이트웨이 포트를 공개 인터넷에 노출해서는 안 됩니다.

2. OpenClaw 설치하기

   운영체제에 맞는 공식 설치 프로그램을 사용하세요. 설치 프로그램이 운영체제를 감지하고, Node가 없으면 설치한 뒤 OpenClaw를 설정하고 온보딩으로 안내합니다.

   # macOS / Linux / WSL2
   curl -fsSL https://openclaw.ai/install.sh | bash
   
   # Windows (PowerShell)
   iwr -useb https://openclaw.ai/install.ps1 | iex

   복사

3. 온보딩을 마치고 게이트웨이를 서비스로 실행하기

   온보딩에서는 확인된 AI 사용 권한을 재사용하는 Quick start 또는 모든 옵션을 직접 설정하는 Custom setup을 선택할 수 있습니다. 온보딩이 끝나면 포그라운드에서 실행 중인 게이트웨이를 종료하고 백그라운드 서비스로 등록하세요. 그러면 재시작 후 자동으로 다시 실행됩니다.

   openclaw onboard
   # stop the foreground gateway with Ctrl+C, then run it as a service:
   openclaw gateway install

   복사

4. Telegram 연결하기

   Telegram에서 @BotFather와의 채팅을 열고, 계정 이름이 맞는지 다시 확인한 뒤 /newbot을 보내세요. 받은 토큰을 보관합니다. 해당 토큰으로 Telegram을 채널로 등록한 다음 상태 확인 명령을 실행해 연결을 확인하세요.

   openclaw channels add --channel telegram --token <bot-token>
   openclaw channels status --probe

   복사

5. 페어링 승인하기

   봇에 메시지를 보내세요. 봇은 답장하는 대신 처음 연락한 발신자에게 페어링 코드를 보냅니다. 대기 중인 요청을 확인하고 한 시간이 지나기 전에 본인의 요청을 승인하세요.

   openclaw pairing list telegram
   openclaw pairing approve telegram <CODE>

   복사

6. 보안 감사를 실행하고 최신 상태 유지하기

   OpenClaw의 자체 보안 감사로 설정을 점검하고, 지적된 문제를 해결한 뒤 안정화 채널의 업데이트를 적용하세요. 2026.4.22 이전에 출시된 버전에는 알려진 치명적 취약점이 있으므로 두 명령을 정기적으로 실행하세요.

   openclaw security audit
   openclaw update --channel stable

   복사

7. 상시 적용할 규칙 작성하기

   에이전트 작업 공간의 AGENTS.md에 평이한 언어로 규칙을 작성하고, ~/.openclaw/openclaw.json에도 이에 맞는 엄격한 제한을 설정하세요. 키 이름은 사용 중인 버전의 문서와 대조해 확인합니다. dmPolicy는 pairing으로 유지하고 설정에 확신이 생길 때까지 exec 승인은 매번 요청하도록 설정하세요.