OpenClaw 是什么？簡(jiǎn)單說(shuō)，就是一個(gè)可以讓 AI 住進(jìn)你的 Telegram、管理你的電腦或服務(wù)器、幫你寫(xiě)代碼的開(kāi)源框架。

OpenClaw 是一個(gè)開(kāi)源的 AI 助手框架,支持在 Telegram、電腦或服務(wù)器上運(yùn)行,并且可以擴(kuò)展技能,本文詳細(xì)介紹了從環(huán)境準(zhǔn)備到多 Bot 配置的整個(gè)安裝過(guò)程,包括技能擴(kuò)展和瀏覽器自動(dòng)化等功能,適合喜歡折騰的開(kāi)發(fā)者和需要 AI 助手但不想使用商業(yè)產(chǎn)品的用戶。

聽(tīng)起來(lái)很酷？確實(shí)很酷。但安裝配置的過(guò)程，也確實(shí)有點(diǎn)折騰。

今天我就把整個(gè)安裝過(guò)程記錄下來(lái)，從環(huán)境準(zhǔn)備到多 Bot 配置，從技能擴(kuò)展到自動(dòng)化工作流，一步步帶你走完全流程。

一、環(huán)境準(zhǔn)備：你需要什么？

1.1 系統(tǒng)要求

• 系統(tǒng)： Linux、Windows、macOS 都可以

我的環(huán)境：

由于不敢在生產(chǎn)機(jī)器上直接折騰，我找了一臺(tái)閑置電腦，裝了 Windows + Ubuntu 24.04 雙系統(tǒng)。平時(shí)用 Windows，需要跑 OpenClaw 時(shí)就切換到 Ubuntu。

• 系統(tǒng)：Ubuntu 24.04 LTS
• Node.js：v25.5.0
• AI 服務(wù)：aicodewith.com（國(guó)內(nèi)中轉(zhuǎn)，邀請(qǐng)鏈接：https://aicodewith.com/zh/login?tab=register&invitation=EK1S5F）

1.2 軟件依賴

• Node.js： v20 或 v25（推薦 v25）
• npm/pnpm： 包管理工具
• Chrome/Chromium： 瀏覽器自動(dòng)化需要

1.3 必備資源

• AI API Key： OpenAI、Claude 或國(guó)內(nèi)中轉(zhuǎn)服務(wù)
• Telegram 賬號(hào)： 用來(lái)創(chuàng)建 Bot

二、安裝 OpenClaw

2.1 安裝主程序

在終端中執(zhí)行：

npm install -g openclaw@latest

如果你使用 pnpm：

pnpm add -g openclaw@latest

安裝完成后驗(yàn)證：

openclaw --version

應(yīng)該看到版本號(hào)，比如 2026.1.29。

![截圖：openclaw 版本信息]

2.2 安裝 AICodewith 插件（可選）

如果你使用 AICodewith 服務(wù)（國(guó)內(nèi)中轉(zhuǎn)，支持 GPT、Claude、Gemini），需要安裝插件：

在終端中執(zhí)行：

openclaw plugins install openclaw-aicodewith-auth

然后啟用插件：

openclaw plugins enable openclaw-aicodewith-auth

如果 gateway 正在運(yùn)行，需要重啟一下：

openclaw gateway stop
openclaw gateway run

2.3 配置 API

如果使用 AICodewith：

運(yùn)行認(rèn)證命令：

openclaw models auth login --provider aicodewith-claude --set-default

按提示輸入你的 AICodewith API Key（注冊(cè)地址：https://aicodewith.com/zh/login?tab=register&invitation=EK1S5F）

查看可用模型：

openclaw models list | grep aicodewith

如果使用其他服務(wù)商：

可以在初始化配置時(shí)選擇 OpenAI、Anthropic、Google 等。

2.4 執(zhí)行初始化配置（第一次安裝必須）

啟動(dòng)配置流程：

openclaw onboard --install-daemon

按照向?qū)崾静僮鳎?/p>

• 是否安裝守護(hù)進(jìn)程？ → 選擇 yes
• 配置模式 → 選擇 quick start（快速開(kāi)始）
• 使用已有配置？ → 選擇 使用已有配置（如果有）
• 模型供應(yīng)商 → 如果已配置 AICodewith，選擇 跳過(guò)；否則選擇你的服務(wù)商
• 選擇默認(rèn)模型 → 推薦使用 claude（工具調(diào)用能力最強(qiáng)）
• 聊天渠道 → 暫時(shí) 跳過(guò)，后面再配置 Telegram
• 安裝 Skills → 推薦選擇以下幾個(gè)：
• 按空格選擇，選完后按回車(chē)確認(rèn)
  • rss-reader（監(jiān)控/閱讀博客）
  • openclaw-docs（OpenClaw 文檔）
  • mcporter（管理 MCP 服務(wù)器）
  • obsidian（連接 Obsidian 筆記）
