龍蝦 AI (OpenClaw) 官方安裝教學:2026 最新一鍵部署與技能配置指南

完整介紹 Lobster AI / OpenClaw 的安裝流程,涵蓋硬體需求、一鍵部署、Skills 技能配置、背景執行、與 Claude Code 等工具比較,以及常見問題排解。

龍蝦 AIOpenClawAI AgentVPS安裝教學Skills 技能Claude CodeCodexGemini CLITelegram Bot自動化2026

AI Agent 安裝最大的問題通常不是裝不起來,而是裝起來之後你不知道它有多大權限、背景流程怎麼活著、錯誤該去哪裡看。這篇會把 OpenClaw 這類工具最需要先想好的幾件事一起補齊。

你如果希望這篇不只是看完「大概知道」,而是真的能拿來安排自己的部署或排錯順序,那就把每一步都對照你現在的環境去看,效果會差很多。

你會學到什麼

  • 搞清楚龍蝦 AI (OpenClaw) 是什麼、適合什麼場景。
  • 確認硬體需求,避免裝完跑不動。
  • 完成安裝、初始化與 Skills 技能配置。
  • 知道它跟 Claude Code、Codex、Gemini CLI 有什麼差異。
  • 學會進階設定和常見問題排解。

什麼情況最適合先看這篇

  • 想在 VPS 上部署 AI Agent,並希望把權限與運維邊界一起管好的人
  • 你現在正要處理「龍蝦 AI (OpenClaw) 官方安裝」這類操作
  • 你希望做完後不只是功能可用,連驗證與風險也一起想進去

開始前先確認

  • 先準備好 API Key、伺服器權限與要串接的服務。
  • 確認 Node.js 與系統依賴版本。
  • 先想清楚這個 Agent 的權限邊界。

先提醒你一件事

AI Agent 最大的風險常常不是安裝失敗,而是安裝成功之後權限過大、監控不足。

詳細教學與操作步驟

本文介紹 2026 年最火紅的個人 AI 代理平台「龍蝦」(OpenClaw) 的官方安裝流程。透過最新的自動化腳本與互動式引導,你可以在幾分鐘內將 VPS 變成具備感知與執行能力的 AI 數位管家。

龍蝦 AI (OpenClaw) 到底是什麼?

簡單來說,龍蝦 AI 是一個可以長期運行在你伺服器上的本地 AI 助手。它不是一個你打開瀏覽器才能用的 ChatGPT 替代品,而是一個會一直待命、可以主動幫你做事的 Agent。

它的核心架構分三層:

  • Gateway 閘道器: 負責接收來自 Telegram、Discord 或 API 的指令,是龍蝦跟外界溝通的橋梁。
  • Brain 大腦: 串接 LLM(像是 Claude、GPT-4o),負責理解你說的話、決定要做什麼。
  • Skills 技能: 實際動手的工具,例如搜尋網頁、管理 GitHub repo、讀寫檔案、執行 Shell 指令。

OpenClaw (原名 Clawdbot) 已發展成為一個擁有超過 25 萬顆星的開源生態系。比起傳統的腳本,官方平台提供更穩定的 Gateway 架構與豐富的 Skills 技能市場,讓 AI 代理人不僅能聊天,還能操作 Google Workspace、GitHub、甚至是你的本地瀏覽器。

龍蝦適合誰?

龍蝦特別適合這些場景:

  • 個人自動化: 你想讓 AI 每天幫你整理 GitHub issues、回覆固定格式的訊息、定時抓取資料。
  • 小團隊協作: 透過 Telegram 群組讓團隊成員都能下指令給同一個 AI,像是查 log、部署、跑報告。
  • 伺服器監控: 讓龍蝦盯著伺服器指標,CPU 飆高或磁碟快滿時主動通知你。
  • 開發輔助: 直接在 VPS 上讓龍蝦幫你 code review、跑測試、管理 CI/CD pipeline。

不適合的場景:如果你只需要在本機終端機內做一次性的開發任務,Claude Code 或 Codex 會更適合(後面會比較)。

硬體需求:你的 VPS 跑得動嗎?

龍蝦本身是 Node.js 應用,不會在本地跑模型推論,所以硬體需求不算高。但你要注意的是 Skills 和背景任務的累積開銷:

項目最低需求建議配置
CPU1 vCPU2 vCPU 以上
RAM1 GB2 GB 以上
磁碟空間5 GB20 GB(含日誌、快取)
Node.js22.x 以上最新 LTS
網路穩定對外連線低延遲、無限流量更好

如果你打算同時安裝超過 10 個 Skills,或者讓龍蝦同時處理多個對話,建議至少 2 GB RAM。在 侃瑞科技的 VPS 方案 中,XS 以上的方案就能穩定運行。

步驟一:執行官方一鍵安裝腳本

在你的 VPS 終端機執行以下指令。此腳本會自動檢查環境並安裝必要的 Node.js 22+ 依賴:

