> ## Documentation Index
> Fetch the complete documentation index at: https://openclaw.zhcndoc.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Daytona

在 [Daytona](https://www.daytona.io) 云沙盒中运行持久化的 OpenClaw 网关：
这是一个隔离的 Linux 环境，提供 SSH 访问和内置预览 URL，无需管理 VPS。
OpenClaw 已预装在 `daytona-medium` 快照中，因此通过 SSH 连接后即可立即开始设置。

让网关保持在回环地址上，并通过 Daytona 的签名预览 URL 访问控制面板。
不要将网关端口直接暴露到公共互联网。

## 你需要准备的内容

* [Daytona 账户](https://app.daytona.io)（提供免费套餐）
* 从 [Daytona 控制面板](https://app.daytona.io/dashboard/keys) 获取的 Daytona API 密钥
* 模型提供商的 API 密钥（Anthropic、OpenAI 等）

## 安装 Daytona CLI

<Tabs>
  <Tab title="macOS / Linux">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    brew install daytonaio/cli/daytona
    ```
  </Tab>

  <Tab title="Windows">
    ```powershell theme={"theme":{"light":"min-light","dark":"min-dark"}}
    powershell -Command "irm https://get.daytona.io/windows | iex"
    ```
  </Tab>
</Tabs>

验证安装：

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
daytona --version
```

较旧的 CLI 版本缺少较新的沙箱命令；请保持其为最新版本（例如
`brew upgrade daytonaio/cli/daytona`）。

## 身份验证

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
daytona login --api-key=YOUR_API_KEY
```

## 创建沙盒

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
daytona sandbox create --name openclaw --snapshot daytona-medium --auto-stop 0
```

| 标志                          | 用途             |
| --------------------------- | -------------- |
| `--snapshot daytona-medium` | 提供足够的内存余量以运行网关 |
| `--auto-stop 0`             | 让沙盒持续运行，直到手动停止 |

## 通过 SSH 连接

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
daytona ssh openclaw
```

## 运行初始化

在沙箱中通过一条命令配置 OpenClaw：

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw onboard --non-interactive --accept-risk \
  --anthropic-api-key YOUR_ANTHROPIC_KEY \
  --skip-daemon --skip-channels --skip-skills --skip-hooks --skip-health
```

`--skip-daemon` 很重要：Daytona 沙箱不运行服务管理器，因此你需要在下方手动启动 Gateway。将密钥标志替换为你的提供商对应的选项（`--openai-api-key`、`--openrouter-api-key` 等）；`openclaw onboard --help` 会列出所有选项。此处会跳过频道、技能和钩子的配置，稍后再进行配置。

不带标志运行 `openclaw onboard` 会改为启动交互式设置助手，并且需要交互式终端；`openclaw onboard --classic` 会运行较旧的分步向导。

初始化过程会配置 Gateway 身份验证令牌。你可以随时在沙箱中打印该令牌：

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
node -p "require(process.env.HOME + '/.openclaw/openclaw.json').gateway.auth.token"
```

`openclaw config get gateway.auth.token` 返回的是 `__OPENCLAW_REDACTED__`，而不是实际值，因为 CLI 会在输出中隐藏机密信息。

## 允许预览 URL 的来源

Gateway 仅接受来自允许来源的浏览器连接，而 Daytona 的预览代理位于其前面。请在启动 Gateway 之前配置这两项。

在**本地终端**（而不是沙盒 SSH 会话）中，为 Gateway 端口生成一个签名的预览 URL：

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
daytona preview-url openclaw --port 18789
```

复制它输出的 URL。返回沙盒 SSH 会话，允许该来源并信任沙盒内的预览代理，将示例 URL 替换为你自己的 URL：

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw config set gateway.controlUi.allowedOrigins '["PASTE_YOUR_PREVIEW_URL"]'
openclaw config set gateway.trustedProxies '["127.0.0.1"]'
```

请完全按照输出的内容粘贴 URL：仅包含协议和主机，不要带末尾斜杠，也不要带路径。Gateway 会逐字比较浏览器来源，而浏览器发送的是不带末尾斜杠的 `https://host`，因此 `https://host/` 无法匹配，连接会被拒绝。浏览器地址栏通常会显示末尾斜杠，所以请直接从终端复制。

## 启动网关

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
nohup openclaw gateway run > /tmp/gateway.log 2>&1 &
```

网关在后台运行，即使 SSH 连接断开也会继续运行。验证其是否已启动：

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw gateway health
```

该命令会报告网关状态，因此显示 `OK` 意味着可以继续操作。

稍后重启网关（配置更改或更新后）：

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
pkill -f "openclaw gateway" || true
nohup openclaw gateway run > /tmp/gateway.log 2>&1 &
```

## 打开控制面板

在浏览器中打开你之前生成的预览 URL。控制界面在首次连接时
会要求输入网关令牌；粘贴你完成引导后打印出的值。

### 批准你的设备

首次浏览器连接会将设备配对请求加入队列。返回你的
沙箱 SSH 会话：

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
# 列出待处理的请求并复制请求 ID
openclaw devices list

# 批准请求
openclaw devices approve REQUEST_ID
```

## 安全性

访问网关受到三层保护：

| 层级     | 描述                    |
| ------ | --------------------- |
| 预览 URL | 有效期有限的签名 URL（1 小时后过期） |
| 网关令牌   | 通过控制界面连接时必需           |
| 设备批准   | 每个新浏览器或客户端都必须经过明确批准   |

请妥善保管您的网关令牌和预览 URL。网关始终绑定到
回环地址；Daytona 的预览代理负责处理外部访问。

## 频道设置

默认情况下，未知发件人需要配对批准；请参阅
[配对](/channels/pairing)。

### Telegram

使用 [@BotFather](https://t.me/botfather)（`/newbot`）创建机器人，复制
令牌，然后从沙箱 SSH 会话配置 OpenClaw：

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw config set channels.telegram.enabled true
openclaw config set channels.telegram.botToken YOUR_BOT_TOKEN
```

重启网关（见上文），向你的机器人发送私信，然后批准它报告的配对
代码：

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw pairing list telegram
openclaw pairing approve telegram PAIRING_CODE
```

配对代码在 1 小时后过期。完整参考：[Telegram](/channels/telegram)。

### WhatsApp

WhatsApp 作为独立插件提供，因此请先安装并启用它：

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw plugins install clawhub:@openclaw/whatsapp --acknowledge-clawhub-risk
openclaw plugins enable whatsapp
```

安装不会启用插件，因此必须执行 `enable` 步骤；否则网关会将该频道报告为已配置但不受信任。
如果未先安装就运行下面的登录命令，系统会提示你从 ClawHub 或 npm
下载插件。

然后从沙箱 SSH 会话扫描二维码以关联账户：

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw channels login --channel whatsapp
```

在手机上：**设置 → 已关联的设备 → 关联设备**，然后扫描终端中显示的二维码。
关联后重启网关，然后在 WhatsApp 上给自己发送消息，OpenClaw 会在该聊天中回复。

不需要配对批准：未配置允许列表时，关联账户自己的号码默认获准。
配对适用于未知发件人，因此 Telegram 需要配对，而自聊不需要。有关允许列表、
个人号码模式和自聊的详细信息，请参阅：[WhatsApp](/channels/whatsapp)。

## 更新

快照的全局 npm 树归 root 所有，因此直接运行 `openclaw update`
无法写入其中。请从沙箱 SSH 会话中运行：

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
sudo env "PATH=$PATH" npm install --global openclaw@latest
openclaw doctor
```

更新后，`openclaw doctor` 会迁移任何较旧的配置。随后重启
网关（见上文）。

## 停止并恢复沙盒

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
# 停止
daytona sandbox stop openclaw

# 恢复
daytona sandbox start openclaw
```

沙盒状态会在停止/启动周期中保留，但网关进程不会自动启动。恢复后，重新连接并再次启动它：

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
daytona ssh openclaw
nohup openclaw gateway run > /tmp/gateway.log 2>&1 &
```

## 故障排除

### 沙盒重启后网关未运行

网关进程无法在沙盒重启后继续运行。使用
`daytona ssh openclaw` 重新连接，并使用上面的 `nohup` 命令再次启动它。

### 预览 URL 已过期

预览 URL 有时间限制（默认 3600 秒）。从本地终端重新生成，也可以选择更长的有效期：

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
daytona preview-url openclaw --port 18789 --expires 86400
```

每个生成的 URL 都有不同的主机，因此它是一个新的源。重新生成后，使用新的 URL 更新
`gateway.controlUi.allowedOrigins`，然后重启网关，否则控制界面会因“源不被允许”而被拒绝。

### 沙盒自动停止

如果创建沙盒时未使用 `--auto-stop 0`，它会在空闲时自动停止。使用
`daytona sandbox start openclaw` 恢复它。

### 无法访问网关端口

确认网关正在运行并处于监听状态：

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw gateway health
tail -20 /tmp/gateway.log
```

如果更改了网关端口，请将相同的端口传递给 `daytona preview-url`。

## 备注

* 如需以编程方式配置沙箱，请参阅
  [Daytona OpenClaw SDK 指南](https://www.daytona.io/docs/en/guides/openclaw/openclaw-sdk-sandbox/)

## 相关内容

* [网关远程访问](/gateway/remote)
* [网关安全](/gateway/security)
* [更新 OpenClaw](/install/updating)