OpenClaw

注意：本文先於其對應的英文頁面創建，請英文水平較高的翻譯者儘快同步到英文頁面。直到英文頁面足夠完善為止，請編輯人員不要移除此提示，也不要不加選擇地將英文頁面同步到本頁面。

OpenClaw是奧地利程式設計師彼得·斯坦伯格開發的開源AI智能體，用戶可以通過即時通訊工具與其對接，遠程操控電腦實現自動化處理郵件、閱讀文檔、編寫代碼、發布社交媒體內容等工作。

安裝

安裝 openclaw^AUR 軟體包。如需安裝開發版，安裝 openclaw-git^AUR 軟體包。

官方安裝方法

首先，安裝 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。如果你通過 openclaw^AUR 或 openclaw-git^AUR 安裝了OpenClaw，則 bubblewrap 沙盒一般已作為依賴安裝。
在虛擬機中安裝 OpenClaw。
使用 Arch + Windows 雙系統，將重要數據放在 Windows 一側，並儘量不要直接掛載 Windows 所在分區。你甚至可以用 BitLocker 加密 Windows 所在分區以阻止 Arch Linux 掛載 Windows 所在分區。

常見問題

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 找不到命令

常見於使用 nix 安裝的 OpenClaw，或從 nix 遷移到其他安裝方法的 OpenClaw。重啟系統即可解決。

安裝 openclaw-git^AUR 時 prepare 中發生一個錯誤

openclaw-git^AUR 上游的部分文件邏輯已經改變，而打包者仍未更新 PKGBUILD 及 openclaw-patch.sh。SolarAquarion 提供了一個修改後的版本，可以嘗試替換源文件後手動 makepkg。

在即時通訊軟體上向 OpenClaw 發送消息沒有反應

短期解決方法是在 OpenClaw 控制界面提示 OpenClaw 查收即時通訊軟體消息，長期解決方法是讓 OpenClaw 自己診斷並修復。

參見

安裝