ALemonX

August 16, 2026 · View on GitHub

在一个本地工作台中创建、运行、管理和扩展 AlemonJS 机器人；也可以让 AI Agent 在你的确认下协助维护项目。

English · 中文

用户手册 · 一行安装 · Docker 部署 · 命令行 · MCP 文档 · 系统插件开发

ALemonX 工作台：多机器人项目管理、运行配置与 Agent 协作

目录布局

dist/                     前端构建产物（构建时嵌入 alx 二进制，不参与运行期布局）
resources/                运行期资源（构建时嵌入 alx 二进制）
├── templates/            项目模板源（bot/、dev/）
└── packages/             内置工具包（Yarn 嵌入；PM2 等按需用 Yarn 安装）
plugins/                  系统插件目录 (拖入插件即可自动加载)
workspace/                统一工作区（默认 <运行目录>/workspace）
├── templates/            项目模板（首次启动从内嵌模板物化，可编辑）
├── packages/             工具目录（Yarn 物化副本；PM2 首次使用安装到这里，位置固定）
└── bots/                 新建机器人的默认落点

一行安装

macOS、Linux 或 FreeBSD 在终端执行：

curl -fsSL https://raw.githubusercontent.com/lemonade-lab/alemonx/main/scripts/install.sh | sh

Windows 在 PowerShell 执行：

irm https://raw.githubusercontent.com/lemonade-lab/alemonx/main/scripts/install.ps1 | iex

国内用户安装（镜像加速）

raw.githubusercontent.com 与 GitHub Releases 在国内可能不稳定。国内用户推荐通过镜像获取安装脚本，并让脚本优先尝试镜像下载源：

macOS、Linux 或 FreeBSD 在终端执行：

curl -fsSL https://ghfast.top/https://raw.githubusercontent.com/lemonade-lab/alemonx/main/scripts/install.sh | ALX_PREFER_MIRROR=1 sh

Windows 在 PowerShell 执行：

$env:ALX_PREFER_MIRROR='1'; irm https://ghfast.top/https://raw.githubusercontent.com/lemonade-lab/alemonx/main/scripts/install.ps1 | iex

ghfast.top 不可用时，把命令里的域名换成 ghproxy.net 或 gh-proxy.com 即可。安装脚本本身支持 ALX_DOWNLOAD_BASE 环境变量指向自建镜像，并会在当前源失败后自动尝试下一个源。

手动安装

如需手动下载，可从 GitHub Releases 选择对应系统的压缩包：

系统下载文件
Windows x64alx-windows-amd64.zip
Windows ARM64alx-windows-arm64.zip
Windows 32 位alx-windows-386.zip
macOS Apple Siliconalx-darwin-arm64.zip
macOS Intelalx-darwin-amd64.zip
Linux x64alx-linux-amd64.zip
Linux ARM64alx-linux-arm64.zip
Linux ARMv7alx-linux-armv7.zip
Linux 32 位 x86alx-linux-386.zip
Linux ppc64le / s390x / riscv64对应的 alx-linux-<架构>.zip
FreeBSD x64 / ARM64对应的 alx-freebsd-<架构>.zip

国内下载较慢时，可在 GitHub 地址前加镜像前缀，例如 https://ghfast.top/https://github.com/lemonade-lab/alemonx/releases/latest。

Windows 直接运行 alx.exe。macOS / Linux / FreeBSD：

chmod +x alx
./alx

Docker 部署

详细的持久化、认证、更新与安全边界见 Docker 部署文档。

操作可控

完整能力范围与权限边界见 MCP 控制面文档。

文档