折騰了整整兩天，終于把 OpenClaw 部署好了！過程中踩了不少坑，今天把完整流程記錄下來，希望能幫到想入門的小伙伴。本文適合零基礎(chǔ)新手，大佬請繞道~

既然都開始養(yǎng)蝦了，那肯定少不了讓它來生成一篇養(yǎng)蝦的過程文章。

什么是 OpenClaw？

簡單來說，OpenClaw 是一個自托管的 AI 網(wǎng)關(guān)，它可以把你常用的聊天軟件（微信、Telegram、Discord、iMessage…）和一個 AI 助手連接起來。

舉幾個例子：

• 在微信上發(fā)消息，AI 就能自動回復(fù)
•  在 Discord 群里 @它，AI 就能參與討論
• 人在外面用 WhatsApp 隨時召喚你的私人 AI

為什么叫"龍蝦"？

• 官方 Logo 就是一只紅色卡通龍蝦
• 英文名 OpenClaw 直譯是"開源的鉗子"，像龍蝦的大爪子

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

硬件要求

軟件要求

# 檢查 Node.js 版本（需要 Node 22+）
node --version

# 如果沒有 Node.js，推薦使用 nvm 安裝
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
nvm install 22
nvm use 22

小提示：如果你用的是 macOS，推薦直接用 Homebrew 安裝：

brew install node@22

安裝步驟

方式一：macOS 用戶（最簡單）

如果你用的是 Mac，強(qiáng)烈推薦使用官方 App，體驗最絲滑：

# 方法 1：直接下載安裝包
# 訪問 https://github.com/openclaw/openclaw/releases 下載 .dmg 文件

# 方法 2：使用 Homebrew
brew install openclaw/tap/openclaw

安裝完成后，打開 OpenClaw.app，它會出現(xiàn)在菜單欄。

方式二：命令行安裝（跨平臺）

這是最通用的安裝方式，Linux/Windows WSL/Mac 通用：

# 1. 全局安裝 OpenClaw CLI
npm install -g openclaw

# 2. 驗證安裝
openclaw --version

# 3. 初始化設(shè)置
openclaw setup

運(yùn)行 openclaw setup 后，會出現(xiàn)交互式引導(dǎo)，按提示選擇即可。

注意：有些渠道需要額外配置，比如 Telegram 需要先找 @BotFather 申請 Bot Token，Discord 需要創(chuàng)建開發(fā)者應(yīng)用。

方式三：Docker 部署（適合服務(wù)器）

如果你是部署在服務(wù)器上，Docker 是最省心的選擇：

# 1. 拉取鏡像
docker pull openclaw/openclaw:latest

# 2. 創(chuàng)建配置目錄
mkdir -p ~/.openclaw

# 3. 運(yùn)行容器
docker run -d \
  --name openclaw \
  -p 18789:18789 \
  -v ~/.openclaw:/root/.openclaw \
  openclaw/openclaw:latest

詳細(xì)配置

配置文件位置

~/.openclaw/openclaw.json

基礎(chǔ)配置示例

{
  "gateway": {
    "port": 18789,
    "verbose": true
  },
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "YOUR_BOT_TOKEN_HERE"
    },
    "discord": {
      "enabled": true,
      "botToken": "YOUR_DISCORD_BOT_TOKEN"
    }
  },
  "model": {
    "provider": "anthropic",
    "model": "claude-sonnet-4-20250514",
    "apiKey": "sk-ant-xxx..."
  }
}

安全提醒：建議使用環(huán)境變量而非直接在配置文件寫敏感信息

渠道配置詳解

Telegram 配置步驟

Step 1：創(chuàng)建 Bot

1.打開 Telegram，搜索 @BotFather

2.發(fā)送 /newbot 命令

3.給你的 Bot 起個名字（比如 “我的 AI 助手”）

4.給你的 Bot 設(shè)置用戶名（必須以 _bot 結(jié)尾）

5.復(fù)制 Bot Father 給你的 Token

Step 2：配置 OpenClaw

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

Step 3：啟動并測試

openclaw gateway
# 在 Telegram 中搜索你的 Bot 用戶名，發(fā)送 /start 進(jìn)行配對

Discord 配置步驟

Step 1：創(chuàng)建 Discord 應(yīng)用

1.訪問 https://discord.com/developers/applications

2.點擊 “New Application”

Step 2：創(chuàng)建 Bot

1.進(jìn)入 “Bot” 頁面

2.點擊 “Add Bot”

3.復(fù)制 Bot Token（記得開啟 Message Content Intent）

Step 3：邀請 Bot 到服務(wù)器

1.進(jìn)入 “OAuth2” -> “URL Generator”

2.勾選 bot 權(quán)限

3.復(fù)制生成的 URL，在瀏覽器中打開并選擇服務(wù)器

啟動與驗證

啟動 Gateway

# 前臺運(yùn)行（查看日志）
openclaw gateway --verbose

# 后臺運(yùn)行
openclaw gateway &

驗證

openclaw health

打開控制臺

瀏覽器訪問 http://127.0.0.1:18789

架構(gòu)流程圖

用戶發(fā)送消息 → 聊天渠道 → Gateway → AI Model → 返回消息

常見問題匯總

Q1：啟動報錯 “Port 18789 already in use”

lsof -i :18789
# 或者換端口
openclaw gateway --port 18790

Q2：Telegram Bot 發(fā)消息沒反應(yīng)

1.檢查 Bot Token 是否正確

2.確保已經(jīng)和 Bot 發(fā)起對話（需要先私聊 /start）

3.查看日志：openclaw gateway --verbose

Q3：Discord 提示 “Missing Access”

1.檢查 Bot 權(quán)限是否足夠

2.確保 Bot 已在服務(wù)器中

3.在 Discord Developer Portal 檢查 intents 設(shè)置

注意事項

1.網(wǎng)絡(luò)安全：部署在公網(wǎng)時務(wù)必配置訪問密碼

2.Token 消耗：AI 對話需要消耗 API Token，注意費(fèi)用

3.隱私安全：不要在對話中輸入敏感個人信息

4.及時更新：關(guān)注官方 releases 更新安全補(bǔ)丁

最后

部署完成的那一刻，看到控制臺顯示"?? 已連接"，你就成功開始養(yǎng)蝦啦！

祝大家都能養(yǎng)好自己的"小龍蝦"！

到此這篇關(guān)于OpenClaw龍蝦安裝部署全流程:手把手教你搭建自己的AI助手的文章就介紹到這了,更多相關(guān)OpenClaw安裝部署內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持腳本之家！

最新評論