**提示:** 选择一个靠近你的区域。常见选项：`lhr`（伦敦）、`iad`（弗吉尼亚）、`sjc`（圣何塞）。

## 2）配置 fly.toml

编辑 `fly.toml` 以匹配你的应用名称和需求：```toml
app = "my-clawdbot"  # Your app name
primary_region = "iad"

[build]
  dockerfile = "Dockerfile"

[env]
  NODE_ENV = "production"
  CLAWDBOT_PREFER_PNPM = "1"
  CLAWDBOT_STATE_DIR = "/data"
  NODE_OPTIONS = "--max-old-space-size=1536"

[processes]
  app = "node dist/index.js gateway --allow-unconfigured --port 3000 --bind lan"

[http_service]
  internal_port = 3000
  force_https = true
  auto_stop_machines = false
  auto_start_machines = true
  min_machines_running = 1
  processes = ["app"]

[[vm]]
  size = "shared-cpu-2x"
  memory = "2048mb"

[mounts]
  source = "clawdbot_data"
  destination = "/data"
```
**关键设置：**

| 设置 | 原因 |
|---------|-----|
| `--bind lan` | 绑定到 `0.0.0.0`，以便 Fly 的代理可以访问网关 |
| `--allow-unconfigured` | 不使用配置文件即可启动（稍后你会创建一个） |
| `internal_port = 3000` | 必须与 `--port 3000`（或 `CLAWDBOT_GATEWAY_PORT`）匹配，用于 Fly 健康检查 |
| `memory = "2048mb"` | 512MB 太小；建议使用 2GB |
| `CLAWDBOT_STATE_DIR = "/data"` | 将状态保存在卷中 |
bash
# 必需：网关令牌（用于非回环绑定）
fly secrets set CLAWDBOT_GATEWAY_TOKEN=$(openssl rand -hex 32)

# 模型提供者 API 密钥
fly secrets set ANTHROPIC_API_KEY=sk-ant-...

# 可选：其他提供者
fly secrets set OPENAI_API_KEY=sk-...
fly secrets set GOOGLE_API_KEY=...

# 频道令牌
fly secrets set DISCORD_BOT_TOKEN=MTQ...

首次部署将构建 Docker 镜像（大约 2-3 分钟）。后续部署会更快。

部署完成后，请进行验证：
bash
fly status
fly logs

## 5) 创建配置文件

通过 SSH 登录到该机器以创建合适的配置文件：
bash
fly ssh console

**注意：** 当 `CLAWDBOT_STATE_DIR=/data` 时，配置文件路径为 `/data/clawdbot.json`。

**注意：** Discord 机器人令牌可以通过以下两种方式之一获取：
- 环境变量：`DISCORD_BOT_TOKEN`（推荐用于敏感信息）
- 配置文件：`channels.discord.token`

如果使用环境变量，则不需要将令牌添加到配置文件中。网关会自动读取 `DISCORD_BOT_TOKEN`。

重启以应用更改：
bash
exit
fly machine restart <machine-id>

或访问 `https://my-clawdbot.fly.dev/`

将你的网关令牌（来自 `CLAWDBOT_GATEWAY_TOKEN`）粘贴进来以进行身份验证。

### 日志
bash
fly logs              # 实时日志
fly logs --no-tail    # 最近的日志

## 故障排除

### "应用未在预期地址上监听"

网关绑定到了 `127.0.0.1` 而不是 `0.0.0.0`。

**解决方法:** 在 `fly.toml` 中的进程命令里添加 `--bind lan`。

### 健康检查失败 / 连接被拒绝

Fly 无法通过配置的端口访问网关。

**解决方法:** 确保 `internal_port` 与网关端口匹配（设置 `--port 3000` 或 `CLAWDBOT_GATEWAY_PORT=3000`）。

### 内存不足 / 内存问题

容器不断重启或被终止。表现：`SIGABRT`，`v8::internal::Runtime_AllocateInYoungGeneration`，或无声重启。

**解决方法:** 在 `fly.toml` 中增加内存配置：
toml
[[vm]]
  memory = "2048mb"```
或更新现有机器：```bash
fly machine update <machine-id> --vm-memory 2048 -y

锁文件位于 `/data/gateway.*.lock`（不在子目录中）。

### 配置未被读取

如果使用 `--allow-unconfigured`，网关会创建一个最小配置。您在 `/data/clawdbot.json` 的自定义配置应在重启后被读取。

验证配置是否存在：```bash
fly ssh console --command "cat /data/clawdbot.json"
```
### 通过 SSH 编写配置文件

`fly ssh console -C` 命令不支持 shell 重定向。要编写配置文件：
bash
# 使用 echo + tee（从本地到远程的管道）
echo '{"your":"config"}' | fly ssh console -C "tee /data/clawdbot.json"

# 或者使用 sftp
fly sftp shell
> put /local/path/config.json /data/clawdbot.json

### 状态未保存

如果在重启后丢失了凭据或会话，说明状态目录正在写入容器文件系统。

**解决方法：** 确保在 `fly.toml` 中设置了 `CLAWDBOT_STATE_DIR=/data`，然后重新部署。
bash
# 获取最新更改
git pull

# 重新部署
fly deploy

# 检查健康状态
fly status
fly logs