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
新增話題