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

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

什么是 OpenClaw？

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

舉幾個(gè)例子：

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

為什么叫"龍蝦"？

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

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

硬件要求

軟件要求

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

# 如果沒(méi)有 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 用戶（最簡(jiǎn)單）

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

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

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

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

方式二：命令行安裝（跨平臺(tái)）

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

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

# 2. 驗(yàn)證安裝
openclaw --version

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

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

注意：有些渠道需要額外配置，比如 Telegram 需要先找 @BotFather 申請(qǐng) Bot Token，Discord 需要?jiǎng)?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 起個(gè)名字（比如 “我的 AI 助手”）

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

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

Step 2：配置 OpenClaw

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

Step 3：?jiǎn)?dòng)并測(cè)試

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

Discord 配置步驟

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

1.訪問(wèn) https://discord.com/developers/applications

2.點(diǎn)擊 “New Application”

Step 2：創(chuàng)建 Bot

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

2.點(diǎn)擊 “Add Bot”

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

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

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

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

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

啟動(dòng)與驗(yàn)證

啟動(dòng) Gateway

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

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

驗(yàn)證

openclaw health

打開控制臺(tái)

瀏覽器訪問(wèn) http://127.0.0.1:18789

架構(gòu)流程圖

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

常見問(wèn)題匯總

Q1：?jiǎn)?dòng)報(bào)錯(cuò) “Port 18789 already in use”

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

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

1.檢查 Bot Token 是否正確

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

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

Q3：Discord 提示 “Missing Access”

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

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

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

注意事項(xiàng)

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

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

3.隱私安全：不要在對(duì)話中輸入敏感個(gè)人信息

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

最后

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

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

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

最新評(píng)論