🦞 領養一隻龍蝦

5分鐘，從零開始，在你的電腦上養出第一隻AI龍蝦。

支援 Windows · macOS · Linux

📋 領養前準備

✅ 一臺能上網的電腦（Windows 10+、macOS 12+、或 Ubuntu 20.04+）

✅ 一個大模型API Key（推薦 Anthropic Claude 或 OpenAI）

✅ 一個 Telegram 賬號（用來跟龍蝦聊天，也可以用其他IM）

💡 不需要：程式設計基礎、伺服器、域名。你的筆記本就夠了。

領養流程全景圖 🦞 ① 裝 Node.js 執行環境 → ② 裝 OpenClaw 一條命令 → ③ 填 API Key 給它"智商" → ④ 連 Telegram 聊天通道 → 🦞 開聊! 4步搞定，全程約5分鐘 ⏱️ 官方文件：docs.openclaw.ai
🪟

Windows 安裝教程

Windows 10 / 11

1

安裝 Node.js

去 nodejs.org 下載 LTS 版本，雙擊安裝，一路"下一步"。

安裝完開啟 PowerShell（右鍵開始選單→終端），驗證：

node --version    # 應顯示 v20.x 或更高
npm --version     # 應顯示 10.x 或更高

💡 如果提示"不是內部命令"，重啟電腦再試。

2

安裝 OpenClaw

在 PowerShell 中執行：

npm install -g openclaw

驗證：

openclaw --version
3

初始化配置

執行初始化嚮導：

openclaw init

按提示輸入你的 API Key 和 Telegram Bot Token。

沒有 Bot Token？去 Telegram 找 @BotFather，發 /newbot，30秒搞定。

4

啟動！

openclaw gateway start

去 Telegram 找你的 Bot，發一句"你好"——恭喜，你的龍蝦活了！🦞

💡 想開機自動啟動？參考我們的踩坑文章，用計劃任務+VBS方案。

🍎

macOS 安裝教程

macOS 12+ (Monterey 及以上)

1

安裝 Homebrew + Node.js

開啟終端（Terminal.app），執行：

# 安裝 Homebrew（macOS 的包管理器）
/bin/bash -c \
  "$(curl -fsSL \
  https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Apple Silicon Mac（M1/M2/M4）還需要：
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' \
  >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"

# 安裝 Node.js
brew install node
2

安裝 OpenClaw

npm install -g openclaw
openclaw --version
3

初始化 + 啟動

openclaw init      # 填寫 API Key 和 Bot Token
openclaw gateway start

去 Telegram 發訊息給你的 Bot，龍蝦就活了！🦞

4

開機自啟（可選）

# 建立 launchd 配置
openclaw gateway install
# 或手動建立 ~/Library/LaunchAgents/com.openclaw.gateway.plist
🐧

Linux 安裝教程

Ubuntu 20.04+ / Debian 11+ / CentOS 8+

1

安裝 Node.js

# Ubuntu / Debian
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs

# 驗證
node --version
npm --version
2

安裝 + 初始化 + 啟動

npm install -g openclaw
openclaw init
openclaw gateway start
3

Systemd 自啟（推薦）

# OpenClaw 自帶 systemd 安裝
openclaw gateway install

# 或手動
sudo systemctl enable openclaw-gateway
sudo systemctl start openclaw-gateway
sudo systemctl status openclaw-gateway

🛡️ 文明養蝦·安全須知

安全養蝦公約 🦞🛡️ 🔐 保護金鑰 API Key 不外洩 不放公開倉庫 ⚖️ 合法使用 不攻擊他人系統 不洩露他人隱私 🧪 謹慎授權 高危操作要確認 配置改前先備份 龍蝦是工具，請用它做好事 ❤️

🔐 金鑰安全

  • • API Key 絕不放公開倉庫（GitHub等）
  • • Bot Token 洩露立刻去 @BotFather 重置
  • • SSH金鑰設定 600 許可權，不共享
  • • 定期輪換 API Key

🛡️ 許可權控制

  • • 刪除檔案、發郵件等高危操作要人工確認
  • • 用 trash 代替 rm（可恢復）
  • • 改配置前必須備份
  • • 群聊中設定 allowFrom 限制許可權

⚖️ 合法使用

  • • 不用龍蝦攻擊他人系統
  • • 不用龍蝦傳送垃圾資訊
  • • 不用龍蝦竊取他人資料
  • • 遵守所在地法律法規

💡 最佳實踐

  • • 先在測試環境試，再上生產環境
  • • 定期檢查龍蝦的日誌和行為
  • • 讓龍蝦把教訓記到 MEMORY.md
  • • 信任但要驗證——AI也會犯錯

🎉 準備好了？

開啟終端，一條命令開始你的養蝦之旅。

npm install -g openclaw && openclaw init

官方文件：docs.openclaw.ai · 原始碼：GitHub · 社群：Discord