curl -fsSL https://openclaw.ai/install.sh | bash

安裝過程大約 1-3 分鐘,腳本會做這些事:

  1. 檢查作業系統與架構(支援 Ubuntu 20.04+、Debian 11+、CentOS 8+)
  2. 確認或自動安裝 Node.js 22+
  3. 下載 OpenClaw CLI 並設定到 PATH
  4. 建立預設設定目錄 ~/.openclaw/

安裝完成後,系統會提示你將 openclaw 加入環境變數。請重新登入 SSH 或執行 source ~/.bashrc

驗證安裝是否成功:

openclaw --version
# 預期輸出: openclaw v3.x.x

步驟二:互動式初始化 (Onboarding)

這是官方最推薦的設定方式,輸入以下指令進入引導流程:

openclaw onboard
  1. 選擇模型: 建議選擇 Claude 3.5 Sonnet,其指令遵循能力最強。如果你預算有限,也可以選 GPT-4o mini
  2. 輸入 API Key: 貼入你的 Anthropic 或 OpenAI 金鑰。建議為龍蝦申請專用的 API Key,方便追蹤用量和設定限額。
  3. 設定通訊頻道: 選擇 Telegram,並填入從 @BotFather 取得的 Token 與你的個人 ID。

初始化完成後,設定檔會存在 ~/.openclaw/config.yaml,你隨時可以手動修改。

步驟三:安裝必備技能 (Skills)

剛裝好的龍蝦只是個空殼,你需要給它「大腦」與「工具」。以下按使用場景分類推薦:

基礎必裝(幾乎每個人都需要):

# 網頁搜尋與抓取 — 讓龍蝦能上網找資料
openclaw skills install web_search

# Linux 指令執行 — 讓龍蝦能跑 shell 指令
openclaw skills install exec

# 檔案讀寫 — 讓龍蝦能讀取和修改檔案
openclaw skills install file_ops

開發者推薦:

# GitHub 管理 — PR review、issue 管理、程式碼搜尋
openclaw skills install github

# Docker 管理 — 查看容器狀態、重啟服務
openclaw skills install docker

# 資料庫查詢 — 安全地對 PostgreSQL/MySQL 執行唯讀查詢
openclaw skills install db_query

自動化與監控:

# 排程任務 — 設定定時執行的工作
openclaw skills install scheduler

# 系統監控 — CPU、記憶體、磁碟空間告警
openclaw skills install sys_monitor

# 通知推播 — 透過 Telegram/Slack 發送通知
openclaw skills install notifier

辦公與生產力:

# Google Workspace — 讀寫 Google Docs、Sheets、Calendar
openclaw skills install gworkspace

# 摘要生成 — 把長文章或會議記錄濃縮成重點
openclaw skills install summarizer

查看已安裝的技能和可用的技能市場:

# 列出已安裝的技能
openclaw skills list

# 搜尋技能市場
openclaw skills search "monitoring"

步驟四:系統健康檢查

任何時候如果你覺得龍蝦反應不正常,請執行:

openclaw doctor

這會檢查以下項目並給出修復建議:

  • 網路連線(能不能連到 LLM API endpoint)
  • API Key 有效性與餘額
  • Gateway 服務狀態
  • 已安裝 Skills 的相容性
  • 磁碟空間與記憶體使用量

預期的健康輸出:

✔ Network: Connected
✔ API Key: Valid (Claude 3.5 Sonnet)
✔ Gateway: Running on port 18789
✔ Skills: 6 installed, all compatible
✔ System: 1.2 GB RAM available, 15 GB disk free

步驟五:背景執行與服務管理

龍蝦預設以前景模式啟動。要讓它在背景持續運行,官方推薦使用內建的 service 模式:

# 註冊為系統服務並啟動
openclaw service install
openclaw start

# 查看執行狀態
openclaw status

# 查看即時日誌
openclaw logs --follow

# 停止服務
openclaw stop

# 重新啟動(更新設定後需要)
openclaw restart

如果你習慣用 PM2 管理 Node.js 程式,也可以:

pm2 start openclaw -- gateway
pm2 save
pm2 startup

龍蝦 vs 其他 AI CLI 工具:怎麼選?

2026 年 AI CLI 工具百花齊放,你可能會問:為什麼不直接用 Claude Code 或 Codex?以下是定位比較:

簡單的判斷原則:

  • 你需要一個「一直在線」幫你盯伺服器、回訊息的 → 龍蝦
  • 你需要在本機寫程式、改 codebase 的 → Claude Code
  • 你需要快速產生一段程式碼或做一次性研究的 → Codex / Gemini CLI
  • 以上都需要 → 同時裝,它們不衝突

自訂設定與進階配置

龍蝦的設定檔在 ~/.openclaw/config.yaml,以下是幾個值得調整的進階選項:

調整模型與行為參數:

