OpenClaw
新手入門8 分鐘閱讀

OpenClaw 快速入門：30 分鐘從零開始

從準備模型 Key 到收到第一則回覆，涵蓋安裝、設定、健康檢查及常見啟動問題排解。

O

OpenClaw Guides

Tutorial Authors

1. 前置需求

安裝 OpenClaw 之前，請確認您的系統符合以下要求：

  • Node.js 22 或更高版本（建議使用 LTS）
  • npm 或 pnpm 套件管理器
  • 穩定的網路連線

檢查您的 Node.js 版本：

bash
node --version
# 應輸出 v22.x.x 或更高版本

2. 一鍵安裝

開啟終端機並執行：

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

安裝腳本會自動偵測您的系統環境並完成所有設定。

替代方案：使用 npm

如果您偏好直接使用 npm：

bash
# 全域安裝 OpenClaw
npm install -g openclaw@latest

# 啟動引導精靈
openclaw onboard

3. 初始設定

安裝完成後，執行設定精靈：

bash
openclaw onboard

精靈會引導您完成：

  1. API Key 設定 - 輸入您的 Anthropic API key
  2. 預設模型選擇 - 選擇 Claude 3.5 Haiku、Claude 3.5 Sonnet 或 Claude Sonnet 4
  3. 聊天平台連接 - 連接 WhatsApp、Telegram 或 Discord

4. 啟動 Gateway 服務

啟動 OpenClaw gateway：

bash
openclaw gateway start

您應該會看到類似以下的輸出：

🦞 OpenClaw Gateway v1.0.0
✓ Model provider connected
✓ Gateway listening on http://127.0.0.1:18789
✓ Ready to receive messages

5. 驗證安裝

檢查服務狀態：

bash
openclaw status

如果一切正常運作，您應該會看到：

Gateway: Running ✓
Model: Connected ✓
Channels: 0 active

疑難排解

連接埠已被使用

如果您看到 EADDRINUSE 錯誤：

bash
# 查詢佔用 3000 連接埠的程序
lsof -i :18789

# 終止該程序或使用其他連接埠
openclaw gateway start --port 18790

API Key 問題

如果您收到 401 Unauthorized：

bash
# 重新設定您的 API key
openclaw config set api-key

下一步