AI导哈

AI代理平台

GolemCore Bot是一个为AI原生公司设计的代理平台，支持构建、运行、扩展和检查具有技能、插件、MCP、内存和Hive的通道连接代理。

  • by alexk-dev
  • Java
  • 本地部署
  • 41 星标
  • 更新于
在 GitHub 查看 alexk-dev/golemcore-bot

使用说明

GolemCore机器人

AI原生公司的代理平台——使用技能、插件、MCP、内存和Hive构建、运行、扩展和检查通道连接的代理。

这是什么

GolemCore Bot是基于GolemCore生态系统的人工智能原生公司的代理平台。

使用它来运行通道连接的代理，使用技能、插件和MCP服务器对其进行扩展，并使用内存、延迟跟进、跟踪检查和Hive连接的控制流对其进行操作。

以两种方式使用它：

  1. 运行代理 --在仪表板、Telegram或webhook驱动的流中聊天，然后检查执行、内存和跟踪输出。
  2. 延长运行时间 --添加技能、安装插件、连接MCP服务器、配置路由层以及附加基于Hive的控制和检查。

为什么不同

  • 插件本机运行时 --插件可以贡献工具、渠道、语音提供者和RAG摄入，而不是生活在代理运行时之外。
  • MCP按设计就绪 --技能可以启动MCP服务器，运行时现在包括MCP目录和发现流。
  • 专为长时间运行的工作而构建 --延迟跟进、渐进式内存编排和恢复路径有助于代理继续完成一个回合。
  • 蜂巢连接控制面 --将代理连接到Hive，以执行控制命令、生命周期信号、检查和主机级协调。
  • 可检查的执行 --跟踪、瀑布图和导出的快照使代理行为更容易调试和操作。

快速启动

你需要的

  • 码头工人
  • 至少一个LLM提供程序API密钥

运行已发布的图像

docker pull ghcr.io/alexk-dev/golemcore-bot:latest

docker run -d \
  --name golemcore-bot \
  --shm-size=256m \
  --cap-add=SYS_ADMIN \
  -e STORAGE_PATH=/app/workspace \
  -e TOOLS_WORKSPACE=/app/sandbox \
  -v golemcore-bot-data:/app/workspace \
  -v golemcore-bot-sandbox:/app/sandbox \
  -p 8080:8080 \
  --restart unless-stopped \
  ghcr.io/alexk-dev/golemcore-bot:latest

docker logs -f golemcore-bot

# Health probe:
# curl http://localhost:8080/api/system/health
#
# Compatibility: Docker CMD overrides may still pass Spring Boot args directly:
# docker run ... ghcr.io/alexk-dev/golemcore-bot:latest --server.port=9090

# Open http://localhost:8080/dashboard
# On first start, check logs for the temporary admin password.

打开 http://localhost:8080/dashboard，使用日志中的临时管理员密码登录，然后在“设置”中配置LLM提供程序。

为什么额外的Docker标志？

  • --shm-size=256m 和 --cap-add=SYS_ADMIN 需要 浏览器工具 （剧作家/铬）装在容器里。 看 配置→ 浏览器工具.

可选的后续步骤

  • 在“设置”中启用Telegram以进行基于频道的聊天。
  • 为浏览器、搜索、邮件、天气、语音或RAG支持的工作流安装插件。
  • 连接MCP支持的技能和工具服务器。
  • 加入Hive进行控制平面协调和检查。

需要本地构建、编写设置或生产部署路径？看 快速开始 和 部署.

本地原生应用程序映像包（实验性）

除了Docker和简单的可执行JAR之外，发布工作流现在还发布了一个 本地应用程序映像包 对于当前的OS/架构。

在本地构建

./mvnw clean package -DskipTests -DskipGitHooks=true
npx golemcore-bot-local-build-native-dist

这将在以下位置生成一个存档：

target/native-dist/golemcore-bot-<version>-<platform>-<arch>.tar.gz

