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 技能市场（13000+ 社区作者技能），使代理能够即时获得新功能。

---

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 提供者的灵活性。