# 保姆级使用手册

## 通用准备

1. 浏览器访问对应 `https://` 域名（证书由 Caddy 自动签发，首次可能需等 1–2 分钟）。
2. 准备 CleanAI：在设置 / `.env` 中填写  
   - Base URL：`https://api.cleanai.io/v1`  
   - API Key：你的 CleanAI 密钥  
   - 模型：`gpt-6-luna`

---

## 1）Munder Difflin（1munder.ai16.ai）

1. 打开落地页，点击「官网下载」或 GitHub Releases，安装桌面端（macOS / Windows / Linux）。
2. 启动应用 → 设置里添加 OpenAI 兼容端点（同上）。
3. 选择已安装的 CLI Agent（Claude Code / Codex 等）或 CleanAI 模型，开始在「办公室」里派活。

---

## 2）OpenMausBot（2openmaus / 2om）

1. 打开 https://2openmaus.ai16.ai  
2. **首次登录：配对码**（服务器上生成）：
   ```bash
   ssh root@13.140.229.90
   cd /opt/openmausbot/deploy
   docker compose exec omb node dist-server/pair-cli.js
   ```
   按页面提示输入配对码；会话约 30 天。
3. 在 **Settings → Engines** 确认已有「CleanAI gpt-6-luna」（服务端已预置 openai-compat 实例）；若无，按自定义引擎文档添加：
   - driver：`openai-compat`
   - url：`https://api.cleanai.io/v1`
   - model：`gpt-6-luna`
4. 新建 Bot，选 luna，发一条消息验证。

---

## 3）Open Duet（3duet.ai16.ai）

1. 打开 https://3duet.ai16.ai/login/  
2. 使用服务器上设置的**口令（passphrase）**登录（首次由管理员在机器上 `set-passphrase`）。
3. 服务端已预置 **OpenAI-compatible → gpt-6-luna**（Settings → Engines 可核对）。若丢失，按同样三项重填 Base URL / Model / API Key。
4. 创建 Agent / 看板任务，发消息测试。

口令文件位置（仅 root）：`/root/.secrets/openduets_passphrase`（勿外传）。

---

## 4）Rakazo（4rakazu.ai16.ai）

> **DNS：** 若 `4rakazu.ai16.ai` 仍为 NXDOMAIN，请在 Spaceship 加 A 记录到 `13.140.229.90`；容器本身已在本机 `127.0.0.1:5173` 健康运行。

1. DNS 生效并拿到证书后，打开站点 → **注册账号**（`SIGNUPS_ENABLED=true`）。
2. 部署已将 CleanAI 配为 `RAKAZO_LOCAL_MODELS`；注册后在模型列表中应能看到 `gpt-6-luna`。  
   也可在 **Settings → Models → OpenAI-compatible** 再连一次 CleanAI。
3. 创建 Bot，选 luna，发消息；需要电脑时用内置 Docker Computer。

---

## 5）OpenBot（5ob / 5bot / 5openbot）

1. 打开落地页阅读说明。
2. 管理员在服务器执行：
   ```bash
   cd /opt/openbot
   docker compose exec openbot openbot login
   ```
   输入邮箱并完成验证码；服务器会出现在该账号的服务器列表。
3. 用桌面 / 手机 App 或 https://openbot.run/app 连接该服务器。
4. 在 **Providers** 添加 CleanAI + `gpt-6-luna`。

---

## 文档入口

- 服务器：`/opt/ai16-docs/`
- 本机副本：见同目录其他 Markdown
- Web：优先 https://1munder.ai16.ai/docs/ （docs.ai16.ai 需 DNS）