里面是什么

应用程序映像包含：

  • 由以下公司生产的小型启动器应用程序 jpackage
  • 捆绑的Java运行时，因此运行提取的应用程序映像不需要单独安装Java
  • 下的常规自更新运行时jar lib/runtime/
  • picocli驱动的本地启动器入口点，具有内置帮助和仅启动器选项
  • 首先指向捆绑的运行时jar的启动器接线

因此，启动顺序变为：

  1. 分阶段更新来自 updates/current.txt，除非捆绑的运行时jar更新
  2. 从应用程序映像中捆绑运行时jar
  3. 遗留Jib/类路径回退

本地启动器选项

本机启动器使用picocli，因此它具有一流的帮助和一小部分特定于启动器的标志。

显示帮助：

./golemcore-bot/bin/golemcore-bot --help

常见选项：

  • web --启动捆绑的Spring Boot运行时所需的命令
  • web --port=<port> --转发 -Dserver.port=<port> 到生成的运行时
  • web --hostname=<address> --转发 -Dserver.address=<address> 到生成的运行时
  • --storage-path=<path> / web --storage-path=<path> --转发 -Dbot.storage.local.base-path=<path>
  • --updates-path=<path> / web --updates-path=<path> --转发 -Dbot.update.updates-path=<path>
  • --bundled-jar=<path> --覆盖捆绑的运行时jar路径
  • web -J=<jvm-option> / web --java-option=<jvm-option> --将额外的JVM选项转发到生成的运行时

本机包使用以下命令启动Spring运行时 prod 默认配置文件。

示例：

./golemcore-bot/bin/golemcore-bot web --port=8080 --hostname=0.0.0.0
./golemcore-bot/bin/golemcore-bot web -J=-Xmx1g --port=9090
./golemcore-bot/bin/golemcore-bot --storage-path=/srv/golemcore/workspace web --updates-path=/srv/golemcore/updates

Spring运行时参数仍然有效

未知参数将原封不动地转发到Spring Boot，因此现有的应用程序参数将继续工作：

./golemcore-bot/bin/golemcore-bot web --server.port=9090
./golemcore-bot/bin/golemcore-bot web --spring.main.banner-mode=off
./golemcore-bot/bin/golemcore-bot web -Dlogging.level.root=INFO

如果你想明确拆分，你也可以使用 -- 在Spring争论之前：

./golemcore-bot/bin/golemcore-bot web --port=9090 -- --spring.main.banner-mode=off

为什么这很重要

这使现有的自我更新模型基于以下内容：

  • updates/current.txt
  • updates/jars/

同时也让bot从具有记录的启动器参数的本地捆绑包中干净地启动。

首次运行设置

  1. 打开仪表板。
  2. 在“设置”中至少添加一个LLM提供程序密钥。
  3. 验证存储和沙盒卷是否已装载，以便会话、技能和运行时配置得以保留。
  4. 您可以选择启用Telegram、安装插件、连接MCP支持的技能或加入Hive。

有关运行时配置详细信息、存储布局以及浏览器或沙盒注释，请参阅 配置.

文档

文件网站：https://docs.golemcore.me/

以下源文档保存在此仓库中，供本地和离线参考：

  1. 快速开始
  2. 技能
  3. 工具
  4. MCP集成
  5. 模型路由
  6. 记忆 + 检索增强生成
  7. 自动模式 + 延迟动作设计
  8. Hive集成
  9. 网络钩子
  10. 部署
  11. 仪表盘

贡献/支持/许可

  • 贡献：见 贡献.md （工作流程、质量门、测试）。
  • 常见问题解答： 常见问题.md.
  • 问题：https://github.com/alexk-dev/golemcore-bot/issues
  • 许可证： Apache 2.0 --看 许可证 和 通知.

⭐ 如果你觉得这个仓库有用，就把它标上！

由...制作☕ 和🤖

相关 MCP