alphaclaw

环境要求

• Node.js 22 环境（官方 Dockerfile 基于 node:22-slim）
• npm（用于安装 @chrysb/alphaclaw 包）
• 使用云平台部署时建议至少 8 GB 内存（Railway 需 Hobby 计划）
• Docker 部署需镜像内具备 git、curl、procps、cron、tini

安装与启动步骤

1. 1安装 AlphaClaw

   通过 npm 安装官方包 @chrysb/alphaclaw，即可获得 alphaclaw 命令。

   npm install @chrysb/alphaclaw

   复制

2. 2启动服务

   运行 CLI 启动 AlphaClaw，它会拉起 OpenClaw 环境并进入守护模式。

   npx alphaclaw start

   复制

3. 3设置访问密码

   必须在部署时设置 SETUP_PASSWORD，用它将保护 Setup UI 的访问入口。

   export SETUP_PASSWORD=your-strong-password

   复制

4. 4打开设置向导

   访问部署 URL，欢迎向导会自动完成剩余配置；Settings UI 含 General、Watchdog、Providers、Envars、Webhooks 等页签。

5. 5云平台一键部署

   README 首推 Render 官方模板部署，部署时同样要设置 SETUP_PASSWORD；用代码 RENDER-ALPHACLAW 可兑换 50 美元 Render 额度。

6. 6Docker 方式部署

   按 README 提供的 Dockerfile 构建镜像（node:22-slim，暴露 3000 端口，入口为 tini），再运行容器。

   docker build -t alphaclaw .
   docker run -d -p 3000:3000 -e SETUP_PASSWORD=your-strong-password -e ALPHACLAW_ROOT_DIR=/data alphaclaw

   复制

关键配置

如何确认成功

浏览器访问部署 URL，出现欢迎向导 Setup UI，General 页 Gateway 状态与通道健康显示正常。

常见问题

注意事项

• 云平台部署时必须在部署阶段设置 SETUP_PASSWORD，否则无法进入向导。
• Railway 必须升级到 Hobby 计划并重新部署，保证至少 8 GB 内存。
• Docker 部署时数据根目录由 ALPHACLAW_ROOT_DIR 指定，示例值为 /data。
• README 未提供卸载、升级版本及修改默认端口的命令。