xyc999-ai/go-bot
AI 工程用 Go 实现、可自托管的个人 AI Agent,支持网页调研、Office 文件、图片生成与长期记忆,可用 Docker 或阿里云 ECI 运行。
项目介绍
go-bot 是 DeepSeek Harness 的 Go 实现,也是一个自托管的个人 Agent,定位为 Meta Muse、OpenAI dots、Grok Bot 这类消费级产品的开源替代。它可以在本地用 Docker 运行,适合个人使用、开发和测试;也可以在阿里云弹性容器实例(ECI)上部署,每个账号独占一个 Host。
对使用者来说,Agent 把网页检索与 Chromium 浏览器自动化、图片生成与编辑、通过 OfficeCLI 读写 Word/PowerPoint/Excel、跨会话长期记忆和定时提醒组合在一起。对开发者来说,自带 Web UI 只是用于聊天、文件浏览和下载的轻量测试客户端;Controller 提供 HTTP 与 SSE API,可以据此搭建自己的移动端、桌面端或消息渠道界面。
运行结构
系统由三部分组成:Controller 提供 Web UI 和 HTTP API、管理 Host 并转发 HTTP/SSE;Redis 保存账号、设置和 Host 状态;Host 运行 Go Agent,直接调用模型服务,并管理工具、会话记录、记忆、定时任务、附件和工作区。每个账号对应一个独立 Host 容器,打开账号时启动。Host 镜像内置 OfficeCLI、带 Chromium 的 agent-browser、Python 和 Node.js;技能安装在 /root/harness/.dsh/skills/,可以像普通文件一样修改或删除。
快速使用
准备:Docker Engine 或 Docker Desktop(含 Compose 插件)以及 Bash。在仓库根目录执行:
./scripts/start.sh --init-env
./scripts/start.sh
第一条命令生成私有的 .env 和 .env.eci 配置且不覆盖已有文件;第二条读取配置、构建本地 Host 镜像,并用 Compose 启动 Controller 和 Redis。随后打开 本地 Web UI,按名称创建账号——打开账号会启动一个独立的 Host 容器。在 Model settings 里填入 OpenAI 兼容的 Responses 接口地址、API key 和至少一个模型 ID,然后新建会话发消息即可。网页搜索(DeepSeek、智谱或豆包)和图片生成(Seedream、OpenAI Images 或 Google Nano Banana)在 Settings 中配置,具体见 服务商配置文档。
手机访问:在电脑和手机上安装 Tailscale 并登录同一账号,在 Controller 所在电脑执行 tailscale serve --bg --http=8081 http://127.0.0.1:8080,把终端输出的 URL 和账号名填入手机 App。Android APK 在最新 Release 的 Assets 中提供。
使用约束
- 本地 Docker 适合个人开发和测试;ECI 部署需要具备 ECI 权限的 RAM 用户、VPC/vSwitch、放行 TCP 8080 的安全组规则、访问镜像仓库和模型服务的外网出口,可选 NAS 挂载;Host 启动前还需要一个处于 Ready 状态的 ECI 镜像缓存。
- 快速启动只依赖 Docker 和 Bash;Go 1.26+ 仅在构建 ECI 缓存或脱离 Docker 开发时需要,原生运行 Controller 还需 Redis,前端开发需 Node.js 22.12+。
- 关闭浏览器不会停止 Host。在 ECI 上点击 Stop Host 会释放实例;使用容器存储时实例文件随之释放,使用 NAS 存储时文件保留。
- Controller 应置于组织自身的认证访问层之后;模型、搜索和图片服务凭据由部署者提供,并按账号保存。
- 可用
go run ./cmd/controller check --env-file <profile>离线校验配置,用doctor检查运行时(如本地镜像或 ECI 缓存)是否就绪。 - 许可证为 MIT。
扩展方式
可复用流程可以写成带 SKILL.md 的 Skill,放到 Host 的技能目录。新增工具需实现 Go 工具接口并加入 Host 的工具集合,外部 SDK 和 HTTP 调用放在 thirdparty/,运行时、模型、搜索、图片服务商的适配器放在 providers/。自建前端通过 HTTP/SSE API 接入,需要自行处理账号认证,以及预订、支付等操作的用户确认。
HotRepo 点评
go-bot 在 2026-11-20 进入 HotRepo 新项目榜的 Go 语言列表,记录到约 24 小时窗口内新增 48 个 Star。逐小时采样显示,2026-11-19 全天 Star 数从 100 缓慢增至 108,在快照前的最后两个小时才跳到 131 和 150,因此这个名次主要反映尾段的集中增长,而不是全天的匀速积累,项目目前也没有全部语言日榜名次记录,且没有关联的 HN 讨论。技术上值得注意的是 Controller、Redis 与按账号划分的 Host 容器这套拆分,比 README 中的产品对标更具体地说明了自托管架构。
本文由 AI 根据项目 README 生成,更新于 ,以项目官方文档为准。
相关推荐
- davidondrej/superbot自托管的多 AI Bot 协作平台,多个有名字的 Bot 共享一台 Linux VPS 并调用编码 Agent CLI 干活。
- nickvasilescu/bot-hq一个多智能体聊天工作台,每个机器人都是一个 Hermes agent,并在同一台云电脑上拥有独立屏幕。
- 2SinceJuly/SkyDot面向个人和团队的自托管多用户 Agent 工作台,可创建有身份的 AI 伙伴并支持群聊、定时任务、Skills、MCP 与记忆。
- deepseek-ai/deepseek-harnessDeepSeek 开源、以「一切皆插件」架构构建的 AI 智能体运行框架,适合本地运行与扩展智能体的开发者。
- modelcontextprotocol/go-sdkModel Context Protocol 官方 Go SDK,提供构建 MCP 服务端与客户端的包,并包含 JSON-RPC 传输和 OAuth 支持。