OpenClaw 新手指南：AI 自動(dòng)化從入門(mén)到精通

一、問(wèn)題：想用 AI 實(shí)現(xiàn)多平臺(tái)自動(dòng)化，但不知從何入手？

你試過(guò)用 AI 接入 WhatsApp、Telegram 或 Discord，卻卡在環(huán)境配置、API 密鑰申請(qǐng)、模型對(duì)接這些環(huán)節(jié)？不是代碼寫(xiě)不出來(lái)，而是光搞清“誰(shuí)調(diào)誰(shuí)”“在哪填什么”就花掉半天。

• 痛點(diǎn) 1：工具繁多，無(wú)從下手
  LangChain、LlamaIndex、AutoGen……每個(gè)框架文檔都像教科書(shū)，但沒(méi)人告訴你：哪個(gè)能直接連上 Telegram 而不改三遍配置？
• 痛點(diǎn) 2：部署復(fù)雜，門(mén)檻高
  本地跑大模型要 CUDA 版本對(duì)齊，調(diào)用云端 API 要處理 rate limit 和 token 過(guò)期，一個(gè) pip install 后的報(bào)錯(cuò)信息比任務(wù)邏輯還長(zhǎng)。
• 痛點(diǎn) 3：平臺(tái)整合困難
  WhatsApp 需要 Business API 審核，Telegram 用 Bot Token，Discord 要 OAuth2 和 Gateway WebSocket——同一套意圖，在三個(gè)平臺(tái)得寫(xiě)三套膠水代碼。

二、方案：OpenClaw —— 本地化、多平臺(tái)、AI 驅(qū)動(dòng)的自動(dòng)化框架

OpenClaw 是一個(gè)開(kāi)箱即用的 CLI 工具，目標(biāo)很直接：讓你在 10 分鐘內(nèi)讓 AI 在 Telegram 上自動(dòng)回復(fù)，在 20 分鐘內(nèi)把 WhatsApp 消息轉(zhuǎn)成 Slack 通知，全程不碰 Docker、不配反向代理、不申請(qǐng)任何第三方密鑰（除非你主動(dòng)選）。

• 本地化部署：所有數(shù)據(jù)留在你機(jī)器上。沒(méi)有賬號(hào)、不傳日志、不連廠商服務(wù)器。
• 跨平臺(tái)支持：已內(nèi)置 WhatsApp（通過(guò) WebKit 協(xié)議）、Telegram（Bot API）、Discord（Gateway）、Slack（Events API）、LINE、飛書(shū)等 30+ 平臺(tái)。新增平臺(tái)只需寫(xiě)一個(gè) 50 行以?xún)?nèi)的適配器。
• AI 靈活調(diào)度：默認(rèn)走本地 Ollama（llama3:8b），也支持 OpenAI、Anthropic、Groq、DeepSeek 的 API；本地模型路徑可直接填絕對(duì)路徑或 HuggingFace repo id。
• 可定制性強(qiáng)：YAML 定義任務(wù)流，Python 寫(xiě)自定義 action，插件目錄放 .py 文件就能加載。
• 免 API 密鑰起步：Telegram 和 Discord 可零配置啟動(dòng)（只讀模式），WhatsApp 用官方網(wǎng)頁(yè)版掃碼登錄，不依賴(lài)商業(yè)網(wǎng)關(guān)。

三、步驟：OpenClaw 安裝、配置與使用指南

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

確認(rèn)系統(tǒng)滿(mǎn)足：

• 操作系統(tǒng)：Windows 10+、macOS 10.14+、Linux（Ubuntu 18.04+ / Debian 11+ / CentOS 8+）
• Python：3.7+
• 基礎(chǔ)工具：Git、pip（Python 自帶）

# 驗(yàn)證 Git 和 Python
git --version
python --version

不需要手動(dòng)裝 Git 或 Python：Windows 用戶(hù)直接下 Git for Windows，macOS 用戶(hù) brew install git python，Linux 用戶(hù) apt install git python3-pip（Ubuntu/Debian）或 dnf install git python3-pip（Fedora/RHEL）。

2. 安裝 OpenClaw

# 克隆倉(cāng)庫(kù)
git clone https://github.com/your-repo/OpenClaw.git
cd OpenClaw

# 創(chuàng)建并激活虛擬環(huán)境（強(qiáng)烈建議）
python -m venv venv
# Windows：
venv\Scripts\activate
# macOS/Linux：
source venv/bin/activate

# 安裝依賴(lài)
pip install -r requirements.txt

虛擬環(huán)境不是儀式感——OpenClaw 依賴(lài) playwright 和 ollama，和系統(tǒng)全局 Python 沖突概率極高。跳過(guò)這步，大概率卡在 chromium download failed。

