0xranx/golembot

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

What it is – GolemBot 是一個基於 Node.js 的執行階段，讓您可以為現有的「編碼代理」（Cursor, Claude Code, OpenCode, Codex）提供通訊「身體」。透過單一設定檔，您可以將這些代理公開於 Slack、Telegram、Discord、Feishu、DingTalk、WeCom、WeChat 或通用 HTTP API，並可在不變更程式碼的情況下切換底層 LLM 提供者（OpenRouter, MiniMax, DeepSeek, SiliconFlow 等）。

Why it matters – 而不是從頭構建完整的 AI 框架（提示鏈、向量儲存、工具包裝），您只需保留已信任的精緻代理，僅增加與使用者或其他服務溝通所需的膠合層。系統亦整合了 ClawHub 技能市場（13 000+ 社群作者技能），使代理能即時獲得新功能。

---

Core features

Feature	What you get
Multi‑channel gateway	一個指令 (golembot gateway) 會啟動 Slack、Telegram、Discord、Feishu、DingTalk、WeCom、WeChat 的適配器，內建 HTTP API 與網頁儀表板。
Engine‑agnostic	支援 Cursor, Claude Code, OpenCode, Codex。切換引擎僅需變更設定；StreamEvent 介面保持不變。
Provider routing	任何 LLM 提供者都可透過簡單的 provider 區塊使用（OpenRouter, MiniMax, DeepSeek, SiliconFlow 等）。
Skill system	將含有 SKILL.md（及可選腳本）的資料夾放入 skills/，代理即可立即獲得該能力。完全相容於 ClawHub 市場；可透過 golembot skill add … 安裝。
Scheduler	內建 cron 風格工作，用於週期性任務（如每日站會、依賴審計）。
Dashboard & fleet management	即時指標、通道狀態及每個機器人的控制台視圖；golembot fleet serve 可將多個機器人彙總至單一 UI。
Embeddable API	createAssistant({dir}) 會返回一個異步迭代器，僅需幾行程式碼即可在任何 Node.js 應用中使用。
Zero‑code deployment	golembot init 產生骨架，golembot run 啟動 REPL，golembot gateway 啟動服務。提供 Dockerfile 以供容器化運行。

---

Typical use cases

• Team AI teammate – 在團隊的 Slack/Discord 頻道部署能寫程式、執行腳本、回答問題的編碼助理。
• Product integration – 僅需五行 JavaScript，即可在 SaaS 工具或內部儀表板中嵌入助理。
• Skill‑driven automation – 按需安裝社群製作的技能（例如資料分析、程式碼審查、報告生成），或讓代理在對話期間自行探索並安裝技能。
• Multi‑provider flexibility – 只需編輯 golem.yaml，即可在 Claude Code、OpenCode 或 Codex 之間切換，無需重寫機器人。

---

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 是一個實用的即插即用層，將強大的編碼代理轉換為隨時在線的聊天機器人，擁有豐富的技能市場以及自由選擇任何 LLM 提供者的彈性。