0xranx/golembot
요약
GolemBot은 Cursor, Claude Code, Codex와 같은 기존 코딩 에이전트를 Telegram, Discord, Slack 등 다양한 메시징 플랫폼과 연결해 주는 도구입니다. 복잡한 프레임워크 설정 없이 단 한 번의 명령으로 에이전트에게 '몸'을 부여하여, 어디서나 코드를 작성하고 분석할 수 있는 환경을 제공합니다.
핵심 포인트
- Cursor, Claude Code, Codex 등 검증된 코딩 에이전트를 그대로 '두뇌'로 활용 가능
- Slack, Telegram, Discord 등 다양한 커뮤니케이션 채널 및 HTTP 클라이언트와 즉시 연결
- OpenRouter, MiniMax, DeepSeek 등 다양한 LLM 제공자와의 유연한 교체 지원
- 13,000개 이상의 OpenClaw 커뮤니티 스킬과 호환되는 거대한 생태계 보유
- Node.js 환경에서 단 몇 줄의 코드로 제품 내부에 AI 어시스턴트 내장 가능
모든 에이전트(Agent) × 모든 제공자(Provider) × 어디서나
**13,000개 이상의 OpenClaw 커뮤니티 스킬 (skills)**과 호환됩니다 — 이는 가장 큰 AI 에이전트 스킬 생태계입니다. 단 한 번의 명령으로 검색하고 설치하세요.
demo.mp4
단 한 번의 명령으로 당신의 코딩 에이전트(Coding Agent)를 Telegram 및 Discord에 연결하세요
Cursor, Claude Code, OpenCode, Codex — 이러한 코딩 에이전트(Coding Agents)들은 이미 코드를 작성하고, 스크립트를 실행하며, 데이터를 분석하고, 복잡한 작업을 추론할 수 있습니다. 하지만 이들은 IDE나 터미널 창 안에 갇혀 있습니다.
GolemBot은 이들에게 몸을 부여합니다. 단 한 번의 명령으로 당신의 코딩 에이전트(Coding Agent)를 Slack, Telegram, Discord, Feishu, DingTalk, WeCom, WeChat 또는 모든 HTTP 클라이언트와 연결할 수 있으며, 어떤 LLM 제공자(LLM provider)와도 함께 사용할 수 있습니다. Claude Code를 OpenRouter를 통해 라우팅하거나, Codex를 MiniMax에서 실행하거나, OpenCode를 DeepSeek으로 지정하세요 — 단 하나의 설정 블록(config block)만으로 코드 변경 없이 가능합니다. 이메일, GitHub Issues 또는 기타 메시지 소스를 연결하기 위해 커스텀 어댑터(custom adapter)를 작성할 수도 있습니다. 또는 단 5줄의 코드로 당신의 제품에 내장할 수도 있습니다. AI 프레임워크도, 프롬프트 엔지니어링(prompt engineering)도 필요 없습니다 — 당신이 이미 가지고 있는 에이전트가 바로 두뇌입니다.
golembot init -e claude-code -n my-bot
golembot gateway # Slack, Telegram, Discord, Feishu, DingTalk, WeCom, WeChat
그룹 채팅에서 동료들이 봇(@)을 호출하세요. 봇은 코드를 작성하고, 파일을 분석하며, 질문에 답할 수 있습니다 — 그 뒤에는 단순한 API 래퍼(wrapper)가 아닌 실제 코딩 에이전트(Coding Agent)가 있기 때문입니다.
import { createAssistant } from 'golembot';
const bot = createAssistant({ dir: './my-agent' });
for await (const event of bot.chat('Analyze last month sales data')) {
...
Slack 봇, 내부 도구, SaaS 제품, 고객 지원 — Node.js를 사용하는 것이라면 무엇이든 내장할 수 있습니다.
| GolemBot | 전통적인 AI 프레임워크 (Traditional AI Frameworks) | |
|---|---|---|
| AI 브레인 (AI brain) | Cursor / Claude Code / OpenCode / Codex — 검증된 전체 코딩 능력 | LLM API와 도구들을 처음부터 직접 연결해야 함 |
| 설정 (Setup) | golembot init → 완료 | Chains, RAG, 벡터 DB (vector DB), 프롬프트 튜닝 (prompt tuning) 등... |
| 자동 업그레이드 (Auto-upgrade) | 에이전트가 똑똑해지면? 당신의 어시스턴트도 똑똑해집니다. 코드 변경은 전혀 필요 없습니다. | 모든 것을 직접 유지 관리해야 함 |
| 투명성 (Transparency) | 디렉토리를 ls 하면 어시스턴트가 무엇을 알고 무엇을 하는지 볼 수 있음 | 블랙박스 파이프라인 (Black box pipelines) |
| 엔진 종속성 (Engine lock-in) | 설정의 한 줄만 바꾸면 엔진을 교체할 수 있음 | 모든 것을 다시 작성해야 함 |
| 제공자 자유도 (Provider freedom) | 4개의 엔진 × 모든 제공자 — OpenRouter, MiniMax, DeepSeek, SiliconFlow. 단 하나의 설정 블록으로 가능. | 프레임워크당 하나의 LLM 제공자에 종속됨 |
| 기술 (Skills) | ClawHub의 13,000개 이상의 커뮤니티 기술을 명령어 하나로 설치 | 도구와 프롬프트를 처음부터 직접 작성해야 함 |
| 예약 작업 (Scheduled tasks) | 내장된 cron 스케줄러 — 데일리 스탠드업, 의존성 감사, 테스트 보고서를 IM으로 전송 | 직접 작업 시스템을 구축해야 함 |
| 멀티모달 (Multimodal) | IM의 이미지 메시지 → 디스크에 저장 → 에이전트가 읽고 분석. 7개 채널 모두 지원. | 플랫폼 API를 직접 파싱해야 함 |
npm install -g golembot
mkdir my-bot && cd my-bot
golembot onboard # 가이드형 설정 (권장)
...
긴 작업이 아직 실행 중인가요? /stop을 사용하세요.
REPL 또는 IM에서는, assistant.cancel(sessionKey?)를 사용하거나,
코드에서는, 또는 HTTP를 통해 POST /abort를 호출하여 세션 기록을 지우지 않고 현재 작업을 취소할 수 있습니다.
모든 golembot gateway 인스턴스에는 실시간 메트릭(metrics), 채널 상태, 빠른 테스트 콘솔을 보여주는 내장 웹 대시보드(Dashboard)가 포함되어 있습니다.
여러 개의 봇을 실행 중인가요? golembot fleet serve를 사용하면 이들을 하나의 플릿 대시보드(Fleet Dashboard)로 통합합니다.
Slack / Telegram / Discord / Feishu / DingTalk / WeCom / WeChat / HTTP API
커스텀 어댑터 (email, GitHub Issues, ...)
│
...
│ Cursor │ Claude Code │ OpenCode │ Codex │ │
| Skill Injection │ .cursor/skills/ │ .claude/skills/ + CLAUDE.md │ .opencode/skills/ + opencode.json │ AGENTS.md at workspace root │
| Session Resume │ --resume │ --resume │ --session │ exec resume <thread_id> │
| API Key │ CURSOR_API_KEY │ ANTHROPIC_API_KEY │ Depends on Provider │ CODEX_API_KEY (preferred) / ChatGPT OAuth │
| Runtime Mode │ --force --trust --sandbox disabled │ `--dangerously-skip-permissi
포맷이 100% 호환되므로, 13,000개 이상의 모든 커뮤니티 스킬 (skills)이 즉시 작동합니다.
golembot skill search "data analysis" # 스킬 검색
golembot skill add clawhub:data-analysis # 명령어 하나로 설치
에이전트 기반 스킬 검색 (Agent-powered skill discovery): 사용자의 에이전트 (agent)가 대화 중에 자율적으로 스킬을 검색하고 설치할 수 있습니다. 에이전트에게 "좋은 코드 리뷰 스킬을 찾아줘"라고 요청하면, 에이전트가 ClawHub를 검색하여 결과를 보여주고 사용자의 확인을 거쳐 설치합니다.
모든 스킬 명령어는 프로그래밍 방식의 접근 (programmatic access)을 위해 --json 옵션을 지원합니다. 플러그형 레지스트리 인터페이스 (pluggable registry interface)는 ClawHub 이외의 추가적인 스킬 소스 (skill sources)를 지원합니다.
FROM node:22-slim
RUN npm install -g golembot
WORKDIR /assistant
...
git clone https://github.com/0xranx/golembot.git
cd golembot
pnpm install
...
기여를 환영합니다! 가이드라인은 CONTRIBUTING.md를 참조해 주세요.
AI 자동 생성 콘텐츠
본 콘텐츠는 GitHub Claude Ecosystem의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기