ONEDEV

gawkbot

AI Agent OrchestrationCLIGo

★ 1,379주당 +34조회 4

무엇인가

gawkbot은 개인 머신에서 상시 구동되는 AI 봇을 만들고 운영하는 CLI 도구다. 수동으로 반복하던 업무를 봇과, 그 결과를 관리하는 마이크로앱으로 바꾸는 자리에 놓인다. 봇마다 자기 화면·자기 스케줄·자기 도구 세트를 따로 가지며, 외부로 나가는 쓰기 동작은 사람 승인 게이트를 통과해야 실행된다. 로컬 VM을 컴퓨터로 쓰고 클라우드 실행 옵션도 있다.

어떻게 동작하나

구성은 브로커, 사이드카 실행 서비스(`agent/`), 그리고 봇 런타임으로 쓰는 외부 코딩 CLI로 나뉜다. 일상 실행은 `agent/` 사이드카가 맡고 브로커가 이를 자동으로 찾아 감독한다. 소스 체크아웃에서는 `WUPHF_AGENT_DIR`로 위치를 바꾸거나 `WUPHF_AGENT_URL`로 직접 관리하는 서비스를 지정한다. 런타임 기본값은 Claude Code이고 Codex CLI나 Opencode로 대체할 수 있으며, 첫 실행 화면이 다른 무엇보다 먼저 런타임을 검증한다. 워크스페이스 상태는 `~/.wuphf/` 아래 로컬 파일로 남고 봇 지식·실행 트랜스크립트·회사 브레인이 여기에 쌓인다. 지식 페이지는 출처 인용을 붙여 합성되므로 봇의 주장을 원문까지 추적할 수 있다. 외부 동작은 두 제공자 중 하나로 실행된다. 기본값인 One CLI는 로컬 CLI를 통해 동작하고 자격 증명이 머신을 떠나지 않는다. Composio는 클라우드 OAuth 방식으로 Gmail·Slack·HubSpot을 포함한 1200개 이상 카탈로그를 봇의 Integrations 탭에서 연결하며, 연결은 사무실 전체가 공유한다.

무엇과 다른가

xAI의 Grok Bot이 클라우드에서 도는 것과 달리 gawkbot은 사용자 머신과 사용자 계정에서 실행된다. 이미 비용을 지불 중인 코딩 봇 CLI를 런타임으로 재사용하고, 모든 외부 동작에 승인 게이트를 둔다는 점이 구조적 차이다. 같은 문제를 다루는 다른 오픈소스 대안으로 Rakazo, OpenMausBot, OpenBot이 있으며 항목별 비교는 gawk.bot/open-source-grok-bot에 정리돼 있다.

어떻게 쓰나

선행 조건은 로그인된 봇 CLI 하나다. 실행하면 브라우저가 열리고 런타임 검증, 사무실 이름 지정, 첫 워크플로 전달 순서로 진행되며 봇이 만들어지는 과정이 실시간으로 표시된다. 소스에서 빌드하려면 Go와 Bun이 필요하다. 설치를 AI 봇에 맡기려면 README의 셋업 프롬프트를 Claude Code, Codex, Cursor에 붙여 넣는다. `--provider opencode`는 opencode CLI 바이너리를 호출하고, MLX-LM과 Ollama는 클라우드 키 없이 첫 실행 화면에서 설정한다. Hermes Bot이나 OpenClaw 게이트웨이가 이미 있으면 `--provider hermes-agent`(기본 `http://127.0.0.1:8642/v1`) 또는 `--provider openclaw-http`(기본 `http://127.0.0.1:18789/v1`)로 연결하고, 엔드포인트·모델·인증은 `WUPHF_HERMES_AGENT_*` / `WUPHF_OPENCLAW_HTTP_*` 환경 변수나 설정의 `provider_endpoints`로 덮어쓴다. 팀원 초대는 Tailscale이나 WireGuard 메시 위에서 네트워크를 벗어나지 않거나, Cloudflare quick tunnel로 공개 경로를 여는 두 방식이 있다. 터널은 `POST /api/share/tunnel/start`로 시작하고 trycloudflare URL에 6자리 패스코드를 붙이며, 초대는 1회용이고 24시간 후 만료된다.

전제와 한계

메모리는 백엔드 선택도 API 키도 없이 내장으로 동작한다. 텔레메트리는 PostHog 키가 설정된 경우에만 켜지고, 소스 빌드와 포크는 키 없이 배포되므로 외부로 전송하지 않는다. 제품 분석과 세션 녹화는 각각 독립 토글이며 기본 켜짐이고 언제든 되돌릴 수 있다. 세션 녹화는 입력 필드 전체를 마스킹하고, 쿠키 없이 localStorage만 쓴다. 자체 호스팅 운영자는 `WUPHF_POSTHOG_KEY` / `WUPHF_POSTHOG_HOST`로 자기 PostHog를 지정하거나 키를 비워 완전히 끈다. 공개 터널용 `cloudflared`는 npm 설치에 플랫폼별 SHA256 고정으로 포함된다.

관련 논문 2

유사 도구