Zylos

Zylos (/ˈzaɪ.lɒs/ 赛洛丝) — 为你的 AI 赋予生命

为你的 AI 赋予生命。

中文

---

LLM 虽然天才，但每次对话开始时都像得了失忆症。它们不记得昨天发生的事，无法主动联系你，也没有独立行动的能力。

Zylos 为 AI 赋予了生命。它提供重启后依然有效的记忆、在你休息时也能工作的调度器、通过 Telegram、Lark 或 Web 控制台进行的沟通能力，以及维持系统运行的自我维护机制。由于它具备编程能力，它还能不断进化——构建新技能、集成新服务，并与你共同成长。

支持 Claude Code (Anthropic) 和 Codex (OpenAI)。与 OpenClaw 生态系统完全兼容。

---

快速开始

前提条件： 一台 Linux 服务器（或 Mac），一个 Claude 订阅（或作为替代运行时的 OpenAI Codex）。

curl -fsSL https://raw.githubusercontent.com/zylos-ai/zylos-core/main/scripts/install.sh | bash

这会安装你所需的一切（git、tmux、Node.js、zylos CLI），并自动运行 zylos init 来初始化你的智能体。

非交互式安装（用于 Docker、CI/CD、无头服务器）

所有 zylos init 的标志（flags）都可以直接通过安装脚本传递。脚本在安装完依赖后，会使用你提供的标志运行 zylos init。

完整示例：

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

何时激活非交互模式？

当没有 TTY 可用时会自动激活——例如 Docker 容器（未使用 -it 参数）、CI 运行器或定时任务。或者当设置了 CI=true 或 NONINTERACTIVE=1 时。注意：在终端中使用 curl | bash 仍然是交互式的（安装脚本会从 /dev/tty 重定向）。若要在终端中强制使用非交互模式，请使用 -y。

标志（Flags）：

标志	描述	默认值
-y, --yes	强制非交互模式（跳过所有提示）	自动检测
-q, --quiet	最小化输出	关闭
--runtime	AI 运行时：claude 或 codex	claude
--setup-token	Claude setup token (以 sk-ant-oat 开头)	—
--api-key	Anthropic API key (以 sk-ant- 开头)	—
--codex-api-key	用于 Codex 运行时的 OpenAI API key (以 sk- 开头)	—
--base-url	Claude Code 的自定义 API base URL	—
--codex-base-url	Codex 的自定义 API base URL	—
--timezone	IANA 时区，例如 Asia/Shanghai, America/New_York	系统默认
--domain	Caddy 反向代理域名，例如 agent.example.com	无
--https / --no-https	启用或禁用 HTTPS	设置域名后默认启用
--caddy / --no-caddy	安装或跳过 Caddy Web 服务器	安装
--web-password	Web 控制台密码	自动生成

环境变量：

在 zylos init 过程中，标志也可以通过环境变量设置。解析顺序：CLI 标志 > 环境变量 > 现有的 .env > 交互式提示。

环境变量	对应标志
ZYLOS_RUNTIME	--runtime
CLAUDE_CODE_OAUTH_TOKEN	--setup-token
ANTHROPIC_API_KEY	--api-key
ANTHROPIC_BASE_URL	--base-url
OPENAI_API_KEY	--codex-api-key
OPENAI_BASE_URL	--codex-base-url
ZYLOS_DOMAIN	--domain
ZYLOS_PROTOCOL (https 或 http)	--https / --no-https
ZYLOS_WEB_PASSWORD	--web-password

退出代码： 0 = 成功，1 = 致命错误（例如 token 无效），2 = 部分成功（例如 Caddy 下载失败，但其余部分已成功）。

安装但不运行初始化

curl -fsSL https://raw.githubusercontent.com/zylos-ai/zylos-core/main/scripts/install.sh | bash -s -- --no-init

安装依赖项和 zylos CLI，但会跳过 zylos init。准备好后请手动运行 zylos init。

从特定分支安装（用于测试）

curl -fsSL https://raw.githubusercontent.com/zylos-ai/zylos-core/main/scripts/install.sh | bash -s -- --branch <分支名称>

手动安装（如果你已经安装了 Node.js >= 20）

npm install -g --install-links https://github.com/zylos-ai/zylos-core
zylos