GolemCore机器人
AI原生公司的代理平台——使用技能、插件、MCP、内存和Hive构建、运行、扩展和检查通道连接的代理。
  
______________________________________________________________________
这是什么
GolemCore Bot是基于GolemCore生态系统的人工智能原生公司的代理平台。
使用它来运行通道连接的代理，使用技能、插件和MCP服务器对其进行扩展，并使用内存、延迟跟进、跟踪检查和Hive连接的控制流对其进行操作。
以两种方式使用它：
- 运行代理 --在仪表板、Telegram或webhook驱动的流中聊天，然后检查执行、内存和跟踪输出。
- 延长运行时间 --添加技能、安装插件、连接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--
-.tar.gz里面是什么
应用程序映像包含：
- 由以下公司生产的小型启动器应用程序
jpackage - 捆绑的Java运行时，因此运行提取的应用程序映像不需要单独安装Java
- 下的常规自更新运行时jar
lib/runtime/ - picocli驱动的本地启动器入口点，具有内置帮助和仅启动器选项
- 首先指向捆绑的运行时jar的启动器接线
因此，启动顺序变为：
- 分阶段更新来自
updates/current.txt，除非捆绑的运行时jar更新 - 从应用程序映像中捆绑运行时jar
- 遗留Jib/类路径回退
本地启动器选项
本机启动器使用picocli，因此它具有一流的帮助和一小部分特定于启动器的标志。
显示帮助：
./golemcore-bot/bin/golemcore-bot --help常见选项：
web--启动捆绑的Spring Boot运行时所需的命令- `web --port=
--转发 -Dserver.port= ` 到生成的运行时
web --hostname=--转发-Dserver.address=到生成的运行时- `--storage-path=
/ web --storage-path= --转发 -Dbot.storage.local.base-path= `
- `--updates-path=
/ web --updates-path= --转发 -Dbot.update.updates-path= `
- `--bundled-jar=
` --覆盖捆绑的运行时jar路径
web -J=/web --java-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/updatesSpring运行时参数仍然有效
未知参数将原封不动地转发到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.txtupdates/jars/
同时也让bot从具有记录的启动器参数的本地捆绑包中干净地启动。
______________________________________________________________________
首次运行设置
- 打开仪表板。
- 在“设置”中至少添加一个LLM提供程序密钥。
- 验证存储和沙盒卷是否已装载，以便会话、技能和运行时配置得以保留。
- 您可以选择启用Telegram、安装插件、连接MCP支持的技能或加入Hive。
有关运行时配置详细信息、存储布局以及浏览器或沙盒注释，请参阅 配置.
______________________________________________________________________
文档
文件网站：https://docs.golemcore.me/
以下源文档保存在此仓库中，供本地和离线参考：
______________________________________________________________________
贡献/支持/许可
- 贡献：见 贡献.md （工作流程、质量门、测试）。
- 常见问题解答： 常见问题.md.
- 问题：https://github.com/alexk-dev/golemcore-bot/issues
- 许可证： Apache 2.0 --看 许可证 和 通知.
______________________________________________________________________
⭐ 如果你觉得这个仓库有用，就把它标上！
由...制作☕ 和🤖