Skip to main content
ChromeOS 通过 Crostini 运行 Linux 软件。Crostini 是由 Google 提供的受管理 Debian 容器，被称为“Linux 开发环境”。Gateway 在该容器中的运行方式与其他 Linux 安装完全相同，因此Linux 指南也完全适用。本页面介绍 ChromeOS 特有的设置，以及与普通 Linux 主机不同的注意事项。 OpenClaw 需要 Node，因为其规范状态存储使用 node:sqlite。Bun 可以安装依赖项或运行包脚本，但无法运行 OpenClaw CLI 或 Gateway。

​
启用 Linux 容器

在安装任何内容之前，先启用 Crostini：
  1. 打开 ChromeOS 设置。
  2. 前往 关于 ChromeOS，然后选择 开发者。
  3. 在 Linux 开发环境旁边，选择 设置，然后按照提示操作。ChromeOS 会下载 Debian 容器并打开一个终端。
在该终端中运行以下每条命令。

​
快速路径

  1. 通过安装脚本安装（它会为你安装受支持的 Node 版本）：
  2. 完成初始化并安装服务：
  3. 确认 Gateway 正在运行：
完整的服务器指南请参阅 Linux 指南 和 Gateway 运行手册。

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

在单用户 Chromebook 上，请使用原生 npm 安装（安装脚本，或全局执行 npm i -g openclaw@latest），而不要使用 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 之前升级它：
有关受支持版本，请参阅 Node 安装指南。

​
提供商密钥和环境变量

Gateway 作为 systemd 用户服务运行，因此在交互式终端中执行的 export VAR=... 不会被已安装的服务继承。 请将提供商密钥放入 ~/.openclaw/.env，每行一个：
然后重启，以便服务读取这些密钥：
有关完整的优先级和来源规则，请参阅环境变量。

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

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

​
相关内容