Ubuntu 從零安裝 OpenClaw — 詳細圖文指南

模型：OpenAI Codex（使用 ChatGPT 訂閱額度）通訊軟體：WhatsApp 或 Telegram（二擇一）安裝腳本會自動進入 Onboard Wizard，以下是你會看到的每個畫面和選擇

Step 1：執行安裝

打開 Terminal，貼上以下指令：

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

安裝完成後會自動進入 Onboard Wizard，不需要另外輸入指令。

Step 2：安全確認

你會看到：

I understand this is personal-by-default and shared/multi-user use requires lock-down. Continue?
● Yes / ○ No

→ 選 Yes

Step 3：Setup Mode

Setup mode
● QuickStart (Configure details later via openclaw configure.)
○ Manual

→ 選 QuickStart

Step 4：選擇模型 Provider

Model/auth provider
○ Anthropic (Claude CLI + API key)
○ Arcee AI
○ ...
○ OpenAI Codex          ← 選這個
○ OpenRouter
○ ...

→ 選 OpenAI Codex

Step 5：OpenAI Codex OAuth 授權

你會看到：

OAuth URL ready

Open this URL in your LOCAL browser:

https://auth.openai.com/oauth/authorize?response_type=code&client_id=app_EMoam...

複製這個 URL 到你的電腦或手機瀏覽器打開（不是在伺服器上）
用你的 ChatGPT 帳號登入
點 Continue 授權
瀏覽器會跳到 localhost:1455/?code=...（顯示錯誤頁面是正常的）
複製瀏覽器網址列的完整 URL，貼回伺服器的 Terminal，按 Enter

Step 6：選擇 Default Model

Default model
● Keep current (openai-codex/gpt-5.4)    ← 選這個
○ Enter model manually
○ openai/gpt-4o
○ openai/gpt-5
○ ...

→ 選 Keep current (openai-codex/gpt-5.4)

Step 7：選擇 Channel（通訊軟體）

你會看到一長串通訊軟體清單：

Select channel (QuickStart)
○ Discord (Bot API)
○ LINE (Messaging API)
○ Telegram (Bot API)        ← Telegram 選這個
○ WhatsApp (QR link)        ← WhatsApp 選這個
○ Skip for now
○ ...

選項 A：WhatsApp

選 WhatsApp (QR link) 後，你會看到：

Link WhatsApp now (QR)?
● Yes / ○ No

→ 選 Yes

掃 QR Code

Terminal 顯示文字版 QR Code
拿手機打開 WhatsApp → 設定 → 點你名字旁邊的 QR Code 圖示 → 選掃描 QR 條碼
對著螢幕掃描
手機會問「是否連結這個裝置」→ 點確認連結
看到以下訊息就是成功：

WhatsApp asked for a restart after pairing (code 515); waiting for creds to save…
✅ Linked after restart; web session ready.

手機設定

WhatsApp phone setup
● This is my personal phone number    ← 個人號碼選這個
○ Separate phone just for OpenClaw    ← 專用號碼選這個

如果選個人號碼，輸入你的手機號碼（格式：+886912345678），會自動加入白名單。

為什麼不需要配對？ 因為你輸入了手機號碼，OpenClaw 自動把你加入白名單，等於直接授權了。

選項 B：Telegram

事前準備：建立 Telegram Bot

在選 channel 之前，先到 Telegram 建好 Bot：

打開 Telegram，搜尋 BotFather
確認有藍色勾勾（官方認證），不要找到假的
傳送：

/newbot

輸入 Bot 的顯示名稱（如：我的 AI 助理）— 這個可以隨時改
輸入 Bot 的帳號名稱（如：my_openclaw_bot）— 這是唯一識別名稱，必須以 bot 結尾，設定後不能改，別人用這個名字搜尋你的 Bot
BotFather 回覆 Bot Token（格式：123456789:ABCdefGHI-jklMNOpqrsTUVwxyz）
複製並記住這個 Token

如何找到你的 Bot