• API Keys → 根據(jù)需要填寫(xiě)（如果暫時(shí)用不到可以都選 no）
• Hooks → 建議全部開(kāi)啟
• 權(quán)限申請(qǐng) → 電腦會(huì)彈出一些權(quán)限申請(qǐng)，都同意即可

配置完成后，系統(tǒng)會(huì)自動(dòng)啟動(dòng) Gateway。

驗(yàn)證運(yùn)行狀態(tài)：

openclaw status

![截圖：openclaw status 輸出]

三、配置 Telegram Bot

OpenClaw 必須配置一個(gè)對(duì)話渠道才能使用。目前推薦使用 Telegram，因?yàn)椋?/p>

• ? 體驗(yàn)最好（創(chuàng)始人就是用 Telegram 控制的）
• ? 支持斜杠命令（/help、/status 等）
• ? 支持內(nèi)聯(lián)按鈕和豐富交互
• ? 注冊(cè)簡(jiǎn)單，手機(jī)掛梯子即可

OpenClaw 支持多個(gè) Telegram Bot 同時(shí)運(yùn)行，每個(gè) Bot 可以有不同的用途。

3.1 創(chuàng)建第一個(gè) Bot

步驟 1：獲取 Telegram Bot Token

1. 在 Telegram 中搜索 @BotFather（官方 Bot 創(chuàng)建工具）
2. 發(fā)送命令：/newbot
3. 按提示設(shè)置 bot 名稱(chēng)和用戶名
4. 獲得 Bot Token（格式：123456789:ABCdefGHIjklMNOpqrsTUVwxyz）

![截圖：BotFather 對(duì)話界面]

步驟 2：?jiǎn)⒂?Telegram 插件

在終端中執(zhí)行（插件默認(rèn)是關(guān)閉的）：

openclaw plugins enable telegram

步驟 3：配置 Bot Token

在終端中執(zhí)行：

openclaw config set channels.telegram.botToken "你的Bot_Token"

將 你的Bot_Token 替換為第一步獲取的 Token。

步驟 4：?jiǎn)?dòng) Gateway

openclaw gateway run

如果報(bào)錯(cuò)，可以先嘗試停止：

openclaw gateway stop
openclaw gateway run

步驟 5：配對(duì)驗(yàn)證

1. 在 Telegram 中找到你的 bot
2. 發(fā)送任意消息
3. Bot 會(huì)返回一個(gè)驗(yàn)證碼（6位數(shù)字）
4. 在終端中執(zhí)行：

openclaw pairing approve telegram 你的驗(yàn)證碼

配對(duì)成功后，你就可以和 Bot 對(duì)話了！

![截圖：Bot 首次對(duì)話]

3.2 配置多個(gè) Bot（可選）

{
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "你的Bot Token",
      "dmPolicy": "pairing",
      "allowFrom": ["你的Telegram用戶ID"],
      "groups": {
        "*": {
          "requireMention": true
        }
      }
    }
  }
}

方法 2：通過(guò)命令行（推薦）

openclaw config patch

然后輸入配置 JSON。

重要配置項(xiàng)說(shuō)明：

• botToken：你的 Bot Token
• dmPolicy：私聊策略
  • pairing：需要配對(duì)驗(yàn)證（推薦）
  • allowlist：只允許白名單用戶
  • open：所有人都能用（不推薦）
• allowFrom：允許的用戶 ID 列表
• groups：群組配置
  • requireMention: true：需要 @Bot 才會(huì)回復(fù)

獲取你的 Telegram 用戶 ID

發(fā)送消息給 Bot 后，查看日志：

openclaw logs --follow

在日志中找到 from.id，那就是你的用戶 ID。

![截圖：日志中的用戶 ID]

3.3 重啟 Gateway

配置修改后，重啟 Gateway：

openclaw gateway restart

或者用配置工具自動(dòng)重啟：

openclaw config patch  # 會(huì)自動(dòng)觸發(fā)重啟

3.4 測(cè)試 Bot

在 Telegram 中：

