najmuzzaman-mohammad/gawkbot

open source grok bot. gawk bots automate your menial work via AI models and build you microapps to manage the outcome, so that you have a false sense of control.

gawkbot – 로컬에서 실행되는 오픈소스 '항상 실행' AI 봇

무엇인가요 – gawkbot은 자연어(또는 데모를 통해)로 워크플로우를 설명하면, 전용 AI 기반 '마이크로앱'(봇)을 자동으로 생성하는 자체 호스팅 플랫폼입니다. 봇은 귀하의 컴퓨터(또는 제어 가능한 VM)에서 실행되며, 1200개 이상의 제3자 서비스와 통합되어 상호작용할 수 있습니다. 외부 쓰기 작업(예: 이메일 전송, CRM 레코드 생성, 코드 커밋)은 모두 명시적인 인간의 승인 단계를 거쳐야 합니다.

왜 중요한가요 – 대부분의 상용 AI 어시스턴트 제품(예: xAI의 Grok Bot)은 클라우드 전용, 폐쇄형, 사용량 기반 요금제입니다. gawkbot은 이 모델을 뒤집습니다: 코드는 Sustainable Use License 하에 공개되어 있으며, 귀하의 API 키로 로컬에서 실행되며, 선택한 LLM(예: Claude Code, Codex, Opencode, Ollama 등)의 비용 외에는 무료입니다. 이로써 데이터, 비용, 보안에 대한 완전한 제어를 유지하면서도 AI 기반 자동화의 편의성을 누릴 수 있습니다.

핵심 개념

구성 요소	제공되는 기능
App (화면)	라이브 웹 UI(기본 http://localhost:7891)로 봇의 '화면', 데이터, 채팅 스타일 콘솔을 표시합니다.
Routine	크론과 유사한 스케줄링 작업으로, 봇을 반복적으로 실행합니다. 각 실행은 버전 관리되고 로깅됩니다.
Tools	봇에게 가르치는 사용자 정의 작업(예: 리드 평가, #ae-handoffs에 게시).
Knowledge	봇이 제시하는 모든 주장의 출처를 인용하는 자동 생성된 위키 스타일 페이지입니다.
Data + Integrations	봇별 타입 지정된 테이블과 1200개 이상의 연결자(예: Slack, Gmail, HubSpot 등)의 공유 카탈로그.
승인 게이트	읽기는 무료입니다. 쓰기 작업은 UI에서 승인을 클릭할 때까지 일시 중단됩니다.

시작하기 (빠른 시작)

설치 – 한 줄 명령어로 실행하거나 전역 설치:

npx gawkbot               # npm에서 바이너리 실행하고 UI 열기
# 또는
npm install -g gawkbot && gawkbot

모델 선택 – 첫 실행 화면에서 프로바이더를 지정합니다. 기본적으로 Claude Code를 사용합니다. --provider 또는 환경 변수를 통해 Codex, Opencode, Ollama, Hermes, OpenClaw, 또는 OpenAI 호환 엔드포인트로 전환할 수 있습니다.
온보딩 – UI가 런타임 검증, 오피스(워크스페이스) 이름 지정, 첫 번째 워크플로우를 한 문장으로 설명하는 절차를 안내합니다.
빌드 감시 – 라이브 활동 피드가 봇의 화면, 루틴, 도구, 지식 페이지가 생성되는 과정을 스트리밍으로 표시합니다.
승인 – 봇이 처음으로 외부 쓰기 작업을 시도할 때, 모달 창이 확인을 요청합니다.

소스에서 빌드하기 (Go 1.25+ 및 Bun 필요):

git clone https://github.com/najmuzzaman-mohammad/gawkbot.git
cd gawkbot
cd web && bun install && bun run build && cd ..
go build -o gawkbot ./cmd/wuphf
./gawkbot

확장성 및 배포 옵션

다중 런타임 – --provider ollama (또는 지원되는 이름 중 하나)를 지정하여 봇을 로컬 모델이나 사용자 정의 OpenAI 호환 엔드포인트에 연결할 수 있습니다.
로컬 우선 vs 클라우드 호스팅 – 액션은 로컬 CLI(키는 기계에서 나가지 않음) 또는 Composio를 통해 실행할 수 있습니다. Composio는 1200개 이상의 SaaS 통합의 OAuth를 처리합니다.
워크스페이스 – gawkbot workspace create|list|switch로 프로젝트를 격리할 수 있습니다.
팀 공유 – 개인 Tailscale/WireGuard 메시(gawkbot share) 또는 Cloudflare 터널(1회용, 6자리 패스코드)을 통해 동료를 초대할 수 있습니다.
텔레메트리 제어 – 제품 분석 및 세션 녹화는 선택 사항이며, PostHog 키를 제공하지 않으면 비활성화됩니다.

라이선스 및 커뮤니티

라이선스 – Sustainable Use License (see LICENSE). 리포지토리는 완전히 공개되어 있으며, 원작자에게 지불하지 않고도 포크, 수정, 자체 호스팅이 가능합니다.
커뮤니티 – README에서 링크된 Discord 커뮤니티와, 최근 인기를 반영하는 Hacker News 배지가 있습니다.

누구에게 추천할까?

제3자 클라우드에 데이터를 전송하지 않고도 AI 기반 워크플로우 자동화를 원하는 엔지니어나 소규모 팀.
프로그래머블한 '워크플로우별 봇' 패턴이 필요하고, 비용, 토큰 사용량, 실행 로그에 대한 완전한 가시성을 원하는 개발자.
유료 'Grok Bot' 스타일 서비스의 무료이고 확장 가능한 대안을 찾는 사람.

결론

gawkbot은 자연어로 작성된 작업 설명을 실행 가능한 마이크로앱으로 변환할 수 있는 로컬에서 실행되는 오픈소스, 승인 게이트가 있는 AI 봇 플랫폼을 제공합니다. 스케줄링, 데이터 테이블, 출처 기반 지식 기반을 갖추고 있습니다. 데이터 주권, 비용 투명성, 자동화 코드의 검토 또는 수정 가능성을 중시한다면, gawkbot은 훌륭한 기반을 제공합니다.