GolemBot

这个 Agent 能做什么，适合哪些场景？

GolemBot 是一个 TypeScript 编写的网关型 Agent 壳层：它本身不做推理，而是把你已有的 Coding Agent（Cursor、Claude Code、OpenCode、Codex）作为大脑，通过统一接口暴露到 Slack、Telegram、Discord、飞书、钉钉、企业微信、微信或任意 HTTP 客户端。核心入口是 createAssistant()，配合 golem.yaml 单一配置文件定义引擎、provider 路由与各渠道凭据；golembot gateway 会同时启动渠道适配器、HTTP 服务与内置 Dashboard，golembot fleet serve 则可聚合多个实例。它遵循 SKILL.md 技能格式，兼容 ClawHub 上 13,000+ 社区技能，并内置 cron 定时任务与多模态图片处理。四种引擎的 StreamEvent 接口一致，切换引擎只需改配置，无需改代码。

golembot init -e <engine> -n <name> 生成 golem.yaml 与 skills/ 目录；golembot run 进入 REPL 对话；golembot gateway 拉起渠道适配器（Slack、Telegram、Discord、飞书、钉钉、企业微信、微信、HTTP API）并调用 createAssistant() 把消息转发给所选引擎 CLI，流式返回事件（event.type 为 text 等）。它把 provider 配置（baseUrl、apiKey、model）注入引擎，从而把 Claude Code 路由到 OpenRouter、把 Codex 跑在 MiniMax、把 OpenCode 指向 DeepSeek。IM 中的图片消息会落盘供 Agent 读取分析；内置 cron 可把日报、依赖审计、测试报告推送到 IM。/stop、assistant.cancel(sessionKey?)、POST /abort 可中断长任务但保留会话历史；golembot skill search 与 golembot skill add clawhub:... 负责技能发现与安装，全部支持 --json。

1. 团队已在用 Claude Code 或 Codex，希望同事在 Slack/飞书群里 @ 机器人就能让它改代码、查文件、答疑。
2. 想把内部 Coding Agent 能力嵌进自家 SaaS 或客服系统，用 createAssistant() 以数行 Node.js 代码接入。
3. 需要把 Codex 或 Claude Code 换到更便宜或区域可用的服务商（OpenRouter、MiniMax、DeepSeek、SiliconFlow）而不改代码。
4. 运维/研发团队希望用 cron 定时跑依赖审计或测试报告并自动推送到 IM 频道。
5. 在 Discord 或 Telegram 社区里提供一个能读图、能执行脚本的助手。
6. 自建 HTTP 客户端（如邮件、GitHub Issues 适配器）作为消息源接入同一个 Agent 大脑。

如何安装或部署这个 Agent？

需要 Node.js >=18，并事先安装好至少一个引擎 CLI（Cursor、Claude Code、OpenCode 或 Codex）及其凭据。

全局安装：

npm install -g golembot

创建项目并初始化：

mkdir my-bot && cd my-bot
golembot onboard      # 引导式配置（推荐）

或手动初始化：

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

Docker 部署：

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

如何使用这个 Agent？

在 golem.yaml 中配置引擎、provider 与渠道，敏感字段支持 ${ENV_VAR}：

name: my-assistant
engine: claude-code

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

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

gateway:
  port: 3000
  token: ${GOLEM_TOKEN}

本地对话与网关启动：

golembot run
golembot gateway
golembot fleet ls

在自有代码中嵌入：

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);
}

技能与中断：

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

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

这个 Agent 有哪些优点和局限？

这个 Agent 与同类方案有什么区别？

与相关度最高的同类 agent 并排比较关键指标。

FollowAgents 如何评估这个 Agent？

常见问题