# ~/.openclaw/config.yaml
brain:
  model: claude-3-5-sonnet
  temperature: 0.3          # 降低隨機性,回答更精準
  max_tokens: 4096          # 單次回應上限
  system_prompt: |
    你是侃瑞科技的伺服器管理助手。
    回答請使用繁體中文。
    遇到危險操作時,先確認再執行。

設定 Skills 的權限邊界:

skills:
  exec:
    allowed_commands:
      - "systemctl status *"
      - "docker ps"
      - "df -h"
      - "free -m"
    blocked_commands:
      - "rm -rf *"
      - "shutdown"
      - "reboot"
    timeout: 30s             # 單次指令最長執行時間
  file_ops:
    allowed_paths:
      - "/home/lobster/"
      - "/var/log/"
    blocked_paths:
      - "/etc/"
      - "/root/"

設定多個通訊頻道:

channels:
  telegram:
    token: "YOUR_BOT_TOKEN"
    allowed_users: [123456789, 987654321]
  discord:
    token: "YOUR_DISCORD_TOKEN"
    allowed_channels: ["ai-commands"]
  api:
    enabled: true
    port: 18789
    auth_token: "YOUR_SECRET_TOKEN"

修改設定後記得重啟:

openclaw restart

常見安裝問題排解

Q:安裝時顯示 Node.js 版本過低? 官方安裝腳本通常會嘗試自動升級。如果失敗,請手動安裝 NVM 再切換版本:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash
source ~/.bashrc
nvm install 22
nvm use 22
node --version  # 確認 v22.x.x

更多細節可以參考我們的 NVM 安裝教學

Q:openclaw onboard 卡在 API Key 驗證? 通常是網路問題。先確認你的 VPS 能連到外部 API:

curl -s https://api.anthropic.com/v1/messages -o /dev/null -w "%{http_code}"
# 預期輸出: 401(未授權但可連線)
# 如果是 000 或 timeout,表示網路不通

如果在中國大陸或有防火牆的環境,可能需要設定 proxy:

export HTTPS_PROXY=http://your-proxy:port
openclaw onboard

Q:如何讓龍蝦在背景持續運行? 官方 Gateway 預設會以系統服務運行。你也可以使用 openclaw stopopenclaw start 來手動控制。如果 VPS 重開機後龍蝦沒有自動啟動:

openclaw service install   # 註冊為 systemd 服務
systemctl enable openclaw  # 設定開機自動啟動

Q:Skills 安裝失敗,顯示 permission denied? 這通常是因為你用了 sudo 安裝 OpenClaw,但 Skills 目錄權限不對:

# 檢查目錄擁有者
ls -la ~/.openclaw/skills/

# 修正權限(把 lobster 換成你的使用者名稱)
sudo chown -R lobster:lobster ~/.openclaw/

Q:龍蝦回應很慢或經常 timeout? 幾個常見原因:

  1. API Key 餘額不足 — 到 Anthropic/OpenAI 後台確認
  2. VPS 記憶體不夠 — 執行 free -m 確認剩餘記憶體
  3. 同時安裝太多 Skills — 用 openclaw skills list 檢查,移除不需要的
  4. 網路延遲高 — 選擇離 API endpoint 較近的機房,侃瑞科技的 VPS 位於台灣與日本機房,對 Anthropic API 延遲通常在 100ms 以內

安全與維護建議

  • 權限隔離: 雖然 openclaw 方便,但請參考我們的 龍蝦安全加固手冊,絕對不要以 Root 權限長期執行。
  • 定期更新: AI 領域更新極快,請定期執行 openclaw update 獲取最新功能。
  • 流量監控:侃瑞科技 VPS 後台觀察網路流量,確保 AI 沒有因為無窮迴圈而消耗過多資源。
  • 備份設定: 養成備份 ~/.openclaw/config.yaml 的習慣,重裝時可以快速還原。

做完後怎麼確認自己真的有設對

  • 安裝完成後除了看服務有沒有啟動,也要檢查權限、日誌與實際任務是否正常。
  • 從 Telegram 發一個實際指令(例如「查一下目前磁碟空間」),確認端到端流程正常。
  • 執行 openclaw doctor 確認所有項目都是綠色。
  • 如果你有改 DNS、Proxy、背景服務或權限,請逐層確認,不要一次判斷全部成功。

這一題最常踩的坑

  • 安裝完成後直接給太大 shell 或系統權限。
  • 只看能不能跑,不看日誌和錯誤回報。
  • 沒有先規劃金鑰與機密資訊存放方式。
  • Skills 裝太多但沒有設定權限邊界,等於開了一堆後門。
  • 沒有設定 allowed_users,任何人都能透過 Telegram 操控你的 Agent。

如果你要往下一步走

如果你準備把它長期放在線上,下一篇一定要接著看 龍蝦安全加固手冊。 如果你要長期跑這類 AI 工作流,建議直接搭配侃瑞的 VPS 方案與價格

需要主機來實作?

侃瑞科技提供 cPanel 虛擬主機與 VPS,教學裡的操作開箱即用。

查看方案 →
LINE 諮詢