OpenClaw - Arch Linux 中文维基

跳转到内容

# OpenClaw

来自 Arch Linux 中文维基
注意：本文先于其对应的英文页面创建，请英文水平较高的翻译者尽快同步到英文页面。直到英文页面足够完善为止，请编辑人员不要移除此提示，也不要不加选择地将英文页面同步到本页面。

相关文章

- Node.js

OpenClaw是奥地利程序员彼得·斯坦伯格开发的开源AI智能体，用户可以通过即时通讯工具与其对接，远程操控电脑实现自动化处理邮件、阅读文档、编写代码、发布社交媒体内容等工作。

## 安装

安装 openclawAUR 软件包。如需安装开发版，安装 openclaw-gitAUR 软件包。

### 官方安装方法

首先，安装 nodejs包，npm包 和 git包。其中，nodejs包 可以用其长期支持版本 nodejs-lts-krypton包 或 nodejs-lts-jod包 替代。终端输入：

    curl -fsSL https://openclaw.ai/install.sh | bash

一条语句即可完成整个安装过程。当前两个 AUR 包的表现均不稳定，经常出现各种各样的 bug，使用官方安装方法可以避免 AUR 打包造成的 bug，如果你需要你的 OpenClaw 长时间不间断工作，而不在乎它是否能用 pacman 管理，建议使用官方安装方法。

### 通过 nix 安装

安装 nix包，切换到 unstable 源，然后运行：

    nix-env -iA nixpkgs.openclaw

注意，除非你正在使用 nix 管理其他软件包，否则不建议单独为了 OpenClaw 使用这种安装方法，因为这会导致 nix 下载海量的与 Arch Linux 已有软件包重复的依赖，占用大量磁盘空间。

## 配置

安装好 OpenClaw 之后，通过以下命令运行新手引导：

    openclaw onboard --install-daemon

详细的配置方法详见官方文档。

为了使用 OpenClaw，你需要提前准备一个大模型的 API Key，一个 AI 搜索引擎的 API Key，以及一个即时通讯软件，并且你可能需要为大模型提供商进行适当充值。OpenClaw 兼容的大模型、AI搜索引擎和即时通讯软件会在新手引导中全部列出，如果你没有提前准备，在新手引导过程中选择并注册一个也是可以的。

配置完成后，运行

    openclaw dashboard

即可在浏览器中打开控制 UI 。你也可以把该页面加入浏览器的书签，之后可以通过浏览器直接进入。

## 迁移

如果你重新安装了 Arch Linux，从其他发行版迁移到了 Arch Linux，从 Arch Linux 迁移到了其他发行版，更换了安装方式，或者更换了电脑，那么你都需要进行迁移工作。

首先，在迁移之前，在旧系统的终端运行：

    openclaw gateway stop

停止 OpenClaw 网关运行，以防止迁移过程中数据发生改变。然后，备份家目录下的 .openclaw 目录。之后，在新系统上安装 OpenClaw。如果是同一系统，仅变更安装方式，需要删除旧的软件包以避免冲突。之后，将 .openclaw 目录复制到新系统的家目录。不必运行新手引导，而是直接运行：

    openclaw doctor

程序会自动修复配置文件，原来的数据都会保留，不需要重新配置。之后，在新系统的终端运行：

    openclaw gateway restart

即可在新系统上使用 OpenClaw。

## 注意事项

OpenClaw 需要系统级权限来执行任务，不当使用会造成数据泄露、误删除重要数据、感染病毒等多种风险。一些降低安全风险的方法包括：

- 如果你有两台以上的电脑，专门用一台运行 OpenClaw，其他电脑存放重要数据。（物理隔离，最安全）
- 使用沙盒运行 OpenClaw。如果你通过 openclawAUR 或 openclaw-gitAUR 安装了OpenClaw，则 bubblewrap 沙盒一般已作为依赖安装。
- 在虚拟机中安装 OpenClaw。
- 使用 Arch + Windows 双系统，将重要数据放在 Windows 一侧，并尽量不要直接挂载 Windows 所在分区。你甚至可以用 BitLocker 加密 Windows 所在分区以阻止 Arch Linux 挂载 Windows 所在分区。

## 常见问题

### openclawAUR 编译太慢了

openclawAUR 编译时使用 npm包，而 npm包 官方服务器在国外，国内访问延迟较大。改为使用国内 NPM 镜像可以大大增加下载速度：

    npm config set registry https://registry.npmmirror.com #阿里云镜像

或

    npm config set registry https://mirrors.cloud.tencent.com/npm/ #腾讯云镜像

或

    npm config set registry https://mirrors.tuna.tsinghua.edu.cn/npm/ #清华大学镜像

### Bash 找不到命令

常见于使用 nix 安装的 OpenClaw，或从 nix 迁移到其他安装方法的 OpenClaw。重启系统即可解决。

### 安装 openclaw-gitAUR 时 prepare 中发生一个错误

openclaw-gitAUR 上游的部分文件逻辑已经改变，而打包者仍未更新 PKGBUILD 及 openclaw-patch.sh。SolarAquarion 提供了一个修改后的版本，可以尝试替换源文件后手动 makepkg。

### 在即时通讯软件上向 OpenClaw 发送消息没有反应

短期解决方法是在 OpenClaw 控制界面提示 OpenClaw 查收即时通讯软件消息，长期解决方法是让 OpenClaw 自己诊断并修复。

## 参见

- 官方文档
- 如何解决使用npm安装依赖时遇到卡住不动速度慢的问题，有那些可用的npm源能解决？

分类：​

- 开发
- 人工智能

OpenClaw
添加话题