手把手教你用 OpenClaw 搭建私有化 AI 助手：從源碼編譯到跨平臺(tái)自動(dòng)化

這篇文章解決什么問(wèn)題？

你有沒(méi)有想過(guò)，如果能有一個(gè) AI 助手，同時(shí)幫你處理 WhatsApp 的客戶消息、Telegram 的群組通知、Discord 的社區(qū)管理，甚至自動(dòng)回復(fù)郵件——而且所有數(shù)據(jù)都跑在你自己的機(jī)器上，不經(jīng)過(guò)任何第三方服務(wù)器？

OpenClaw 就是干這個(gè)的。這個(gè) GitHub 上拿了 150K+ 星標(biāo)的開(kāi)源項(xiàng)目，本質(zhì)上是一個(gè)可自托管的 AI 網(wǎng)關(guān)：它把 Claude、GPT、本地模型（比如 Ollama 跑的 Llama）統(tǒng)一接入，然后通過(guò)各種平臺(tái)的 API 把 AI 能力分發(fā)出去。你可以把它理解成一個(gè)"AI 總機(jī)"，所有平臺(tái)的消息進(jìn)來(lái)，經(jīng)過(guò)你選的模型處理，再把回復(fù)送回去。

為什么不用現(xiàn)成的 SaaS 服務(wù)？三個(gè)原因：數(shù)據(jù)隱私（客戶聊天記錄不外泄）、成本控制（本地模型零 API 費(fèi)用）、靈活定制（想接什么平臺(tái)接什么平臺(tái)）。

環(huán)境準(zhǔn)備

開(kāi)始之前，確認(rèn)你的機(jī)器滿足這些條件：

先檢查 Node.js 版本：

node --version
# 需要 v18.0.0 或更高

如果沒(méi)裝或者版本太低，用 nvm 裝一個(gè)：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc
nvm install 20
nvm use 20

為什么要用 nvm 而不是 apt 裝 Node？ 因?yàn)橄到y(tǒng)包管理器里的 Node 版本通常很舊，而且 nvm 可以讓你在同一臺(tái)機(jī)器上切換多個(gè) Node 版本，后續(xù)維護(hù)方便很多。

再裝 pnpm（OpenClaw 用它管理依賴）：

npm install -g pnpm

從源碼編譯部署

第一步：克隆倉(cāng)庫(kù)

git clone https://github.com/openclaw/openclaw.git
cd openclaw

第二步：安裝依賴并構(gòu)建

pnpm install
pnpm build

pnpm install 會(huì)讀取 package.json，把所有依賴下載到本地。pnpm build 則是把 TypeScript 源碼編譯成 JavaScript，輸出到 dist/ 目錄。

為什么要從源碼編譯而不是直接用 Docker？ 兩個(gè)好處：一是你可以修改源碼定制功能（比如加個(gè)自定義平臺(tái)），二是調(diào)試時(shí)可以直接看源碼定位問(wèn)題。當(dāng)然，如果你只是想快速跑起來(lái)，項(xiàng)目也提供了 Docker 方式：

docker compose up -d

第三步：初始化配置

cp .env.example .env

打開(kāi) .env 文件，核心配置項(xiàng)長(zhǎng)這樣：

# AI 模型配置（至少配一個(gè)）
OPENAI_API_KEY=sk-xxx          # OpenAI / GPT
ANTHROPIC_API_KEY=sk-ant-xxx   # Claude
OLLAMA_BASE_URL=http://localhost:11434  # 本地模型

# 平臺(tái)配置（按需開(kāi)啟）
WHATSAPP_ENABLED=true
TELEGRAM_BOT_TOKEN=your-telegram-token
DISCORD_BOT_TOKEN=your-discord-token

# 服務(wù)端口
PORT=3000

為什么要在 .env 里配而不是直接改代碼？ 因?yàn)?.env 文件會(huì)被 .gitignore 忽略，不會(huì)意外提交到倉(cāng)庫(kù)泄露你的 API Key。這是行業(yè)標(biāo)準(zhǔn)做法。

第四步：?jiǎn)?dòng)服務(wù)

pnpm start

看到這行輸出說(shuō)明啟動(dòng)成功：

?? OpenClaw is running on http://localhost:3000
? Connected platforms: WhatsApp, Telegram
? Active model: Claude 3.5 Sonnet

連接第一個(gè)平臺(tái)：以 Telegram 為例

Telegram 是最容易上手的平臺(tái)，5 分鐘就能跑通。

1. 創(chuàng)建 Telegram Bot

打開(kāi) Telegram，搜索 @BotFather，發(fā)送：

/newbot

按提示輸入名字和用戶名，BotFather 會(huì)給你一個(gè) Token，類似：

7123456789:AAHxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

2. 把 Token 寫(xiě)入配置

TELEGRAM_BOT_TOKEN=7123456789:AAHxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
TELEGRAM_ENABLED=true

3. 重啟服務(wù)

pnpm start

4. 驗(yàn)證

在 Telegram 里找到你的 Bot，發(fā)一條消息："你好，介紹一下你自己"。幾秒后你應(yīng)該收到 AI 回復(fù)。

