# CastAgent / OpenClaw 자동세팅 안내

## 가장 추천하는 파일

### macOS
- `CastAgent_OpenClaw_macOS_자동세팅.command`
- 우클릭 → 열기

자동 처리 범위:
1. Git 확인
2. Node.js/npm 확인(Homebrew가 있으면 Node 설치 시도)
3. CastAgent 저장소 다운로드/업데이트
4. OpenClaw 설치/업데이트
5. OpenClaw 기본 workspace 초기화
6. Telegram 봇 토큰 입력 시 채널 연결
7. Gateway 서비스 설치/시작 시도
8. Google 연동 명령 실행 여부 질문
9. CastAgent 교육 페이지 로컬 미리보기 실행

사람이 직접 해야 하는 단계:
- BotFather에서 봇 생성 및 토큰 복사
- Google 로그인/권한 승인
- macOS 보안 경고 승인
- 그룹방에 봇 직접 추가

막히면 터미널에서:
```bash
xattr -dr com.apple.quarantine CastAgent_OpenClaw_macOS_자동세팅.command
chmod +x CastAgent_OpenClaw_macOS_자동세팅.command
./CastAgent_OpenClaw_macOS_자동세팅.command
```

### Windows
- `CastAgent_OpenClaw_Windows_자동세팅.ps1`
- 우클릭 → PowerShell에서 실행

자동 처리 범위:
1. Git 확인/winget 설치 시도
2. Node.js 확인/winget 설치 시도
3. CastAgent 저장소 다운로드/업데이트
4. OpenClaw 설치/업데이트
5. OpenClaw 기본 workspace 초기화
6. Telegram 봇 토큰 입력 시 채널 연결
7. Gateway 서비스 설치/시작 시도
8. Google 연동 명령 실행 여부 질문
9. CastAgent 교육 페이지 로컬 미리보기 실행

사람이 직접 해야 하는 단계:
- BotFather에서 봇 생성 및 토큰 복사
- Google 로그인/권한 승인
- PowerShell 실행정책 승인
- 그룹방에 봇 직접 추가

막히면 PowerShell에서:
```powershell
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned
.\CastAgent_OpenClaw_Windows_자동세팅.ps1
```

## 구버전 파일
아래 파일은 CastAgent 사이트만 다운로드/미리보기 하는 단순 버전입니다.
- `AgentCast_macOS_설치.command`
- `AgentCast_Windows_설치.ps1`

내일 교육에는 자동세팅 파일을 우선 사용하세요.

## 보안 주의
- Telegram Bot token은 비밀번호와 같습니다. 공개 채팅방/문서에 저장하지 마세요.
- Google 권한 승인은 반드시 본인이 직접 합니다.
- 외부 발송, 삭제, 결제, 공개 업로드는 시연 중 실행하지 않습니다.