OpenClaw

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

安装

配置

安装好 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 --fix

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

$ openclaw gateway restart

即可在新系统上使用 OpenClaw。

注意事项

数据安全

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

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

注意：使用在 WSL 上安装的 Arch Linux 运行 OpenClaw 是不安全的。这是因为 WSL 会自动挂载 Windows 的所有磁盘，并且 WSL 上运行的程序对 Windows 的磁盘是完全可读可写的，有可能造成 Windows 上的重要数据被泄露或误删除。如果必须在 WSL 上运行 OpenClaw，可以考虑关闭 WSL 自动挂载。

更新须知

OpenClaw 正处在频繁的开发中，某些版本会修改一些文件导致旧版本配置不能正常使用。建议每次更新后都手动运行一次：

$ openclaw doctor --fix

从而可以自动修复一些配置问题。

常见问题

openclaw^AUR 编译太慢了

openclaw^AUR 编译时使用 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 找不到命令

重启系统即可解决。

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

在控制页面让 OpenClaw 自己诊断并修复即可。

参见

安装

配置

迁移