OpenClaw 초기셋팅

OpenClaw 초기셋팅

업데이트: 2026-04-17 설정자: 미미

접속정보 원본은 [[MiniCITY(v0.5_PARA_0502-)/04_ARCHIVE(보관함)/버전별/v0.2-백업/MiniCITY(v0.2_진행중_0419-)/98.history/MiniCITY(0.0_최초자료_0404-0410)/D.에이전트/01.오픈클로셋팅/민감정보-마스터]]를 참조

---

1. Tailscale 대시보드 활성화

목적

집/회사/아지트 등 어디서든 웹 브라우저로 OpenClaw 대시보드 접속

설정 파일 경로

~/.openclaw/openclaw.json

변경 내역

1.1 gateway.tailscale.mode

• 변경 전: "off"
• 변경 후: "serve"
• 설명: Tailscale serve 모드 활성화

1.2 gateway.bind

• 변경 전: "lan"
• 변경 후: "loopback"
• 설명: Tailscale serve 모드에서는 loopback 바인딩 필요

1.3 gateway.controlUi.allowedOrigins

• 변경 전: ["http://localhost:18789", "http://127.0.0.1:18789"]
• 변경 후: ["http://localhost:18789", "http://127.0.0.1:18789", "https://ps-m4pro-1.tail437af5.ts.net"] → ["http://localhost:18789", "http://127.0.0.1:18789", "https://ps-m4pro.tail437af5.ts.net"]
• 설명: Tailscale 도메인 CORS 허용 (origin not allowed 에러 해결)

접속 정보

항목	값
로컬 대시보드	http://127.0.0.1:18789/
Tailscale 대시보드	https://ps-m4pro-1.tail437af5.ts.net → https://ps-m4pro.tail437af5.ts.net
Tailscale IP	100.90.96.13 → 100.96.177.124

설정 후 재시작 필요

openclaw gateway restart

페어링 승인

외부 기기에서 접속 시 페어링 요청 발생:

# 대기 중인 요청 확인
openclaw devices list

# 요청 승인 (Request ID 사용)
openclaw devices approve <request-id>

---

2. 백업 파일

설정 변경 전 백업 생성:

~/.openclaw/openclaw.json.backup_20260417_213756

원복 필요 시:

cp ~/.openclaw/openclaw.json.backup_20260417_213756 ~/.openclaw/openclaw.json
openclaw gateway restart

---

3. SSH 접속 정보 (WSL 환경)

접속정보 원본은 [[MiniCITY(v0.5_PARA_0502-)/04_ARCHIVE(보관함)/버전별/v0.2-백업/MiniCITY(v0.2_진행중_0419-)/98.history/MiniCITY(0.0_최초자료_0404-0410)/D.에이전트/01.오픈클로셋팅/민감정보-마스터]]를 참조

개요

WSL은 장시간 미사용 시 자동 종료됨. SSH 접속 전 Windows에서 WSL을 먼저 켜야 함.

접속 워크플로우

Windows SSH 접속 → WSL 시작 → WSL SSH 접속

SSH 설정 (~/.ssh/config)

Host mainpc-win
    HostName 100.116.141.88
    Port 7022
    User pinksky

Host mainpc-wsl
    ~~HostName 100.103.1.41~~
    ~~Port 22~~
    HostName 100.105.122.120
    Port 2222
    User pinksky

Host subpc-win
    HostName 100.85.201.96
    Port 7022
    ~~User minih~~
    User pinksky

Host subpc-wsl
    ~~HostName 100.87.139.97~~
    ~~Port 6022~~
    ~~User pinkskyn~~
    HostName 100.124.61.85
    Port 2222
    User pinksky

WSL 접속 단계

1. mainpc (메인컴)

# Windows 접속
ssh mainpc-win

# WSL 시작
wsl

# WSL SSH 접속 (새 터미널)
ssh mainpc-wsl

2. subpc (보조컴)

# Windows 접속
ssh subpc-win

# WSL 시작
wsl

# WSL SSH 접속 (새 터미널)
ssh subpc-wsl

WSL 설정

sudo 권한

• mainpc-wsl: pinksky 계정에 sudo 권한 부여 완료
• subpc-wsl: pinkskyn → pinksky 계정에 sudo 권한 부여 완료

자동 종료 방지

Windows 사용자 폴더에 .wslconfig 파일 생성:

[wsl2]
idleTimeout=-1
memory=32GB
processors=10

적용 방법:

wsl --shutdown
wsl

---

4. Gateway 재시작 자동화

개요

Gateway 재시작 후 30초 뒤 자동으로 상태를 확인하여 완료 여부를 보고함.

스크립트 위치

~/.openclaw/scripts/gateway_restart_with_check.sh

스크립트 내용

#!/bin/bash
# Gateway 재시작 후 30초 뒤 자동 상태 확인

echo "$(date '+%Y-%m-%d %H:%M:%S'): Gateway 재시작 시작..."

# Gateway 재시작
openclaw gateway restart

# 30초 대기
echo "$(date '+%Y-%m-%d %H:%M:%S'): 30초 후 상태 확인..."
sleep 30

# 상태 확인
echo "===== Gateway 상태 확인 ====="
openclaw status | grep -E "(Gateway|Dashboard|Tailscale)"
STATUS=$?

if [ $STATUS -eq 0 ]; then
    echo "✅ Gateway 재시작 완료"
else
    echo "❌ 상태 확인 실패"
fi

사용 방법

터미널에서 직접 실행:

~/.openclaw/scripts/gateway_restart_with_check.sh

또는 ~/.zshrc에 함수 추가:

openclaw-restart() {
  ~/.openclaw/scripts/gateway_restart_with_check.sh
}

⚠️ 무한 루프 주의사항

문제: 스크립트나 함수에서 openclaw gateway restart를 반복 호출하면 Gateway가 계속 재시작될 수 있음.

해결책:

1. 타이머 확인: sleep 30으로 충분한 대기 시간 확보
2. 상태 체크: 재시작 전 현재 상태 확인 (openclaw status | grep "state active")
3. 강제 종료: Ctrl+C로 스크립트 중단 가능
4. 로그 확인: 문제 발생 시 openclaw logs --follow로 실시간 로그 확인

예방 코드 (스크립트 상단에 추가):

# 이미 재시작 중이면 중복 실행 방지
if pgrep -f "openclaw gateway restart" > /dev/null; then
    echo "⚠️ Gateway 재시작이 이미 진행 중입니다."
    exit 1
fi

---

5. 노드 정보

노드명	ID
mainpc-node	4448cee08fe91d1dedfaa52466b5282cb424c16e22ffd9ec2fc773c17e9dc206
MH-3900x	c622d0082eb04895238519fc1ffd10fd08d2055e096aecf218aa3a1337c5c56d

서비스: --host ps-m4pro.tail437af5.ts.net --port 443 --tls

---

6. 참고 자료

• 공유기 설정: 네트워크/ 폴더 참고
• 하드웨어 정보: 하드웨어/ 폴더 참고
• Tailscale IP: 100.90.96.13 → 100.96.177.124 (PS-M4pro)

[!note] 수정이력 | 2026-04-20 07:44, 미미