跳到主要内容

快速开始

从全新克隆到跑起一个 Manor AI 工作区的最短路径。镜像在本地就绪后,预计 5-10 分钟。

按路径操作查看配置

完成本指南后,你将拥有:

  • 打开在 http://localhost:18080 的 Manor AI Web 应用。
  • 已登录的本地演示账号。
  • 运行中的 API、worker、PostgreSQL、Redis、MinIO 和沙箱服务。
  • 已配置的模型提供商密钥,Agent 可以回答问题。

开始之前​

安装:

依赖版本要求用途
Docker Composev2启动自托管服务栈
Python3.11+本地脚本、检查与开发工具
Node.js20+构建 Web 应用与文档
Git最新稳定版克隆与更新仓库

共享部署前请先修改密钥。默认 .env.example 仅供本地评估;可从公网访问 的部署必须为 JWT_SECRET_KEY、MinIO 凭据和所有 OAuth client secret 设置强随机值。

5 分钟路径​

步骤命令或页面应该看到什么
1克隆仓库本地的 manor-ai 检出
2启动 Docker Compose核心容器变为 healthy
3打开 Web 应用localhost:18080 的登录页
4登录演示账号进入工作区界面
5添加模型密钥聊天或 Agent 能回答简单提示词

1. 克隆​

git clone https://github.com/manor-os/manor-ai.git
cd manor-ai
cp .env.example .env

2. 启动服务栈​

docker compose up --build -d

3. 打开 Manor AI​

打开:

http://localhost:18080

自托管模式默认预置一个本地演示账号:

demo@manor.local / manor-demo

4. 配置模型提供商​

打开设置,为你想使用的模型路径添加提供商密钥。自托管模式下 Manor AI 采用 BYOK(自带密钥);模型凭据只保存在你自己的部署中。

5. 冒烟测试​

打开聊天或 Agents 页,发一条简短提示词。如果界面正常但模型不回答,先检查 提供商配置。

验证服务​

docker compose ps
docker compose logs api --tail=100
docker compose logs worker --tail=100
docker compose logs web --tail=100

预期的核心服务状态:

  • PostgreSQL 和 Redis 处于 healthy。
  • API 在配置的端口上可达。
  • Web 应用正常提供 React 工作区界面。
  • worker 正在运行后台任务。
  • MinIO 对象存储可用。
  • 若启用了 Agent 代码执行,沙箱服务可用。

常见本地问题​

现象排查方向
登录页打不开docker compose ps,然后 docker compose logs web --tail=100
API 返回 500docker compose logs api --tail=100 与数据库健康状态
Agent 不回答模型提供商密钥、模型名称、提供商网络可达性
文件或文档报错MinIO 凭据与存储配置
沙箱工具失败Docker socket 权限与 SANDBOX_SERVICE_URL
端口被占用修改 docker-compose.yml 中的宿主端口映射,或停掉冲突服务

下一步​