用一條指令在 Linux 上部署 AI Telegram Bot（OpenClaw 實戰）

最近在研究怎麼快速架設 AI 聊天機器人，發現 OpenClaw 這個開源框架蠻實用的——支援 Telegram、Discord 等多平台，可以接各種大型語言模型。

不過官方文件對新手不太友善，設定檔要手寫 JSON，Docker 部署也沒現成腳本。所以我寫了一個一鍵部署腳本，在全新伺服器上一條指令就能跑起來。

部署效果

終端機部署過程

Telegram Bot 配對成功後的首次對話

事前準備

1. AI API Key

需要一個能呼叫大型語言模型的 API Key。這裡使用 CrazyRouter 作為 API 閘道，一個 Key 就能呼叫 GPT、Claude、Gemini、DeepSeek 等 600 多個模型。

2. Telegram Bot Token

在 Telegram 找 @BotFather，發送 /newbot，按提示建立 Bot 並取得 Token。

3. Linux 伺服器

• Ubuntu/Debian 建議
• 最低規格：1核 1GB 記憶體
• 需要能存取外網

部署步驟

git clone https://github.com/xujfcn/openclaw-deploy.git
cd openclaw-deploy
chmod +x deploy.sh
sudo ./deploy.sh

腳本會互動式引導你：

1. 輸入 API Key
2. 輸入 Telegram Bot Token
3. 選擇執行方式：Docker（建議）或本機 Node.js

接著自動完成：

• Docker 未安裝則自動安裝
• 建構映像檔
• 產生設定檔 openclaw.json
• 啟動容器

約 1-2 分鐘完成。

配對 Telegram 帳號

OpenClaw 使用配對機制，Bot 在你批准前不會回覆任何人。

# 1. 在 Telegram 向 Bot 發送 /start
# 2. Bot 回覆配對碼（例如 QE8E59CF）
# 3. 在伺服器執行：
docker exec openclaw-bot openclaw pairing approve telegram QE8E59CF

配對成功後 Bot 就會開始回覆了。

切換模型

修改 openclaw.json 中的 model.id 即可切換不同模型：

修改後重啟：docker restart openclaw-bot

手動部署方式

如果想自己控制每一步：

# 安裝 OpenClaw
npm install -g openclaw@latest

# 建立設定目錄
mkdir -p /opt/openclaw/workspace

# 寫設定檔（替換你的 Key 和 Token）
cat > /opt/openclaw/openclaw.json << 'EOF'
{
  "models": {
    "mode": "merge",
    "providers": {
      "crazyrouter": {
        "baseUrl": "https://crazyrouter.com/v1",
        "apiKey": "你的API-Key",
        "api": "openai-completions",
        "models": [{
          "id": "claude-opus-4-6",
          "name": "Claude Opus 4.6",
          "input": ["text", "image"],
          "contextWindow": 200000,
          "maxTokens": 8192
        }]
      }
    }
  },
  "channels": {
    "telegram": {
      "enabled": true,
      "dmPolicy": "pairing",
      "botToken": "你的Bot-Token",
      "groupPolicy": "open"
    }
  },
  "gateway": { "port": 18789 }
}
EOF

# 啟動
export OPENCLAW_HOME=/opt/openclaw
openclaw gateway --port 18789

常見問題

Bot 不回覆？

• 確認已完成配對
• 檢查日誌：docker logs openclaw-bot

401 錯誤？

• API Key 不正確，請確認

Docker 建構慢？

• 首次建構需要下載依賴，之後會快取

專案連結

• GitHub: xujfcn/openclaw-deploy
• OpenClaw: github.com/openclaw/openclaw
• API 文件: crazyrouter.apifox.cn