跳到內容

OpenClaw 快速入門:從零到發送第一則訊息

開發通訊整合功能時,最讓人頭痛的就是處理繁瑣的認證流程和複雜的環境設定。有時候你只是想快速驗證一個想法,卻被卡在基礎設施的配置上,耗費大量時間在處理那些與核心邏輯無關的瑣事。

OpenClaw 的設計初衷就是為了簡化這個過程。如果你想用最快的方式開始聊天,可以直接啟動 Control UI,不需要設定任何 Channel。只要在你的 Gateway 機器上執行 openclaw dashboard 或開啟 http://127.0.0.1:18789/ 就能直接在瀏覽器中操作。

在開始之前,請確保你的環境符合以下條件:

  • Node 22 或更高版本(如果不確定,請執行 node --version 檢查)

跟著以下步驟,在 5 分鐘內完成基礎設定。

根據你的作業系統執行對應的指令:

macOS / Linux

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

Windows (PowerShell)

Terminal window
iwr -useb https://openclaw.ai/install.ps1 | iex

執行以下指令來設定 Auth、Gateway 以及選用的 Channel:

Terminal window
openclaw onboard --install-daemon

這個精靈會引導你完成基礎配置並安裝守護進程(daemon)。

如果你在步驟 2 選擇了安裝服務,現在它應該已經在運作了:

Terminal window
openclaw gateway status

最後,打開儀表板來確認一切正常:

Terminal window
openclaw dashboard

如果 Control UI 成功載入,代表你的 Gateway 已經準備就緒。

如果你在設定過程中遇到問題,可以嘗試以下方法:

想要在前景執行 Gateway 觀察日誌? 這在開發測試或排查問題時非常有用:

Terminal window
openclaw gateway --port 18789

如何確認訊息發送功能正常? 如果你已經配置好 Channel,可以試著發送一則測試訊息:

Terminal window
openclaw message send --target +15555550123 --message "Hello from OpenClaw"

自定義路徑與環境變數 如果你需要將 OpenClaw 執行在特定帳號下,或想更改配置檔案位置,可以使用這些環境變數:

  • OPENCLAW_HOME:設定內部路徑解析使用的根目錄。
  • OPENCLAW_STATE_DIR:覆蓋狀態資料夾路徑。
  • OPENCLAW_CONFIG_PATH:覆蓋配置檔案路徑。

如果你在安裝過程中卡住了,可以詢問我們的 AI Setup Assistant 獲取即時幫助。

完成基礎安裝後,你可以進一步探索:

  • 安全與審核:了解 Pairing 機制。
  • 擴充頻道:連接更多 Channels。
  • 進階工作流:查看從原始碼構建的 Setup 說明。
OpenClaw

OpenClaw Expert

還是卡住了?

如果這篇文件沒有解決你的情境,直接問 OpenClaw Expert,拿到可執行步驟。