K KraftOS Message-first macOS agent

단계별 봇 생성

진짜 BotFather 찾기

Telegram 검색창에 @BotFather를 입력하거나 t.me/BotFather를 엽니다. 이름이 BotFather이고 username이 @BotFather인지 확인한 뒤 시작하세요.

/newbot 보내기

대화창에 /newbot을 보내면 BotFather가 봇 이름을 물어봅니다. 이름은 사람에게 보이는 표시 이름이고, 다음 단계의 username은 반드시 bot으로 끝나야 합니다.

봇 이름과 username 정하기

예를 들어 이름은 My Work Agent, username은 my_work_agent_bot처럼 정할 수 있습니다. username은 Telegram 전체에서 중복될 수 없어서, 이미 사용 중이면 다른 이름을 시도하면 됩니다.

HTTP API token 복사

생성이 끝나면 BotFather가 1234567890:ABC...처럼 생긴 긴 token을 보여줍니다. 이 token이 KraftOS 앱의 Telegram bot token 칸에 들어가는 값입니다.

  • token은 비밀번호처럼 취급하세요.
  • 아직 token을 못 받았다면 앱 설정 창에는 아무것도 넣지 말고 이 단계를 먼저 끝내세요.

Privacy mode 끄기

BotFather에 /setprivacy를 보내고 방금 만든 봇을 선택한 뒤 Disable을 누릅니다. 그래야 그룹 토픽에서 자연어 요청을 안정적으로 받을 수 있습니다.

그룹 참여 허용

BotFather에 /setjoingroups를 보내고 방금 만든 봇을 선택한 뒤 Enable로 둡니다. 이 설정이 꺼져 있으면 나중에 그룹에 봇을 초대할 때 막힐 수 있습니다.

운영 구조

KraftOS Telegram 운영 구조 Mac 앱, DM, General 토픽, 업무 토픽이 연결되는 흐름 Mac App local runtime DM owner control General connect / router Research topic agent Coding topic agent Finance topic agent DM은 Mac 제어, General은 그룹 연결, 토픽은 독립 작업실.
token은 절대 공개 채팅에 보내지 마세요

BotFather가 준 HTTP API token은 봇을 조종할 수 있는 비밀값입니다. KraftOS 앱의 token 입력칸에만 넣고, Telegram 그룹이나 다른 사람에게 보내지 마세요.

봇을 잘못 만들었어도 괜찮습니다

BotFather에서 새 봇을 다시 만들고 새 token을 KraftOS 앱에 저장하면 됩니다. 이전 token이 노출됐다고 느껴지면 BotFather의 /revoke로 token을 재발급하세요.