CloudInsight Logo
CloudInsight
返回首頁AI 自動化

Clawbot 安裝教學｜OpenClaw 在 Mac、Windows、Linux 的安裝與第一次設定【2026】

9 min 分鐘閱讀
#clawbot#openclaw#安裝教學#openclaw 安裝#windows#mac#linux#chrome 擴充功能#AI 助理

Clawbot 安裝教學｜OpenClaw 在 Mac、Windows、Linux 的安裝與第一次設定

Clawbot 安裝教學｜OpenClaw 在 Mac、Windows、Linux 的安裝與第一次設定

本文指令以 OpenClaw 官方文件（docs.openclaw.ai）2026 年 9 月版本為準，版本更新後請以官方文件為準。

安裝前準備

項目需求
作業系統macOS、Linux、Windows（Windows 10 20H2 以上可用 Windows Hub）
Node.js24.16 以上或 26.1 以上，官方推薦 Node 26；用安裝程式時會自動補裝
AI 模型已登入的 Claude Code 或 Codex CLI，或任一模型供應商的 API 金鑰

用 node --version 可以檢查目前的 Node 版本。只有要從原始碼建置時才需要 pnpm。

方法一：一行指令安裝（推薦）

安裝程式會偵測作業系統、必要時安裝 Node、安裝 OpenClaw，並自動開啟設定精靈。

macOS／Linux／WSL2：

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

Windows（PowerShell）：

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

想先只安裝、不立刻跑設定精靈，macOS／Linux 可以加上 --no-onboard：

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

只想先試試看？

不想安裝也可以先跑一次：

npx openclaw@latest

Gateway 會在這個終端機視窗裡執行，按 Ctrl+C 結束，設定會保留。

方法二：Windows Hub 桌面 App（Windows 首選）

Windows Hub 是官方的 Windows 原生配套 App，支援 Windows 10 20H2 以上與 Windows 11，不需要系統管理員權限，提供 x64 與 ARM64 兩種已簽章的安裝檔。

  1. 到官方的 Windows Hub 發行頁 下載 OpenClawCompanion-Setup-x64.exe（或 ARM 電腦用 arm64 版）
  2. 執行安裝檔後，從開始功能表或系統匣打開 OpenClaw Companion
  3. 依第一次設定的引導建立本機 Gateway，或連到既有的遠端 Gateway

Windows Hub 內建系統匣狀態、開機自動啟動、原生聊天視窗，以及診斷工具（Command Center）。

Windows 另外兩條路：用上面的 PowerShell 指令安裝命令列版本；或在 WSL2 裡執行 Gateway，相容性最接近 Linux。

方法三：用 npm／pnpm／bun 安裝（自己管理 Node 的人）

npm 12 或 npm 11.16 以上：

npm install -g openclaw@latest --allow-scripts=openclaw
openclaw onboard --install-daemon

npm 11.15 以前的版本，請拿掉 --allow-scripts=openclaw。

pnpm：

pnpm add -g --allow-build=openclaw openclaw@latest
openclaw onboard --install-daemon

bun：

bun add -g --trust openclaw@latest
bun run --bun openclaw onboard --install-daemon --daemon-runtime bun

--trust 是讓這次安裝可以執行 OpenClaw 的安裝腳本；bun run --bun 與 --daemon-runtime bun 則是讓 CLI 與 Gateway 改用 Bun 執行（需要 Bun 1.4 以上）。

macOS 另有選單列 App，可以到 OpenClaw GitHub Releases 下載 .dmg 安裝。

團隊在白板前討論導入流程

第一次設定：設定精靈（onboarding）

安裝程式會自動開啟設定精靈，有兩種選擇：

  • Quick start：自動找出你電腦上已有的 Claude Code／Codex 登入或 API 金鑰，用一次實際呼叫驗證，存好設定後打開網頁控制台
  • Custom setup：完整的逐步設定

之後想補設定，可以執行 openclaw configure。

讓 Gateway 在背景執行

Quick start 會讓 Gateway 在目前的終端機前景執行。要讓它常駐背景，先按 Ctrl+C 停止，再安裝服務：

openclaw gateway install

這會在 macOS 建立 LaunchAgent、在 Linux 與 WSL2 建立 systemd 使用者服務、在原生 Windows 建立排程工作，設定會保留。

確認有沒有在跑：

openclaw gateway status

正常的話，會看到 Gateway 在 18789 埠監聽。

打開控制台、傳第一則訊息

openclaw dashboard

瀏覽器會打開 Control UI（控制台）。在聊天區傳一則訊息，收到 AI 回覆就代表安裝成功。

想從手機傳訊息？先接 Telegram

官方說最快的聊天頻道是 Telegram，只需要一個 bot token。其他頻道（WhatsApp、Slack、Discord 等）的設定方式見官方的 Channels 文件。

