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	1 つのコマンド (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 – たった 5 行の 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, …)

ゲートウェイはチャネル I/O、HTTP API、およびウェブダッシュボードを処理し、アシスタントコアは選択されたコーディングエンジンにメッセージを単純に転送します。

---

License

MIT – 商用および個人利用が無料。

---

Bottom line – GolemBot は実用的なプラグアンドプレイ層で、強力なコーディングエージェントを常時オンラインのチャットボットに変換し、豊富なスキルマーケットプレイスと任意の LLM プロバイダーを選択する自由を提供します。