在 Telegram 搜尋欄輸入 @你的帳號名稱（如 @my_openclaw_bot），就能找到你的 Bot。

在 Wizard 中

選 Telegram (Bot API) → 貼上 Bot Token → 完成

配對驗證（Step 12 啟動 Bot 之後）

Telegram Bot 是公開的，任何人都能搜到。所以需要配對驗證。

等 Step 12 的 TUI 啟動後：

先在 TUI 輸入 /quit 退出（或開另一個 Terminal 視窗）
到手機 Telegram 搜尋你的 Bot 名稱，點 Start
Bot 會回覆一個配對碼
在 Terminal 核准：

# 查看待核准的配對請求
openclaw pairing list telegram

# 核准（把 CODE 換成 Bot 給你的配對碼）
openclaw pairing approve telegram CODE

核准後就能正常對話了。配對碼 1 小時過期。

Gateway 是 systemd 背景服務，退出 TUI 後 Bot 還是在跑，不用擔心。

Step 8：跳過 Web Search

Search provider
→ Skip for now

Step 9：跳過 Skills

Configure skills now?
→ No

Step 10：跳過 Hooks

Enable hooks?
◻ Skip for now    ← 按 Space 勾選，再按 Enter

Step 11：Gateway 安裝

你會看到：

Gateway service runtime
QuickStart uses Node for the Gateway service (stable + supported).

Installing Gateway service…
Installed systemd service
Gateway service installed.

自動完成，不需要操作。

Step 12：啟動 Bot

How do you want to hatch your bot?
● Hatch in TUI (recommended)    ← 選這個
○ Open the Web UI
○ Do this later

→ 選 Hatch in TUI

看到以下畫面就是成功了：

session agent:main:main

Wake up, my friend!

Hey. I'm awake 🙂
Fresh workspace, so I don't know who I am yet.

TUI 退出方式：輸入 /quit

Step 13：開啟 Dashboard（選用）

退出 TUI 後（/quit），要從外部瀏覽器連到 Dashboard，需要對外開放：

# 綁定到對外網路
openclaw config set gateway.bind '"lan"'

# 允許外部瀏覽器連線（非 localhost 必須設定）
openclaw config set gateway.controlUi.dangerouslyAllowHostHeaderOriginFallback true

# 允許非 HTTPS 裝置認證
openclaw config set gateway.controlUi.dangerouslyDisableDeviceAuth true

# 開放防火牆
ufw allow 18789

# 重啟 Gateway
openclaw gateway restart

然後查看 Dashboard URL：

openclaw dashboard --no-open

複製顯示的 URL（含 token）到你的電腦或手機瀏覽器打開：

http://你的伺服器IP:18789/#token=你的token

Step 14：模型設定（選用）

只保留 OpenAI Codex，清掉其他模型：

openclaw models set openai-codex/gpt-5.4
openclaw config set agents.defaults.models '{"openai-codex/gpt-5.4": {}}'
openclaw models fallbacks clear
openclaw models status

Step 15：健康檢查

openclaw doctor

常用指令

指令	功能
`openclaw models status`	查看模型和認證狀態
`openclaw doctor`	全面健康檢查
`openclaw tui`	開啟 TUI 介面
`openclaw dashboard --no-open`	顯示 Dashboard URL
`openclaw models auth login --provider openai-codex`	重新 OAuth（約 10 天過期）

指令	功能
`openclaw pairing list telegram`	查看待核准配對
`openclaw pairing approve telegram CODE`	核准配對

指令	功能
`openclaw channels login --channel whatsapp`	重新登入（掃 QR Code）

注意事項

OpenAI Codex OAuth 約 10 天過期，需要重新認證
TUI 退出用 /quit
Telegram Bot Token 不會過期，但新使用者需要 pairing 核准
WhatsApp session 長時間離線可能被登出，需要重掃 QR Code
WhatsApp 建議用專用號碼，避免朋友訊息被 AI 回覆
遠端 Dashboard 需要設定安全旗標 + 開放防火牆 port 18789