Zylos

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

为你的 AI 注入生命。

中文

---

LLM 虽然天才，但每次会话开始时都像得了健忘症——没有昨天的记忆，无法主动联系你，也没有独立行动的能力。

Zylos 为它们注入了生命：拥有重启后依然持久的记忆；拥有在你睡眠时也能工作的调度器；支持通过 Telegram、Lark 或 Web 控制台进行通信；具备自我维护能力，确保一切平稳运行。因为 AI 能够编程，它还能不断进化——构建新技能、集成新服务，与你一同成长。

支持 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 来初始化你的 Agent。

非交互式安装（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 流水线或 cron 任务），系统会自动触发非交互模式。当设置了 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 基础 URL	—
--codex-base-url	Codex 的自定义 API 基础 URL	—
--timezone	IANA 时区，例如 Asia/Shanghai, America/New_York	系统默认
--domain	Caddy 反向代理的域名，例如 agent.example.com	无
--https / --no-https	启用或禁用 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 = 致命错误（如令牌无效），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 <branch-name>

手动安装（若已安装 Node.js >= 20）

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