OpenClaw 是一個(gè)開(kāi)源的、可自行托管的 AI 助手平臺(tái)，它可以連接到 LLM 提供商（如 OpenAI、Claude、Gemini），也可以通過(guò) Ollama 在本地運(yùn)行。安裝過(guò)程通常只需約 5 分鐘，適用于 macOS、Linux 和 Windows（通過(guò) WSL2）。
本指南將帶你了解從系統(tǒng)要求到安裝和配置的全過(guò)程。
系統(tǒng)要求
在安裝 OpenClaw 之前，請(qǐng)確保你的環(huán)境滿(mǎn)足以下要求：
- Node.js 22+
- NPM（Node 包管理器）
- Git
- 操作系統(tǒng)
- macOS
- Linux（Ubuntu、Debian 等）
- 帶有 WSL2 的 Windows
安裝過(guò)程中還需要穩(wěn)定的互聯(lián)網(wǎng)連接。
步驟 1：如何安裝 OpenClaw —— 多種方法
方法 1：通過(guò)安裝腳本安裝（推薦）
最簡(jiǎn)單的安裝方法是使用一鍵安裝腳本。運(yùn)行以下安裝命令：
Mac/Linux 終端：
curl -fsSL https://openclaw.ai/install.sh | bash
Windows 的 PowerShell 或 WSL2 終端：
iwr -useb https://openclaw.ai/install.ps1 | iex
該安裝程序會(huì)自動(dòng)完成以下操作：
- 檢查 Node.js 是否已安裝
- 安裝缺失的依賴(lài)項(xiàng)
- 下載最新版本的 OpenClaw
- 構(gòu)建項(xiàng)目
- 創(chuàng)建默認(rèn)配置文件
安裝通常在 5 分鐘內(nèi)完成。
方法 2：通過(guò) npm 安裝
npm install -g openclaw@latest
這將在你的系統(tǒng)上全局安裝 OpenClaw。然后運(yùn)行以下命令啟動(dòng)配置向?qū)В?/p>
openclaw onboard
方法 3：從源代碼安裝
這種方法讓你完全控制安裝過(guò)程。
克隆倉(cāng)庫(kù)：
git clone https://github.com/openclaw/openclaw.git
cd openclaw
安裝依賴(lài)項(xiàng)：
npm install
構(gòu)建項(xiàng)目：
npm run build
然后正常啟動(dòng) OpenClaw。
方法 4：通過(guò) Docker 安裝
適用于容器化環(huán)境：
git clone https://github.com/openclaw/openclaw
cd openclaw
docker-compose up -d
Docker 安裝適用于：
- VPS 部署
- 云服務(wù)器
- 隔離環(huán)境
步驟 2：驗(yàn)證安裝
安裝完成后，驗(yàn)證 OpenClaw 是否正常工作。運(yùn)行：
openclaw --version
如果安裝成功，終端將顯示已安裝的版本號(hào)。如果出現(xiàn)“command not found”，請(qǐng)重啟終端或檢查 Node.js 是否在系統(tǒng) PATH 中。
步驟 3：運(yùn)行初始設(shè)置向?qū)?/h2>
安裝 OpenClaw 后，運(yùn)行引導(dǎo)向?qū)В?/p>
openclaw onboard
設(shè)置向?qū)⒁龑?dǎo)你完成以下步驟：
- 選擇 AI 模型提供商
- 輸入 API 密鑰
- 配置網(wǎng)關(guān)
- 選擇默認(rèn)工具和插件（AI 模型為必選項(xiàng)）
這個(gè)交互式配置會(huì)自動(dòng)生成所需的配置文件。
步驟 4：?jiǎn)?dòng) OpenClaw 儀表板
引導(dǎo)完成后，啟動(dòng) Web 界面：
openclaw dashboard
打開(kāi)瀏覽器訪問(wèn)：
http://127.0.0.1:18789
現(xiàn)在你可以通過(guò)儀表板與你的 OpenClaw 助手進(jìn)行交互。
可選工具和插件連接
1. 連接消息通道
OpenClaw 可以與消息平臺(tái)集成，作為聊天機(jī)器人運(yùn)行。支持的通道包括：
- Telegram
- Discord
- Slack
例如，連接 Telegram 的步驟：
- 通過(guò) BotFather 在 Telegram 中創(chuàng)建一個(gè)機(jī)器人
- 獲取機(jī)器人令牌
- 運(yùn)行：
openclaw channels login telegram
- 出現(xiàn)提示時(shí)粘貼令牌
設(shè)置完成后，發(fā)送給機(jī)器人的消息將由 OpenClaw 處理。
2. 選擇 AI 模型提供商
OpenClaw 需要一個(gè)后端 AI 模型。你可以選擇云 API 或本地模型。
云 API 提供商：
- OpenAI（GPT 模型）
- Anthropic Claude
- Google Gemini
這些需要 API 密鑰。
本地模型（可選）： 你可以使用 Ollama 在本地運(yùn)行模型，實(shí)現(xiàn)完全離線的 AI 體驗(yàn)。
其他模型包括：
- Llama
- Mistral
- Kimi
使用本地模型可以避免 API 費(fèi)用，但需要更強(qiáng)的硬件配置。
3. 集成 ComPDF 技能，實(shí)現(xiàn) PDF 處理
為了增強(qiáng) OpenClaw 的文檔處理能力，你可以集成文檔處理的Skills，實(shí)現(xiàn)自動(dòng)化的 PDF 處理。
- PDF 轉(zhuǎn)換（PDF/圖片轉(zhuǎn) Word、Excel、PowerPoint、圖片、RTF、CSV、JSON、HTML 等）
- 文檔合并、拆分、旋轉(zhuǎn)、壓縮、添加水印等
結(jié)語(yǔ)
安裝 OpenClaw 非常簡(jiǎn)單，通常只需幾分鐘。最簡(jiǎn)單的方法是使用一鍵安裝腳本，它會(huì)自動(dòng)安裝依賴(lài)項(xiàng)并配置環(huán)境。安裝完成后，你可以運(yùn)行引導(dǎo)向?qū)А?dòng)儀表板，并連接 AI 模型或消息平臺(tái)，構(gòu)建一個(gè)強(qiáng)大的私有化 AI 助手。
