项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
技术标签
使用教程
—
环境要求
- Linux 服务器或 Mac(Windows/NAS 需通过 SSH 连接远程 Linux/macOS 安装)
- Claude 订阅,或使用 OpenAI Codex 作为替代运行时(Codex CLI v0.129.0+,推荐 0.146+)
- Node.js 20 或更高版本(安装脚本会自动通过 nvm 安装)
- 手动安装方式需已自备 Node.js >= 20
安装与启动步骤
-
1一键安装 Zylos
在终端执行官方安装脚本,会自动安装 git、tmux、Node.js、zylos CLI 并运行 zylos init 引导配置。
curl -fsSL https://raw.githubusercontent.com/zylos-ai/zylos-core/main/scripts/install.sh | bash -
2非交互式安装
Docker、CI/CD 或无 TTY 的无头服务器可用 -y 加各参数一次完成初始化,-s -- 用于向脚本传参。
curl -fsSL https://raw.githubusercontent.com/zylos-ai/zylos-core/main/scripts/install.sh | bash -s -- -y --setup-token sk-ant-oat01-xxx --timezone Asia/Shanghai --domain agent.example.com --https --caddy --web-password MySecurePass123 -
3手动安装
已装 Node.js >= 20 时可用 npm 全局安装,再单独执行 zylos init 完成初始化,适合已有环境的用户。
npm install -g --install-links https://github.com/zylos-ai/zylos-core zylos init -
4Docker 部署
用官方镜像启动容器,映射 3456 端口并挂载数据卷,通过环境变量传入 Claude 令牌。
docker run -d --name zylos -e CLAUDE_CODE_OAUTH_TOKEN=YOUR_TOKEN_HERE -p 3456:3456 -v zylos-data:/home/zylos/zylos -v claude-config:/home/zylos/.claude ghcr.io/zylos-ai/zylos-core:latest -
5取回控制台密码
Docker 部署时 Web 控制台密码自动生成,用日志命令在 "Web Console" 附近查找。
docker logs zylos | grep -A2 "Web Console" -
6切换 AI 运行时
Claude 与 Codex 可互换,用该命令随时切换,记忆、技能与频道配置都会保留。
zylos runtime codex
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
CLAUDE_CODE_OAUTH_TOKEN | 是 | Claude 设置令牌,sk-ant-oat 开头,用于认证 | sk-ant-oat01-xxx |
ANTHROPIC_API_KEY | 否 | Anthropic API Key,可替代设置令牌认证 | sk-ant-xxxxxxxx |
OPENAI_API_KEY | 否 | 使用 Codex 运行时时提供的 OpenAI API Key | sk-xxxxxxxx |
ZYLOS_RUNTIME | 否 | 选择 AI 运行时,取值为 claude 或 codex | claude |
ZYLOS_DOMAIN | 否 | Caddy 反向代理使用的域名 | agent.example.com |
ZYLOS_WEB_PASSWORD | 否 | Web 控制台登录密码,不设置则自动生成 | MySecurePass123 |
如何确认成功
zylos init 完成后会启动全部后台服务并在 tmux 会话中运行智能体;Docker 部署打开 http://localhost:3456 能进入 Web 控制台即成功。
常见问题
Q:Windows 或 NAS 不受支持怎么办?
A:用 Claude Code 的 SSH 功能连接到远程 Linux/macOS 机器,在远程会话中直接运行安装脚本,由 AI 完成远端配置。
Q:机器上没有 Node.js 可以装吗?
A:可以,安装脚本会自动通过 nvm 安装 Node.js;也可自行用 nvm 安装 24 并设为默认版本,要求 20 以上。
Q:只想装 CLI、暂时不初始化?
A:给安装脚本加 --no-init 参数,仅安装依赖与 zylos CLI,之后随时手动执行 zylos init。
Q:忘记 Web 控制台密码怎么办?
A:Docker 部署可用 docker logs zylos | grep -A2 "Web Console" 查看;也可安装时用 --web-password 指定密码。
Q:Codex 运行时对版本有要求吗?
A:Codex CLI 需 v0.129.0 以上,推荐 0.146+;支持 --no-daemon 的版本会隔离启动,旧版本保持原有启动方式。
注意事项
- 安装脚本会自动安装 git、tmux、Node.js 与 zylos CLI,并自动执行 zylos init 完成初始配置。
- Node.js 需 20+,全局 npm 包与安装它的 Node 版本绑定,安装后请勿随意切换 Node 版本。
- CI、Kubernetes 与共享 E2E 环境建议额外提供 GITHUB_TOKEN,避免共用未认证配额。
- 安装脚本退出码:0 成功,1 致命错误(如令牌无效),2 部分成功(如 Caddy 下载失败但其余正常)。
核心亮点
- 把智能体当团队成员管理,支持多 worker 协作分工,而非单轮问答
- 强调 own-your-data,数据与记忆归自己掌控,降低厂商锁定风险
- 内置 self-evolving 思路,智能体可随使用积累与迭代能力
不足之处
- 项目较新、星标约 1160,生态与文档成熟度仍在早期
- 多智能体协作的稳定性与调试体验有待更多实践验证
适用场景
- 自建个人 AI 助理,长期保存记忆与数据
- 小团队部署多个 AI worker 分担任务与协作
- 开发者基于其基础设施二次开发智能体应用
替代项目
LangChain、AutoGen、CrewAI
同类项目推荐
xinchao-dynamic-mind
开源
给 AI 装上疲惫和欲望,让交互更真实
独立、可自托管的 AI 动态心智状态引擎:驱动力、念头池、疲惫、睡眠与意图。
geo-sleuth
开源
给 AI 装上地理侦探技能,一张照片顺藤摸瓜找到拍摄地
An agent skill that finds where a photo was taken — OpenStreetMap geometry, elevati···
goutoujunshi
开源
先哄情绪再出招,恋爱难题给可执行方案
一个先接住情绪、再分析关系并给出可执行策略的 Codex 恋爱军师,内置心理、法律、社会、人···
deepseek-harness
开源
把 AI 能力拆成乐高积木,拼出你的专属智能体。
DeepSeek Harness: Everything is a Plugin.