3. 配置平臺(tái)（以 Telegram 為例）

1. 打開(kāi) @BotFather，發(fā) /newbot，按提示取名，拿到 token（形如 1234567890:ABCdefGhIJKlmNoPQRstUvwXYZ123456789）
2. 編輯 config.yaml，填入：

telegram:
  token: "1234567890:ABCdefGhIJKlmNoPQRstUvwXYZ123456789"

不用改端口、不用開(kāi) webhook、不用配域名。OpenClaw 默認(rèn)輪詢(xún) Bot API，適合開(kāi)發(fā)調(diào)試。生產(chǎn)環(huán)境再切 long polling 或 webhook。

4. 集成 AI 模型（以本地 Ollama 為例）

先確保 Ollama 已安裝并運(yùn)行（官網(wǎng)下載），然后拉取模型：

ollama pull llama3:8b

再在 config.yaml 中指定：

llm:
  provider: "ollama"
  model: "llama3:8b"
  base_url: "http://localhost:11434"  # 默認(rèn)地址，不用改

如果要用 OpenAI：把 provider 改成 openai，加 api_key 和 model 字段即可。OpenClaw 不校驗(yàn)密鑰格式，輸錯(cuò)只會(huì)報(bào) 401，日志里一眼可見(jiàn)。

5. 編寫(xiě)自動(dòng)化腳本

新建 tasks/greet.yaml：

tasks:
  - name: "Greet User"
    platform: "telegram"
    trigger:
      type: "message"
      pattern: "^hello$|^hi$"
    action:
      type: "reply"
      message: "Hello! How can I assist you today?"

pattern 支持正則，^hello$ 表示精確匹配 hello，不是包含 hello。想響應(yīng) “hey there hello world”，改成 hello（去掉 ^$）就行。

四、驗(yàn)證：測(cè)試你的自動(dòng)化任務(wù)

# 啟動(dòng) OpenClaw（會(huì)自動(dòng)加載 config.yaml 和 tasks/ 下所有 YAML）
python main.py

然后：

• 打開(kāi) Telegram，找到你的 Bot
• 發(fā)送 hello
• 看它是否秒回

如果沒(méi)反應(yīng)：

• 檢查終端有沒(méi)有 Connected to Telegram Bot 日志
• 查看 logs/openclaw.log，常見(jiàn)錯(cuò)誤是 token 復(fù)制漏了末尾字符，或網(wǎng)絡(luò)被公司防火墻攔截（換手機(jī)熱點(diǎn)試試）

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

• Telegram 連不上

  • 復(fù)制 token 時(shí)多了一個(gè)空格（前后 trim 一下）
  • 終端報(bào) 401 Unauthorized → token 錯(cuò)；報(bào) Connection refused → 本地網(wǎng)絡(luò)問(wèn)題；報(bào) 429 Too Many Requests → 別狂刷，等 1 分鐘

• AI 沒(méi)輸出，卡在 loading

  • Ollama 沒(méi)運(yùn)行？執(zhí)行 ollama list 看模型是否存在
  • 用 OpenAI 時(shí) api_key 寫(xiě)在了 gpt: 下層？正確位置是 llm: 下的 api_key
  • 模型太大，內(nèi)存爆了？換 phi3:3.8b 或 tinyllama 試試

• 任務(wù)不觸發(fā)

  • platform 名字拼錯(cuò)了（比如寫(xiě)成 telgram）
  • trigger.pattern 正則語(yǔ)法不對(duì)（用 regex101.com 實(shí)時(shí)驗(yàn)證）
  • tasks/ 目錄沒(méi)放在項(xiàng)目根目錄，或文件后綴不是 .yaml

六、下一步學(xué)習(xí)建議

• 改一個(gè)現(xiàn)有 task：把 message trigger 換成 command，試試 /status 返回當(dāng)前時(shí)間
• 加一個(gè)本地 action：在 plugins/ 下寫(xiě) time_reply.py，def run(context): return f"Server time: {datetime.now()}"，然后在 YAML 里 action.type: "time_reply"
• 串兩個(gè)平臺(tái)：寫(xiě)一個(gè) task，當(dāng) Telegram 收到 @ 開(kāi)頭的消息，自動(dòng)轉(zhuǎn)發(fā)到 Discord 指定頻道（需先配好 Discord 配置）
• 看源碼：core/platforms/telegram.py 只有 120 行，core/llm/ollama.py 60 行——適配新平臺(tái)真沒(méi)那么玄乎

GitHub 倉(cāng)庫(kù)里有完整示例：examples/ 目錄下全是可直接跑的 YAML，包括天氣查詢(xún)、RSS 推送、PDF 總結(jié)。遇到問(wèn)題，先搜 issue，90% 的坑前人踩過(guò)。