Agents-Anywhere

环境要求

• Docker 与 Docker Compose（需支持 compose 子命令）
• 已安装 git，用于克隆仓库
• 端口 5174 未被占用
• 建议与服务端同区域网络（服务器位于中国大陆）

安装与启动步骤

1. 1克隆仓库

   把 Agents-Anywhere 源码下载到本地，后续所有命令都在仓库根目录执行。

   git clone https://github.com/anywhere-labs/Agents-Anywhere.git
   cd Agents-Anywhere

   复制

2. 2启动 Docker 服务

   在仓库根目录运行 Compose，必须先替换示例密码和密钥为强口令，首次会构建镜像。

   POSTGRES_PASSWORD=replace-with-a-strong-password \
   AGENT_SERVER_SECRET=replace-with-a-long-random-secret \
   docker compose -f docker/docker-compose.postgres.yml up --build

   复制

3. 3获取 setup token

   服务启动后查看 Server 容器日志，从中找到首次初始化所需的 setup token。

   docker compose -f docker/docker-compose.postgres.yml logs server

   复制

4. 4完成管理员设置

   浏览器打开本地地址，填入上一步取得的 setup token，创建首位管理员账号。

5. 5连接工作设备

   登录客户端或 Web，Desktop 用本机 Connector，服务器/无图形环境用 Connector CLI 接入。

6. 6配置 Agent 与项目

   在工作设备上配置 Runtime、账号与工作目录，创建或打开会话，再从手机或 Web 访问。

关键配置

如何确认成功

访问 http://127.0.0.1:5174 能打开页面，并在 Server 日志中看到 setup token，即部署成功。

常见问题

注意事项

• 示例密码与密钥必须替换，不要直接使用 README 中的占位值。
• Compose 会一并启动 PostgreSQL、Redis、迁移任务和托管 Web 的 Server。
• 备份与升级请参考 docs/upgrading.md，完整部署步骤见 docker/README.md。
• 自托管与 Cloud 均可使用，客户端登录时填写对应服务地址即可。