認識 OpenClaw
OpenClaw 是跑在你自己機器上的 AI 助理閘道(Gateway)。你用 Telegram、WhatsApp、Discord 或瀏覽器跟它說話,它在本機呼叫模型、執行工具、記住長期工作區,中間沒有託管服務把對話轉一手。專案由 OpenClaw Foundation 以開源方式維護(MIT),先前曾用過 ClawdBot、MoltBot 等名稱,現在一律叫 OpenClaw。
本站用繁體中文整理日常真正會用到的那一層;指令與設定細節以 官方文件 為準。
最需要掌握的 20%
不必先把整份參考文件背完。先把下面七件事做熟,就能從零跑到「手機上能跟自己的助理說話」:
- 安裝 CLI:macOS/Linux 用安裝腳本,Windows 可用 PowerShell 或 Windows Hub。需要 Node.js 24.16+ 或 26.1+(建議 26)。
- 新手引導(onboarding):
openclaw onboard選模型供應商、寫入設定,必要時再裝背景服務。 - Gateway:本機預設聽
127.0.0.1:18789,是會話、頻道與工具的單一入口。沒開閘道,聊天 App 連不上。 - Control UI:
openclaw dashboard打開瀏覽器控制台,先在這裡打第一句話確認模型有通。 - 頻道 + 配對:最快的手機路徑是 Telegram Bot。陌生人第一次私訊只會拿到配對碼,你核准後才會處理訊息。
- Skills:用
SKILL.md教助理「這件事怎麼做」;社群套件在 ClawHub。 - 安全底線:閘道預設綁 loopback、私訊預設 pairing。不要把閘道裸露到公網;安裝第三方 skill 前先看內容。跑過
openclaw security audit。
flowchart LR
A["聊天 App/插件"] --> B["Gateway"]
B --> C["Agent 與工具"]
B --> D["Control UI"]
B --> E["CLI"]
閘道是會話、路由與頻道連線的單一真實來源。你傳進去的訊息,由它決定交給哪個 agent、用哪個模型、能不能跑本機指令。
OpenClaw 適合什麼場景
- 想要一個「會來找你」的助理:人在 Telegram/WhatsApp 裡,不必再開一個網頁。
- 希望資料與金鑰留在自己的筆電、家用伺服器或 VPS,而不是交給託管聊天機器人。
- 需要 agent 能查檔、跑指令、排程、裝 skill,而不只是對答。
- 已經在用 Claude Code 或 Codex CLI,想把同一組登入接到全天候閘道。
它不是雲端 SaaS。機器關機、閘道沒跑,助理就停。它也不是多租戶產品:一個閘道預設是「一個信任邊界」(自己或互相信任的小團隊)。陌生人不要共用同一個有工具權限的 agent。
官方學習資源
OpenClaw 沒有獨立的付費證照課程。權威來源是官方文件與創作者公開演講。
官方文件(必看)
從 Getting started 開始。繁體摘要可對照 docs2.openclaw.ai 正體中文。API 與設定細節以英文主站為準。
一次試跑
本機已有 Node 時,可先 npx openclaw@latest 走 Quick start,確認模型能回覆後再裝成背景服務。
官方與優質影音
創作者 Peter Steinberger 的 TED、AI Engineer、GitHub、OpenAI、Lex Fridman 場次見 官方影音。Fireship、freeCodeCamp、Kevin Stratvert、電腦王阿達等跟做見 YouTube 優質教學。
先看這支:OpenClaw 是什麼
頻道: Metics Media 來源: YouTube
用白話對照 ChatGPT 這類「你去找它」的工具,說明 OpenClaw 為何是「它來找你」的本機閘道。適合還沒裝之前先建立心智模型;安裝步驟請改看本站 入門。創作者本人的短講見 TED,十分鐘技術速覽見 Fireship。
建議學習順序
相關連結:openclaw.ai、官方文件、GitHub、ClawHub。想認識唯客學院,請看 關於我們。