為什么選 Telegram 做第一個(gè)？ 因?yàn)?Telegram Bot API 是所有主流平臺(tái)里最開(kāi)放、限制最少的。不像 WhatsApp 需要企業(yè)認(rèn)證，也不像微信有嚴(yán)格的反自動(dòng)化機(jī)制。先在這里跑通，再接其他平臺(tái)就有信心了。

接入更多平臺(tái)

OpenClaw 支持 30+ 平臺(tái)，配置方式大同小異。幾個(gè)常用的：

以 Discord 為例，核心步驟：

DISCORD_BOT_TOKEN=your-token-here
DISCORD_ENABLED=true

然后去 Discord Developer Portal 創(chuàng)建應(yīng)用，開(kāi)啟 Message Content Intent，邀請(qǐng) Bot 進(jìn)服務(wù)器。重啟 OpenClaw 就搞定了。

切換 AI 模型

OpenClaw 的架構(gòu)允許你靈活切換模型，甚至針對(duì)不同平臺(tái)用不同模型：

# 全局默認(rèn)模型
DEFAULT_MODEL=claude-3.5-sonnet

# Telegram 用便宜的 GPT-4o-mini
TELEGRAM_MODEL=gpt-4o-mini

# WhatsApp 用本地模型省錢(qián)
WHATSAPP_MODEL=ollama/llama3.1

為什么要分平臺(tái)配模型？ 因?yàn)椴煌瑘?chǎng)景對(duì)質(zhì)量的要求不一樣?？头⑿枰獪?zhǔn)確，用 Claude；群聊閑聊用便宜的 GPT-4o-mini 就夠了；內(nèi)部測(cè)試跑本地模型零成本。

如果要用本地模型，先用 Ollama 拉一個(gè)：

ollama pull llama3.1
ollama serve

確保 Ollama 在 http://localhost:11434 跑著，OpenClaw 就能自動(dòng)調(diào)用。

實(shí)際使用場(chǎng)景

場(chǎng)景一：跨境電商客服自動(dòng)化

把 OpenClaw 接上 WhatsApp Business API，設(shè)置系統(tǒng)提示詞：

你是一個(gè)專業(yè)的電子產(chǎn)品客服，回復(fù)要簡(jiǎn)潔友好。
如果客戶問(wèn)價(jià)格，回復(fù)最新的價(jià)格表。
如果客戶要退貨，引導(dǎo)他們填寫(xiě)退貨表單。

效果：客戶發(fā)消息問(wèn)"這個(gè)耳機(jī)多少錢(qián)？"，AI 自動(dòng)回復(fù)價(jià)格和購(gòu)買(mǎi)鏈接，24 小時(shí)不間斷。

場(chǎng)景二：社群運(yùn)營(yíng)助手

接上 Discord + Telegram，讓 AI 自動(dòng)回答新人常見(jiàn)問(wèn)題，過(guò)濾垃圾消息，每天發(fā)一條社區(qū)日?qǐng)?bào)。

場(chǎng)景三：個(gè)人效率工具

接上郵件，讓 AI 自動(dòng)分類收件箱，把重要郵件摘要發(fā)到你的 Telegram。

常見(jiàn)問(wèn)題

Q: 啟動(dòng)報(bào)錯(cuò) EADDRINUSE 怎么辦？

端口被占了，換個(gè)端口：

PORT=3001

或者殺掉占用進(jìn)程：

lsof -i :3000
kill -9 <PID>

Q: WhatsApp 連不上？

WhatsApp Business API 需要 Meta 審核，個(gè)人號(hào)直接用會(huì)被封。建議先用 Telegram 測(cè)試，確認(rèn)流程跑通再搞 WhatsApp。

Q: 本地模型回復(fù)很慢？

檢查 GPU 是否被識(shí)別：

nvidia-smi

如果沒(méi) GPU，CPU 跑 7B 模型大概 5-10 秒一條回復(fù)，屬于正常現(xiàn)象?？梢該Q更小的模型（如 llama3.1:8b → phi3:mini）。

Q: 多個(gè)平臺(tái)消息會(huì)串嗎？

不會(huì)。OpenClaw 用 conversation_id 隔離每個(gè)會(huì)話，平臺(tái)之間互不干擾。

下一步學(xué)什么？

1. 自定義 Prompt 模板：在 prompts/ 目錄下創(chuàng)建不同場(chǎng)景的提示詞文件
2. 接入更多模型：試試 DeepSeek、Qwen 等國(guó)產(chǎn)模型，性價(jià)比很高
3. 搭建工作流：結(jié)合 Dify 或 Coze，讓 AI 不只是聊天，還能調(diào)用 API、查數(shù)據(jù)庫(kù)
4. 加入社區(qū)：OpenClaw 的 GitHub Discussions 里有很多實(shí)戰(zhàn)案例

相關(guān)教程推薦：

• Dify 工作流搭建入門(mén)
• Ollama 本地模型部署指南
• MCP 協(xié)議配置詳解

有問(wèn)題歡迎在評(píng)論區(qū)留言，或者加入龍蝦社區(qū)交流群一起討論。