0xranx/golembot

GolemBot – Plug‑and‑play AI coding agents for chat platforms

What it is – GolemBot is a Node.js‑based runtime that lets you give existing “coding agents” (Cursor, Claude Code, OpenCode, Codex) a communication “body”. With a single configuration file you can expose any of these agents on Slack, Telegram, Discord, Feishu, DingTalk, WeCom, WeChat, or a generic HTTP API, and swap the underlying LLM provider (OpenRouter, MiniMax, DeepSeek, SiliconFlow, etc.) without changing code.

Why it matters – Instead of building a full AI framework (prompt chains, vector stores, tool wrappers) you keep the sophisticated agent you already trust and only add the glue needed to talk to users or other services. The system also integrates the ClawHub skill marketplace (13 000+ community‑authored skills) so agents can gain new capabilities on‑the‑fly.

---

Core features

Feature	What you get
Multi‑channel gateway	One command (golembot gateway) starts adapters for Slack, Telegram, Discord, Feishu, DingTalk, WeCom, WeChat, plus a built‑in HTTP API and web dashboard.
Engine‑agnostic	Supports Cursor, Claude Code, OpenCode, Codex. Switching engines is just a config change; the StreamEvent interface stays the same.
Provider routing	Any LLM provider can be used via a simple provider block (OpenRouter, MiniMax, DeepSeek, SiliconFlow, etc.).
Skill system	Drop a folder with SKILL.md (and optional scripts) into skills/ and the agent instantly gains that ability. Full compatibility with the ClawHub marketplace; install with golembot skill add ….
Scheduler	Built‑in cron‑style jobs for recurring tasks (e.g., daily stand‑ups, dependency audits).
Dashboard & fleet management	Real‑time metrics, channel status, and a console view per bot; golembot fleet serve aggregates many bots into a single UI.
Embeddable API	createAssistant({dir}) returns an async iterator you can use in any Node.js app with just a few lines of code.
Zero‑code deployment	golembot init scaffolds a bot, golembot run starts a REPL, golembot gateway launches the service. Dockerfile provided for containerised runs.

---

Typical use cases

• Team AI teammate – Deploy a coding assistant that can write code, run scripts, and answer questions directly in the team’s Slack/Discord channel.
• Product integration – Embed an assistant in a SaaS tool or internal dashboard with only five lines of JavaScript.
• Skill‑driven automation – Install community‑made skills (e.g., data‑analysis, code‑review, report generation) on demand, or let the agent discover and install them during a conversation.
• Multi‑provider flexibility – Switch from Claude Code to OpenCode or Codex without rewriting your bot, simply edit golem.yaml.

---

Quick start (from the README)

npm install -g golembot          # install the CLI globally
mkdir my-bot && cd my-bot
golembot onboard                # guided setup (choose engine, provider, channels)
# or manual init
# golem.yaml is created; edit tokens, etc.
golembot run                    # REPL test
golembot gateway                # start IM adapters + HTTP + dashboard

You can also embed it:

import { createAssistant } from 'golembot';
const bot = createAssistant({ dir: './my-agent' });
for await (const ev of bot.chat('Analyze last month sales data')) {
  if (ev.type === 'text') process.stdout.write(ev.content);
}

---

Architecture snapshot

IM platforms (Slack, Telegram, Discord, …) ──► Custom adapters ──► Gateway Service
                                                   │
                                                   ▼
                                            createAssistant()
                                                   │
          ┌─────────────────────┬─────────────────────┬─────────────────────┬─────────────────────┐
          │                     │                     │                     │
        Cursor               Claude Code            OpenCode               Codex
          │                     │                     │                     │
          ▼                     ▼                     ▼                     ▼
   Provider routing (OpenRouter, MiniMax, DeepSeek, …)

The gateway handles channel I/O, HTTP API, and the web dashboard; the assistant core simply forwards messages to the selected coding engine.

---

License

MIT – free for commercial and personal use.

---

Bottom line – GolemBot is a practical, plug‑and‑play layer that turns powerful coding agents into always‑online chat bots, with a rich skill marketplace and the freedom to pick any LLM provider.