ahmadrosid/nakama

项目介绍

Nakama 是面向团队而非单人操作者的可自托管 AI Agent 平台。用户在类似 ChatGPT 的仪表盘里与 Agent 对话，每个 Agent 都有独立的提示词文件、工具、技能、记忆和消息渠道。项目从第一天就按团队设计：一个服务器承载多个组织，支持邀请、角色，并让不同 Agent 相互隔离。README 把 OpenClaw 和 Hermes Agent 列为同类系统，并把 Nakama 定位为更适合团队的替代方案；系统设计另见 ARCHITECTURE.md。

Agent 可以接入 Telegram、WhatsApp、Discord 和 Slack，也可通过 Composio 连接外部应用。控制中心统一管理 AI 提供商、工具、技能、MCP、插件和集成。服务器首次运行时会要求选择提供商并填写 API key，随后把配置保存到 ~/.nakama/config.ini。

快速使用

最省事的入口是托管云服务：注册账号、创建实例，然后在浏览器里完成首次设置向导，不需要 Bun、Docker 或 VPS，详见 Nakama Cloud。

本地运行需要安装 Bun。在仓库根目录执行：

bun install
bun run dev:web

该命令会启动 Web 应用，必要时自动拉起服务端；打开 http://localhost:3003 即可。只启动服务端可用 bun run dev:server。进入仪表盘后即可创建 Agent 并启用集成。

也可以用一个 Docker 容器本地试用：

docker pull ghcr.io/ahmadrosid/nakama:latest
umask 077
printf 'NAKAMA_SECRETS_KEY=%s\n' "$(openssl rand -base64 32)" > nakama-secrets.env
docker run -d -p 4310:4310 -v nakama-data:/nakama/data --env-file nakama-secrets.env --name nakama ghcr.io/ahmadrosid/nakama:latest

打开 http://localhost:4310。服务端默认监听 http://127.0.0.1:4310，交互式 API 文档位于 http://127.0.0.1:4310/docs。

部署说明

服务器部署建议使用 Compose 而非裸容器：它会固定版本、保留每日加密备份，并可在设置中提供更新按钮。把 NAKAMA_VERSION 设为最新发布版本，并在前面加 HTTPS 代理，参见 部署加固。单容器空闲约占用 200 MB，仅跑服务端时 1 vCPU 和 1 GB 足够；启用渠道 worker 前先看 环境要求。

重置脚本 ./scripts/docker-destroy.sh 会删除数据，并移除所有发布 4310 端口的容器（包括无关容器），使用前请阅读 重置文档。Windows 目前没有公开的安装链接；旧版本中的未签名 MSIX 文件是 Partner Center 上传物，并不可安装，可用性见 桌面端 README。macOS 桌面版可从 desktop releases 获取。

使用约束

本地开发依赖 Bun；Docker 部署需要 Docker，服务器场景推荐配合 Compose。多组织、邀请、角色和 Agent 隔离等团队功能以服务器部署为前提，不是单机桌面用法。渠道集成需要对应平台的服务凭据，Composio 则通过其服务访问外部应用。项目采用 MIT 许可证。

HotRepo 点评

Nakama 在 2026-11-04 当周的 TypeScript 周榜上记录到第 14 名，当周新增 109 Star，总数为 773 Star、129 Fork。这只是一条语言周榜记录，只能说明该周受到关注，不能据此判断持续趋势。它值得关注的点在团队定位：多组织隔离、角色和共享 Agent 配置，使它更像公司级 Agent 工作区，而不是个人聊天客户端。