本页内容
本页内容
平台概览
ChromeOS
ChromeOS 通过 Crostini 运行 Linux 软件,Google 公开为“Linux 开发环境”的托管 Debian 容器。网关在该容器内运行,与任何其他 Linux 安装完全相同,因此 Linux 指南 完全适用。本页介绍了 ChromeOS 的具体设置以及与普通 Linux 主机不同的问题。
Node 是主要的、默认的和推荐的运行时。 Bun 1.4.3+ 使用 WAL- 重置安全构建 node:sqlite 可以作为显式选择运行 CLI 和网关,并且 Bun 还可以运行包脚本。下面的安装路径使用Node。
启用 Linux 容器
在安装任何内容之前,先启用 Crostini:
- 打开 ChromeOS 设置。
- Go 到 关于 ChromeOS 然后是 开发者。
- 在 Linux 开发环境旁边,选择 设置,然后按照提示操作。ChromeOS 会下载 Debian 容器并打开一个终端。
在该终端中运行以下每条命令。
快速路径
-
通过安装脚本安装(它会为你安装受支持的 Node 版本):
bash -
完成初始化并安装服务:
bash -
确认 Gateway 正在运行:
bash
完整的服务器指南请参阅 Linux 指南 和 Gateway 运行手册。
优先使用原生安装,而不是 Docker
在单用户 Chromebook 上,使用本机 npm 安装(安装程序脚本,或 npm 12 上的 npm i -g openclaw@latest --allow-scripts=openclaw 或 npm 11.16+),而不是 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 版本,并自动配置受支持的版本。
如果你安装了Node之前的自己OpenClaw,升级它前安装OpenClaw:
有关受支持版本,请参阅 Node 安装指南。
提供商密钥和环境变量
Gateway 作为 systemd 用户服务运行,因此在交互式终端中执行的 export VAR=... 不会被已安装的服务继承。
请将提供商密钥放入 ~/.openclaw/.env,每行一个:
然后重启,以便服务读取这些密钥:
有关完整的优先级和来源规则,请参阅环境变量。
Crostini 并不总是处于运行状态
不要将 Crostini 视为始终运行的主机。ChromeOS 重启后,请先打开一次 终端 以启动 Linux 环境,然后再依赖网关。
接着验证服务:
相关内容
- Linux 指南
- 安装概览
- Node 安装指南
- Gateway 运行手册
- 网关配置
- Google:在 Chromebook 上设置 Linux