跳转至

ChromeOS

ChromeOS 通过 Crostini 运行 Linux 软件。Crostini 是一个托管的 Debian 容器，Google 将其作为“Linux 开发环境”提供。Gateway 在该容器内的运行方式与任何其他 Linux 安装完全相同，因此 Linux 指南 完全适用。本页涵盖 ChromeOS 特有的设置，以及与普通 Linux 主机不同的注意事项。

Node 是主要、默认且推荐的运行时。具备 WAL-reset-safe node:sqlite 的 Bun 1.4+ 构建版本，可以显式选择运行 CLI 和 Gateway；Bun 也可以运行 package 脚本。下面的安装路径使用 Node。

启用 Linux 容器

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

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

请在该终端中运行下面的所有命令。

快速路径

  1. 通过安装脚本安装（它会为你安装受支持的 Node）：
curl -fsSL https://openclaw.ai/install.sh | bash
  1. 执行 onboard 命令并安装服务：
openclaw onboard --install-daemon
  1. 确认 Gateway 正在运行：
openclaw gateway status

完整的服务器指南请参阅 Linux 指南 和 Gateway 运行手册。

优先使用原生安装而非 Docker

在单用户的 Chromebook 上，请使用原生 npm 安装方式（安装脚本，或 npm 12 或 npm 11.16+ 上的 npm i -g openclaw@latest --allow-scripts=openclaw），而不是 Docker。在 npm 11.15 及更早版本上，请省略 --allow-scripts=openclaw。

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

Node 版本

Crostini 容器中可用的 Node 版本可能低于 OpenClaw 的最低要求。OpenClaw 要求 Node 24.16+ 或 Node 26.1+；Node 26 是推荐的默认版本。安装脚本会检测缺失或不支持的 Node 版本，并自动安装受支持的版本。

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

node -v

受支持的版本请参阅 Node 安装指南。

Provider 密钥与环境变量

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

请改为将 Provider 密钥放入 ~/.openclaw/.env，每行一个：

DEEPSEEK_API_KEY=your-key-here

然后重启服务，使其加载这些密钥：

openclaw gateway restart

完整的优先级和来源规则请参阅 环境变量。

Crostini 并非始终开启

不要把 Crostini 当作始终在线的宿主机。ChromeOS 重启后，在依赖 Gateway 之前，请先打开一次终端以启动 Linux 环境。

然后验证服务：

openclaw gateway status

本页原文 Markdown：在 AtomGit 查看·内容源自开源项目 cl/openclaw