1. 搜索你的 Bot（比如 @myassistant_bot）
2. 發(fā)送 /start
3. 如果配置了 pairing，會(huì)收到配對(duì)碼
4. 批準(zhǔn)配對(duì)：openclaw pairing approve telegram <配對(duì)碼>

或者，如果你已經(jīng)把用戶 ID 加到 allowFrom，可以直接對(duì)話。

![截圖：Bot 首次對(duì)話]

四、多 Bot 配置（進(jìn)階）

OpenClaw 支持同時(shí)運(yùn)行多個(gè) Bot，每個(gè) Bot 可以有不同的用途。

4.1 為什么要多個(gè) Bot？

• 功能分離： 一個(gè)用于日常對(duì)話，一個(gè)用于寫(xiě)作，一個(gè)用于技術(shù)支持
• 權(quán)限隔離： 不同 Bot 可以分享給不同的人
• 測(cè)試環(huán)境： 一個(gè)生產(chǎn) Bot，一個(gè)測(cè)試 Bot

4.2 配置多賬號(hào)模式

編輯配置文件，使用 accounts 結(jié)構(gòu)：

{
  "channels": {
    "telegram": {
      "accounts": {
        "main": {
          "name": "主Bot",
          "botToken": "第一個(gè)Bot的Token",
          "allowFrom": ["你的用戶ID"]
        },
        "writer": {
          "name": "寫(xiě)作助手",
          "botToken": "第二個(gè)Bot的Token",
          "allowFrom": ["你的用戶ID"]
        },
        "tech": {
          "name": "技術(shù)支持",
          "botToken": "第三個(gè)Bot的Token",
          "allowFrom": ["你的用戶ID"]
        }
      }
    }
  }
}

4.3 實(shí)戰(zhàn)案例：我的四個(gè) Bot

在今天的配置過(guò)程中，我創(chuàng)建了四個(gè) Bot：

1. @fanshu123_bot - 主 Bot，日常使用
2. @mupeilin_bot - 第二個(gè) Bot，測(cè)試用
3. @wujing123_bot - 第三個(gè) Bot，實(shí)驗(yàn)功能
4. @ttxcb_bot - 公眾號(hào)寫(xiě)作助手

每個(gè) Bot 都連接到同一個(gè) OpenClaw 實(shí)例，共享記憶和配置，但有獨(dú)立的對(duì)話歷史。

![截圖：四個(gè) Bot 同時(shí)運(yùn)行]

五、技能擴(kuò)展（Skills）

OpenClaw 最強(qiáng)大的地方在于它的技能系統(tǒng)。你可以創(chuàng)建自定義技能，讓 AI 具備特定的能力。

5.1 什么是 Skills？

Skills 是模塊化的功能包，可以擴(kuò)展 OpenClaw 的能力。每個(gè) Skill 包含：

• SKILL.md - 技能說(shuō)明和使用指南
• scripts/ - 可執(zhí)行腳本
• references/ - 參考文檔
• assets/ - 資源文件

5.2 實(shí)戰(zhàn)：創(chuàng)建圖片生成 Skill

在配置過(guò)程中，我創(chuàng)建了兩個(gè)實(shí)用的 Skill：

Skill 1：image-generator

功能： 使用 Nano Banana Pro (Gemini 3 Pro Image) API 生成高質(zhì)量圖片

特點(diǎn)：

• ? 支持 4K 高清圖像生成
• ? 多種寬高比（16:9, 1:1, 9:16 等）
• ? 自動(dòng)文件命名
• ? 完善的錯(cuò)誤處理

使用示例：

python3 scripts/generate_image.py \
  --prompt "A tech blog banner with robots and code" \
  --aspect-ratio "16:9" \
  --resolution "2K"

實(shí)際應(yīng)用：

這篇文章的封面圖就是用這個(gè) Skill 生成的！提示詞是：

A cartoon-style banner image for OpenClaw installation guide. 
Features a cute robot AI assistant installing software on a laptop, 
with Telegram logo, terminal windows, and code snippets floating around. 
Blue and orange gradient background, modern tech aesthetic, 
flat design, friendly and approachable.

生成時(shí)間：約 45 秒（2K 分辨率）
文件大?。?.7 MB

Skill 2：cloudflare-r2-uploader

功能： 上傳文件到 Cloudflare R2 對(duì)象存儲(chǔ)，自動(dòng)生成 CDN 鏈接

特點(diǎn)：

• ? 自動(dòng)路徑生成：{year}/{month}/{md5}.{ext}
• ? MD5 去重（相同文件 = 相同 URL）
• ? 自定義域名支持
• ? 批量上傳

