- Telegram 앱에 로그인된 계정
- Apple Silicon Mac과 안정적인 인터넷
- Claude 계정 로그인 가능 상태
- 설치 중 Mac 암호를 입력할 수 있는 권한
bot token은 BotFather가 발급하는 긴 문자열이고,
owner는 내 Telegram 계정입니다. 둘은 다른 값입니다. 처음에는
owner에 숫자 id보다 @username을 넣는 편이 쉽습니다.
단계별 설치
내 Telegram username 확인
Telegram 설정에서 username이 있으면 앱의 owner 칸에 @username을
넣을 수 있습니다. username이 없다면 Telegram 설정에서 하나 만들거나, 숫자
user id를 확인해서 넣으면 됩니다.
BotFather에서 봇 token 받기
Telegram 검색창에서 @BotFather를 찾아 열고 /newbot을
보냅니다. 봇 이름과 username을 정하면 마지막에 긴 HTTP API token이 나옵니다.
이 값을 복사해두세요. 자세한 단계는
Telegram 페이지에 정리돼 있습니다.
Terminal 열기
Mac에서 Command + Space를 누르고 Terminal을 검색해 실행합니다. 열린 검은색/흰색 창에 이 페이지의 설치 명령을 붙여넣고 Enter를 누르면 됩니다.
설치 명령 실행
위쪽의 curl 명령 전체를 복사해 Terminal에 붙여넣습니다. 설치가
끝나면 화면 오른쪽 위 메뉴바에 KraftOS 앱이 표시됩니다.
- 처음 설치는 몇 분 걸릴 수 있습니다.
- Command Line Tools, Homebrew, Bun, Claude CLI 설치 메시지가 나오면 기다리면 됩니다.
- Mac 암호를 물어보면 내 Mac 로그인 암호를 입력합니다. 입력 중 화면에 글자가 안 보여도 정상입니다.
앱에 token과 owner 입력
메뉴바의 KraftOS를 열고 BotFather에서 받은 token, 내 Telegram
@username 또는 숫자 id를 입력합니다. 이 owner만 DM에서 내 Mac을
제어할 수 있습니다.
Claude 로그인 확인
provider가 claude-agent라면 메뉴바 앱에서 Claude 로그인을 눌러 브라우저 로그인을 끝냅니다. 이미 로그인되어 있으면 Claude 상태 확인에서 정상으로 표시됩니다.
DM에서 봇이 살아있는지 확인
Telegram에서 방금 만든 내 봇을 열고 /start를 보냅니다. 이어서
상태 확인해줘 또는 /status를 보내 응답이 오면 첫
단계는 완료입니다.