OpenClaw · 開源 AI 數字員工
官方推薦安裝方式 | 一鍵腳本部署 | 5 分鐘快速上手
為什麼選擇 OpenClaw？
GitHub 星標超 34.3 萬 · 社區技能超 1.3 萬個
完全本地化
數據存於本地，隱私可控，可私有化部署
全權限執行
讀寫文件、執行命令、瀏覽器操控，真正的數字員工
多渠道接入
支持 WhatsApp、微信、QQ、飛書、釘釘等
模型自由
支持 Kimi、DeepSeek、通義千問、Claude、GPT 等十余家模型
系統要求
操作系統
Windows 10+ / macOS 12+ / Linux (Ubuntu 22.04+ 推薦)
Node.js 版本
需要 Node.js ≥ v22（一鍵腳本會自動安裝）
內存要求
≥ 2GB（推薦 4GB+）
網絡環境
需聯網下載安裝包和依賴
第一步：官方一鍵安裝腳本
這是 OpenClaw 官方最推薦的安裝方式，自動檢測並安裝 Node.js 和所有依賴，無需手動配置環境。
macOS / Linux
curl -fsSL https://openclaw.ai/install.sh | bash執行後如遇權限提示，請輸入 sudo 密碼。腳本會自動完成 Node.js 檢測、安裝和 OpenClaw 配置。
Windows (PowerShell 管理員模式)
以管理員身份打開 PowerShell：
iwr -useb https://openclaw.ai/install.ps1 | iex等待腳本自動完成。
curl -fsSL https://open-claw.org.cn/install-cn.sh | bash驗證安裝
openclaw --version輸出版本號（如 2026.x.x）即安裝成功。
加載環境變量（Mac/Linux 必做）
安裝後，為了讓系統識別 openclaw 命令，需要重新加載 shell 配置：
source ~/.zshrc # Zsh（Mac默認）\nsource ~/.bashrc # Bash第二步：初始化配置向導 (onboard)
安裝完成後，OpenClaw 會自動啟動初始化配置流程。如果配置中斷或需要重新配置，可執行以下命令：
openclaw onboard1. 安全提示頁面
系統會顯示安全提示，告知 OpenClaw 的權限風險。讀取說明後，選擇 Yes 並回車。
2. 模式選擇
推薦選擇 QuickStart（快速啟動） 模式，按回車確認。
3. 選擇 AI 模型提供商
官方推薦 Moonshot AI (Kimi K2.5)，中國用戶選擇 .cn 接入點，也可選 DeepSeek、通義千問等。
4. 配置 API Key
以 Kimi 為例：訪問 platform.moonshot.cn 控製臺，創建 API Key 並粘貼。
5. 選擇聊天渠道
新手建議先選擇 Skip for now，後續使用 TUI 或 Web UI。
openclaw onboard 重新進入向導，或手動編輯配置文件。
openclaw onboard~/.openclaw/openclaw.json第三步：啟動 OpenClaw 網關
啟動服務
openclaw gateway start瀏覽器打開 Web 管理界面：
http://127.0.0.1:18789使用 TUI 快速體驗
openclaw tui直接在終端中對話，按兩次 Ctrl+C 退出。
健康檢查
openclaw doctoropenclaw gateway status常用管理命令速查
| 命令 | 說明 |
|---|---|
openclaw --version | 查看版本號 |
openclaw status | 查看狀態 |
openclaw logs --follow | 實時日誌 |
openclaw gateway restart | 重啟網關 |
openclaw update | 更新版本 |
openclaw config get | 查看配置 |
openclaw skills list | 已安裝 Skills |
openclaw models list | 可用模型列表 |
常見問題
安裝後找不到 openclaw 命令？
檢查 PATH，執行以下命令後重啟終端。
export PATH="$(npm prefix -g)/bin:$PATH"Node.js 版本過低？
使用 nvm 安裝 Node.js 22：
curl -o- https://gitee.com/mirrors/nvm/raw/v0.40.1/install.sh | bashnvm install 22.22.1 && nvm use 22.22.1如何添加聊天渠道？
運行以下命令選擇 QQ、飛書等渠道：
openclaw onboard --install-daemon如何切換其他大模型？
運行以下命令或編輯配置：
openclaw onboard --add-model