使用示例：

python3 scripts/upload_to_r2.py image.png

輸出：

? Uploaded: https://gpimg.guapihub.net/2026/01/abc123def456.png

組合使用：

兩個(gè) Skill 可以配合使用，實(shí)現(xiàn)完整的工作流：

# 生成圖片并上傳
python3 scripts/generate_and_upload.py \
  --prompt "Tech blog banner" \
  --aspect-ratio "16:9" \
  --resolution "2K"

一條命令完成：

1. 生成 AI 圖片
2. 上傳到 R2 CDN
3. 返回公開(kāi) URL

這就是我用來(lái)生成和上傳文章封面圖的完整流程！

5.3 其他可用 Skills

OpenClaw 生態(tài)還有很多實(shí)用的 Skills：

# 搜索 Skills
clawdhub search weather
# 安裝 Skills
clawdhub install weather

常用 Skills：

• weather - 天氣查詢
• bird - Twitter 操作
• coding-agent - 代碼助手
• mcporter - MCP 服務(wù)器集成

六、瀏覽器自動(dòng)化配置

OpenClaw 的另一個(gè)強(qiáng)大功能是瀏覽器自動(dòng)化——可以打開(kāi)網(wǎng)頁(yè)、搜索信息、截圖、點(diǎn)擊等。

6.1 瀏覽器模式

OpenClaw 支持兩種瀏覽器控制模式：

模式 1：獨(dú)立瀏覽器（openclawprofile）

• OpenClaw 啟動(dòng)并控制一個(gè)獨(dú)立的 Chrome 瀏覽器
• 使用獨(dú)立的用戶數(shù)據(jù)目錄
• 不共享系統(tǒng) Chrome 的登錄狀態(tài)

啟動(dòng)瀏覽器：

openclaw browser start

打開(kāi)網(wǎng)頁(yè)：

openclaw browser open "https://www.google.com"

截圖：

openclaw browser screenshot

模式 2：Chrome 擴(kuò)展模式（chromeprofile）

• 可以控制你正在使用的 Chrome 瀏覽器
• 需要安裝 OpenClaw Chrome 擴(kuò)展
• 可以訪問(wèn)已登錄的賬號(hào)

使用場(chǎng)景：

• 需要訪問(wèn)已登錄的網(wǎng)站（Twitter、Reddit 等）
• 需要使用瀏覽器的 cookie 和 session

6.2 實(shí)戰(zhàn)：搜索 Reddit

問(wèn)題： 想搜索 Reddit 上關(guān)于 ChatGPT 的討論，但 Reddit 有反爬蟲(chóng)機(jī)制。

解決方案： 在瀏覽器中登錄 Reddit，然后用 OpenClaw 控制。

步驟 1：在獨(dú)立瀏覽器中登錄

openclaw browser start
openclaw browser open "https://www.reddit.com"

然后手動(dòng)登錄 Reddit。

步驟 2：搜索

openclaw browser navigate "https://www.reddit.com/search/?q=ChatGPT+backup"

步驟 3：獲取頁(yè)面內(nèi)容

openclaw browser snapshot --efficient

![截圖：Reddit 搜索結(jié)果]

6.3 實(shí)戰(zhàn)：Google 搜索

Google 對(duì)自動(dòng)化訪問(wèn)相對(duì)友好，可以直接搜索：

openclaw browser navigate "https://www.google.com/search?q=site:reddit.com+ChatGPT"
openclaw browser snapshot

技巧： 用 Google 搜索 Twitter/Reddit 內(nèi)容，不需要登錄就能看到公開(kāi)信息。

![截圖：Google 搜索 Reddit 內(nèi)容]

七、常見(jiàn)問(wèn)題和解決方案

7.1 配對(duì)失敗

問(wèn)題： 發(fā)消息給 Bot，提示需要配對(duì)，但配對(duì)碼過(guò)期

原因： 配對(duì)碼有效期只有 1 小時(shí)

解決：

• 直接把你的 Telegram 用戶 ID 加到 allowFrom 列表中
• 或者快速完成配對(duì)流程

7.2 瀏覽器自動(dòng)化失敗

問(wèn)題： 讓 AI 打開(kāi)瀏覽器操作，報(bào)錯(cuò) Chrome extension relay is running, but no tab is connected

原因： 瀏覽器控制需要額外配置

解決：

• 使用獨(dú)立瀏覽器模式（openclaw profile）
• 或者安裝 Chrome 擴(kuò)展并連接標(biāo)簽頁(yè)

