> ## 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.

# ChromeOS

ChromeOS 通过 **Crostini** 运行 Linux 软件。Crostini 是由 Google 提供的受管理 Debian 容器，被称为“Linux 开发环境”。Gateway 在该容器中的运行方式与其他 Linux 安装完全相同，因此[Linux 指南](/platforms/linux)也完全适用。本页面介绍 ChromeOS 特有的设置，以及与普通 Linux 主机不同的注意事项。

OpenClaw 需要 Node，因为其规范状态存储使用 `node:sqlite`。Bun 可以安装依赖项或运行包脚本，但无法运行 OpenClaw CLI 或 Gateway。

## 启用 Linux 容器

在安装任何内容之前，先启用 Crostini：

1. 打开 ChromeOS **设置**。
2. 前往 **关于 ChromeOS**，然后选择 **开发者**。
3. 在 **Linux 开发环境**旁边，选择 **设置**，然后按照提示操作。ChromeOS 会下载 Debian 容器并打开一个**终端**。

在该终端中运行以下每条命令。

## 快速路径

1. 通过安装脚本安装（它会为你安装受支持的 Node 版本）：

   ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
   curl -fsSL https://openclaw.ai/install.sh | bash
   ```

2. 完成初始化并安装服务：

   ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
   openclaw onboard --install-daemon
   ```

3. 确认 Gateway 正在运行：

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

完整的服务器指南请参阅 [Linux 指南](/platforms/linux) 和
[Gateway 运行手册](/gateway)。

## 优先使用原生安装，而不是 Docker

在单用户 Chromebook 上，请使用原生 npm 安装（安装脚本，或全局执行
`npm i -g openclaw@latest`），而不要使用 [Docker](/install/docker)。

Docker 可以在 Crostini 中运行，但在 Crostini 中使用 Docker 会增加额外的麻烦：如果你使用
Claude Code CLI 作为模型运行时，就必须将其安装并登录在**持久化的容器主目录中**，而容器重建时这个目录很容易丢失。原生安装会将 CLI 及其登录信息直接保存在 Crostini
文件系统中，因此重建 Docker 镜像不会将其删除。

## Node 版本

Crostini 容器中可用的 Node 版本可能低于 OpenClaw 的最低要求。OpenClaw 要求 Node 22.22.3+、Node 24.15+ 或 Node 25.9+；推荐默认使用 Node 26。安装程序脚本会检测缺失或不受支持的 Node 版本，并自动配置受支持的版本。

如果你在安装 OpenClaw 之前自行安装了 Node，请在安装 OpenClaw **之前**升级它：

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
node -v
```

有关受支持版本，请参阅 [Node 安装指南](/install/node)。

## 提供商密钥和环境变量

Gateway 作为 **systemd 用户服务**运行，因此在交互式终端中执行的
`export VAR=...` 不会被已安装的服务继承。

请将提供商密钥放入 `~/.openclaw/.env`，每行一个：

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
DEEPSEEK_API_KEY=your-key-here
```

然后重启，以便服务读取这些密钥：

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

有关完整的优先级和来源规则，请参阅[环境变量](/help/environment)。

## Crostini 并不总是处于运行状态

不要将 Crostini 视为始终运行的主机。ChromeOS 重启后，请先打开一次
**终端** 以启动 Linux 环境，然后再依赖网关。

接着验证服务：

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

## 相关内容

* [Linux 指南](/platforms/linux)
* [安装概览](/install)
* [Node 安装指南](/install/node)
* [网关运行手册](/gateway)
* [网关配置](/gateway/configuration)
* [Google：在 Chromebook 上设置 Linux](https://support.google.com/chromebook/answer/9145439)