安裝 Chrome 擴充功能（選用）

如果你想讓 OpenClaw 操作你已登入的 Chrome 分頁，要裝官方擴充功能。在裝有 Chrome 的那台電腦上執行：

openclaw browser extension install

指令執行期間請保持視窗開著，依提示完成 Chrome 的設定。注意：

  • OpenClaw 不會替你重開 Chrome，也不會替你按下權限同意；要你自己在 Chrome 裡啟用 OpenClaw
  • Linux 與其他 Chromium 瀏覽器：先完成本機註冊，再到 Chrome 線上應用程式商店安裝 OpenClaw 擴充功能
  • 支援 Google Chrome、Chrome for Testing 與 Chromium

不裝擴充功能也能用瀏覽器自動化：OpenClaw 可以自己開一個獨立的專用瀏覽器設定檔，不碰你平常的瀏覽器。用法見 OpenClaw AI Agent 自動化教學。

裝完後的安全檢查

openclaw security audit

這個指令會檢查你的設定有沒有常見風險。官方提醒：

  • 聊天頻道收到陌生人私訊時，預設會先回配對碼，用 openclaw pairing approve <頻道> <配對碼> 核准
  • 除非設定沙箱，工具動作會直接在你的主機上執行
  • 要從外部網路連到 Gateway 之前，先讀官方的安全與對外開放指南

常見安裝問題

npm 安裝時出現「blocked because they are not covered by allowScripts」？

npm 12 預設會擋套件的安裝腳本。請照官方指令加上 --allow-scripts=openclaw。npm 11.15 以前的版本沒有這個選項，要拿掉。

我之前裝的是 Clawdbot 或 Moltbot，要怎麼辦？

專案已於 2026 年 1 月 30 日定名 OpenClaw，GitHub 與 npm 都改用 openclaw 這個名字。請改裝 openclaw，並以 docs.openclaw.ai 的文件為準。

Windows 要用哪一種裝法？

一般使用者用 Windows Hub App 最簡單；想用命令列就用 PowerShell 安裝；需要最接近 Linux 的相容性就在 WSL2 裡執行 Gateway。

一定要 Node 26 嗎？

不一定。官方支援 Node 24.16 以上或 26.1 以上，推薦 26。用安裝程式的話，它會自動準備合適的 Node 版本。

下一步

免費諮詢：找到適合你的 AI 自動化方案

不確定自架 AI 助理適不適合你？CloudInsight 提供免費諮詢，適合以下需求：

  • 評估 AI 自動化工具
  • 想設計自動化工作流程
  • 需要 API 整合與架構建議

預約免費諮詢，我們會在 24 小時內回覆你。所有諮詢內容完全保密，沒有任何銷售壓力。

參考資料

  1. OpenClaw 官方文件「Getting started」- https://docs.openclaw.ai/start/getting-started
  2. OpenClaw 官方文件「Install」- https://docs.openclaw.ai/install
  3. OpenClaw 官方文件「Windows」- https://docs.openclaw.ai/platforms/windows
  4. OpenClaw 官方文件「Chrome Extension」- https://docs.openclaw.ai/tools/chrome-extension
  5. OpenClaw GitHub README - https://github.com/openclaw/openclaw

需要專業的雲端建議？

無論您正在評估雲平台、優化現有架構，或尋找節費方案，我們都能提供協助

預約免費諮詢

相關文章

AI 自動化

Clawbot 是什麼？現在叫 OpenClaw：功能、改名歷程與適合誰【2026】

Clawbot 已改名為 OpenClaw，是裝在自己電腦上的開源 AI 助理，透過 WhatsApp、Telegram、Slack 等聊天軟體跟你對話並代辦事情。本文整理改名歷程（Clawdbot → Moltbot → OpenClaw）、核心功能、費用、適合誰，以及使用前要知道的安全注意事項。

AI 自動化

Clawbot AI Agent 怎麼用？OpenClaw 自動化實戰：排程、瀏覽器操作、Webhook 串接

Clawbot 現在叫 OpenClaw。本文依官方文件，教你用 OpenClaw 做 AI Agent 自動化：用 Automations 排程每天定時回報、讓 agent 操作瀏覽器、用 Webhook 讓 n8n 等外部服務觸發 agent，以及 Hooks、Standing Orders 的用途與安全注意事項。

AI 自動化

Clawbot 開發者指南｜OpenClaw GitHub 專案、架構、Gateway API 與外掛開發

Clawbot 現在叫 OpenClaw，官方專案在 GitHub 的 openclaw/openclaw，採 MIT 授權。本文依官方文件整理：從原始碼建置、Gateway 架構、外部程式怎麼串接（Gateway 協定、CLI、Webhook）、如何寫技能與外掛並發布到 ClawHub，以及貢獻方式。