7.3 Reddit/Twitter 訪問(wèn)被攔截

問(wèn)題： 訪問(wèn) Reddit 或 Twitter 顯示 “You’ve been blocked by network security”

原因： 網(wǎng)站檢測(cè)到自動(dòng)化訪問(wèn)

解決：

1. 在瀏覽器中手動(dòng)登錄
2. 使用 Google 搜索公開(kāi)內(nèi)容（site:reddit.com ChatGPT）
3. 使用 DuckDuckGo（對(duì)自動(dòng)化更友好）

八、進(jìn)階技巧

8.1 定時(shí)任務(wù)（Cron）

OpenClaw 支持定時(shí)任務(wù)，可以讓 AI 定期執(zhí)行某些操作：

openclaw cron add --schedule "0 9 * * *" --message "早上好，今天有什么安排？"

8.2 記憶系統(tǒng)

OpenClaw 有記憶功能，可以記住重要信息：

• 日志： memory/YYYY-MM-DD.md（每日記錄）
• 長(zhǎng)期記憶： MEMORY.md（重要信息）

AI 會(huì)自動(dòng)讀取和更新這些文件。

8.3 多模型切換

OpenClaw 支持配置多個(gè)模型，可以根據(jù)任務(wù)選擇：

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "claude-sonnet-4-5"
      },
      "models": {
        "gpt-5.2": {},
        "claude-opus-4-5": {},
        "gemini-3-pro": {}
      }
    }
  }
}

九、總結(jié)

優(yōu)點(diǎn)

? 真的能用 - 不是 Demo，是可以日常使用的工具
? 擴(kuò)展性強(qiáng) - 支持多種模型、多種平臺(tái)、多種技能
? 開(kāi)源 - 代碼在 GitHub 上，可以自己改
? 文檔齊全 - 官方文檔寫(xiě)得很詳細(xì)
? 多 Bot 支持 - 可以同時(shí)運(yùn)行多個(gè) Bot，功能分離
? 技能系統(tǒng) - 可以創(chuàng)建自定義技能，擴(kuò)展無(wú)限可能

缺點(diǎn)

? 需要一定技術(shù)基礎(chǔ) - 至少要會(huì)用命令行
? 配置略復(fù)雜 - 尤其是多 Bot 和技能配置
? API 費(fèi)用 - 如果用得多，API 費(fèi)用會(huì)是一筆開(kāi)銷(xiāo)

適合誰(shuí)？

• 喜歡折騰的開(kāi)發(fā)者
• 需要 AI 助手但不想用商業(yè)產(chǎn)品的人
• 想要自己掌控?cái)?shù)據(jù)的人
• 需要多 Bot 管理不同任務(wù)的人
• 想要擴(kuò)展 AI 能力的人

不適合誰(shuí)？

• 完全不懂技術(shù)的小白
• 只想要開(kāi)箱即用的人
• 預(yù)算緊張的人（API 費(fèi)用）

十、參考資源

• 官方文檔： https://docs.openclaw.ai
• GitHub： https://github.com/openclaw/openclaw
• 技能市場(chǎng)： https://clawdhub.com
• 社區(qū)： https://discord.com/invite/clawd

后記

折騰了一個(gè)下午，從安裝到配置，從單 Bot 到多 Bot，從技能創(chuàng)建到自動(dòng)化工作流，總算把 OpenClaw 跑起來(lái)了。

雖然過(guò)程中遇到了一些坑（主要是配置和技能開(kāi)發(fā)），但最終效果還是挺滿意的?，F(xiàn)在我可以在 Telegram 里直接和 AI 對(duì)話，讓它幫我：

• 生成文章封面圖
• 上傳圖片到 CDN
• 管理服務(wù)器
• 寫(xiě)代碼
• 查資料
• 寫(xiě)文章

感覺(jué)像是給自己配了一個(gè) 24 小時(shí)在線的助手，而且還能不斷擴(kuò)展新能力。

如果你也想折騰，建議先從最簡(jiǎn)單的配置開(kāi)始，一步步來(lái)。遇到問(wèn)題多看日志，多查文檔，基本都能解決。

最后，如果你成功部署了 OpenClaw，歡迎分享你的經(jīng)驗(yàn)和玩法！

到此這篇關(guān)于零基礎(chǔ)入門(mén)OpenClaw 完整安裝配置實(shí)戰(zhàn)指南的文章就介紹到這了,更多相關(guān)OpenClaw安裝配置內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持腳本之家！

最新評(píng)論