GolemBot

What does this agent do, and when should you use it?

GolemBot is a TypeScript gateway that wraps an existing coding agent — Cursor, Claude Code, OpenCode or Codex — instead of implementing its own reasoning loop. A single golem.yaml defines the engine, optional provider routing (baseUrl, apiKey, model) and per-channel credentials; golembot gateway then starts channel adapters for Slack, Telegram, Discord, Feishu, DingTalk, WeCom, WeChat and an HTTP API alongside a built-in Dashboard. Applications embed the same brain through createAssistant() and consume streamed events such as event.type === 'text'. It follows the SKILL.md format and is compatible with 13,000+ ClawHub community skills, ships cron scheduling, image handling and task cancellation via /stop, assistant.cancel() or POST /abort. The StreamEvent interface is identical across all four engines, so swapping engines or providers is a config change rather than a rewrite.

golembot init -e <engine> -n <name> scaffolds golem.yaml and a skills/ directory; golembot run opens a REPL conversation; golembot gateway boots channel adapters and HTTP service, routing inbound IM messages through createAssistant() to the chosen engine CLI and streaming back events. Provider settings are injected into the engine, so Claude Code can run through OpenRouter, Codex on MiniMax, or OpenCode against DeepSeek with one config block. Inbound IM images are saved to disk for the agent to read and analyze; the built-in cron scheduler pushes standups, dependency audits and test reports into chat channels. Long-running work can be cancelled without clearing session history via /stop, assistant.cancel(sessionKey?) or POST /abort. golembot skill search and golembot skill add clawhub:<skill> handle skill discovery and installation, all with --json output.

1. A team already using Claude Code or Codex wants colleagues to @ a bot in Slack or Feishu to refactor code and inspect files.
2. A product team wants to embed a working coding agent into their SaaS or support tooling with a few lines of Node.js via createAssistant().
3. An organization needs to move Codex or Claude Code onto a different provider (OpenRouter, MiniMax, DeepSeek, SiliconFlow) without touching code.
4. An engineering team wants cron-driven dependency audits or test reports delivered automatically into a chat channel.
5. A Discord or Telegram community wants an assistant that can read images and run scripts, not just chat.
6. A developer wants to plug a custom message source, such as email or GitHub Issues, into the same agent brain via a custom adapter.

How do you install or deploy this agent?

Requires Node.js >=18 and at least one engine CLI (Cursor, Claude Code, OpenCode or Codex) already installed with its credentials.

Install globally:

npm install -g golembot

Create a project and initialize:

mkdir my-bot && cd my-bot
golembot onboard      # guided setup (recommended)

Or initialize manually:

golembot init -e claude-code -n my-bot

Docker deployment:

FROM node:22-slim
RUN npm install -g golembot
WORKDIR /assistant
COPY . .
EXPOSE 3000
CMD ["golembot", "gateway"]

How do you use this agent?

Configure engine, provider and channels in golem.yaml; sensitive fields accept ${ENV_VAR} references:

name: my-assistant
engine: claude-code

provider:
  baseUrl: "https://openrouter.ai/api"
  apiKey: "${OPENROUTER_API_KEY}"
  model: "anthropic/claude-sonnet-4"

channels:
  slack:
    botToken: ${SLACK_BOT_TOKEN}
    appToken: ${SLACK_APP_TOKEN}
  telegram:
    botToken: ${TELEGRAM_BOT_TOKEN}
  my-email:
    _adapter: ./adapters/email-adapter.js
    token: ${EMAIL_TOKEN}

gateway:
  port: 3000
  token: ${GOLEM_TOKEN}

Talk locally, start the gateway, or list running bots:

golembot run
golembot gateway
golembot fleet ls

Embed it in your own code:

import { createAssistant } from 'golembot';
const bot = createAssistant({ dir: './my-agent' });

for await (const event of bot.chat('Analyze last month sales data')) {
  if (event.type === 'text') process.stdout.write(event.content);
}

Manage skills and cancel long tasks:

golembot skill search "data analysis"
golembot skill add clawhub:data-analysis

curl -X POST http://localhost:3000/abort

What are this agent's strengths and limitations?

How does this agent compare with similar options?

Key facts side by side with the most closely related agents.

How does FollowAgents rate this agent?

FAQ