OpenClaw 從零跑起來：CLI 安裝、渠道接入與自動化入門手冊

OpenClaw 是什麼

OpenClaw 是百度智能雲在海外發布的全能型 AI 數位辦公助理，本質上是一個可以自動調度工具、執行任務、接入三十多個聊天渠道的智能體框架。你可以把它裝在本機當 CLI 助理用，也可以跑在伺服器上長駐，透過 Telegram、WhatsApp、飛書等渠道隨時對話。Android 手機端也有對應的 APK，支援離線發件箱、語音連聊、相機與畫布命令等節點能力。

對一般使用者來說，OpenClaw官網 最有價值的部分不是「對話」本身，而是讓智能體主動幹活：定時查收郵件、盯日曆、每天產出固定格式的報告——這些都可以透過內建的 Cron、心跳、常駐指令等機制自動完成，一次設定長期受益。本篇就從安裝開始，一路帶你跑到第一個自動化任務落地。

安裝

從素材包的資訊來看，OpenClaw下載 提供多條安裝路徑，最常見的是 npm 全域安裝加引導腳本——這條路徑在 macOS、Linux、WSL2 上最為穩定，Windows 原生也支援但有 PATH 坑要注意。

先確認機器上的 Node.js 版本：官方要求 22.22.3+、24.15+ 或 25.9+，建議直接用 24 LTS。執行 node --version 看是否符合，不符合就先裝一個支援的版本。接著跑兩條命令：

npm install -g openclaw@latest
openclaw onboard --install-daemon

onboard 會啟動新手引導，問你要不要安裝背景守護程序（建議勾選，這樣 OpenClaw 關閉終端也能繼續跑）。引導結束後，開一個新終端驗證三件事：

openclaw --version
openclaw doctor
openclaw gateway status

第三條應該顯示網關正在監聽 18789 埠。如果提示 openclaw 不是內部或外部命令，九成是 npm 全域二進位目錄沒在 PATH 裡——Windows 使用者特別常見，去「系統環境變數」新增 %APPDATA%\npm 即可。

自管 Node（pnpm / bun）的使用者要注意：pnpm 首次安裝後需跑 pnpm approve-builds -g 批准建置腳本；bun 雖然能裝，但執行檔仍需受支援的 Node 執行時，建議繞開。不想污染主機的可以選 Docker / Podman 容器路徑，或 Nix 宣告式安裝，本篇不展開。

前置準備：裝完之後要做什麼

安裝驗證通過，網關在 18789 埠跑起來之後，接下來有三件事是跑教程之前必須先過一遍的：

1. 建立工作區（Workspace）

OpenClaw 的所有智能體配置、任務腳本、畫布檔案都放在一個工作區目錄裡。預設路徑在 ~/.openclaw/，但建議自己建一個乾淨的目錄放專案檔——這樣之後跑多個專案不會互相污染。開一個終端，openclaw workspace init ./my-first-claw 就能快速搭好骨架。

2. 確認節點狀態

手機 APK 想接入的話，先在 Android 上裝好應用、配對到本機網關。手機節點能做的事比「多一個聊天視窗」多：離線發件箱（斷網時訊息先落盤、重連後按序投遞，附唯一冪等鍵防重複）、語音三兄弟（聽寫、語音留言、Talk 連續對話）、Canvas 畫布（網關可以把手機當即時儀表頁顯示 HTML/CSS/JS）、相機與設備命令。教程階段用手機節點或純 CLI 都可以，後面要測自動化觸發時手機節點會很有感。

3. 選一個入門渠道

官方文檔列了三十多個渠道，但入門只需要挑一個最快跑通的。Telegram 是首選：向官方機器人管理器要一個令牌，五分鐘可以完成從建機器人到收到回覆的全流程。國內工作流的話，飛書有官方插件；QQ Bot 同為官方插件；微信走外部插件且僅支援私聊，把玩預期要放平。隱私優先的可以選 Signal。

步驟一：接入第一個 Telegram 機器人

這一段把 Telegram 跑起來——你會得到一個 @你的機器人名稱，之後所有對話都透過它進來。

做什麼：找 BotFather 建新機器人、拿到令牌、在 OpenClaw 裡註冊、發一條測試訊息。

操作路徑：

1. Telegram 內搜尋 @BotFather，送 /newbot，照提示輸入顯示名稱與使用者名稱（使用者名稱必須以 bot 結尾，且全域唯一）。
2. BotFather 回來一個 HTTP API 令牌，複製好——這個令牌等同於機器人密鑰，別貼到公開倉庫。
3. 回到 OpenClaw 終端，跑 openclaw channel add telegram --token <你的令牌>，網關會自動重啟。
4. 打開 Telegram 搜到你的機器人，發 /start。正常情況下應該立刻收到一條來自 OpenClaw 的歡迎回覆。

預期看到什麼：如果沒收到回覆，先用 openclaw gateway logs 看實時日誌——令牌錯了會報 401；網關沒重啟會顯示渠道未註冊；Telegram 官方偶有延遲，等兩分鐘再試。

步驟二：寫第一個 Cron 定時任務

渠道跑通後，接下來讓 OpenClaw 主動給你發東西。我們寫一個每天上午 9 點整向 Telegram 機器人推送「今日待辦摘要」的 Cron 任務——這是官方文檔裡 Cron 最經典的場景。

做什麼：用 openclaw cron add 加一條定時規則，驗證觸發。

操作路徑：

1. 在 OpenClaw 終端執行：

openclaw cron add "0 9 * * *" \
  --channel telegram \
  --message "幫我整理今天的日曆事件並用中文列出三條優先事項" \
  --name "daily-brief"

1. openclaw cron list 確認任務已註冊。
2. 不想等明天？用 openclaw cron run daily-brief --at now 立刻觸發一次測試。

預期看到什麼：Telegram 機器人應在 30 秒內回來一段整理好的摘要。openclaw tasks list 可以看到這次執行的後台任務記錄。

Cron 與心跳的本質區別：如果你搞不清楚什麼該用 Cron、什麼該用心跳，記一個簡單口訣——要準點、要隔離，用 Cron；要貼著對話上下文巡邏，用心跳。這就是 自動化 設計最核心的取捨。心跳預設每 30 分鐘在主會話裡跑一輪，從不建立任務記錄，適合收件箱巡檢、日曆即將到來事件這類低成本檢查。兩者可以疊加：常駐指令定職責，心跳做低成本巡檢，Cron 幹重活——甚至可以和 空投快傳 這類模組串起來。

常見踩坑點

坑一：Windows 上 openclaw 命令找不到

解法：npm 全域安裝後二進位檔預設落在 %APPDATA%\npm，這個路徑不在系統 PATH 裡。打開「編輯系統環境變數」→「環境變數」→ 在「使用者變數」裡找到 Path、新增 C:\Users\<你的使用者>\AppData\Roaming\npm，儲存後重開終端。openclaw doctor 的輸出裡也會標出這個路徑，照抄即可。

坑二：Telegram 機器人收不到訊息但日志沒有報錯

解法：網關沒正確重啟。渠道新增後 OpenClaw 需要重新初始化連線——跑 openclaw gateway restart 手動重啟一次，再從 Telegram 發 /start 測。如果還是沒訊息，openclaw gateway logs --follow 開實時日誌，發一條訊息看日誌有沒有收到 webhook。

坑三：Cron 任務觸發了但沒消息過來

解法：先 openclaw tasks list 看後台任務有沒有建立。任務存在但沒消息 = 渠道配置裡的目標頻道標識錯了（Telegram 頻道標識是數字 ID，不是機器人使用者名稱）；任務根本沒建立 = cron 表達式語法錯了或任務被禁用。用 openclaw cron edit <name> 重新檢查一遍。

下一步可以玩什麼

到這裡你已經有一個跑在本機的 OpenClaw、一個能對話的 Telegram 機器人、還有一條自動推送的 Cron 任務。往下的空間還很大：接入第二個渠道（Slack、Discord、WhatsApp 都支援）、在 Android 手機節點上啟用 Talk 連續對話模式、用心跳機制做收件箱巡檢、寫常駐指令（放在工作區 AGENTS.md）讓智能體每次對話前先檢查合規。OpenClaw 的好玩之處在於它的各個模組是鬆耦合的——先把最基礎的鏈路跑通，再按需疊加 工作流，不會一上來就被龐大的配置嚇退。

本文為個人基於網路公開資料整理編寫，非官方內容，僅供學習交流參考；軟體版權歸原作者所有，請支持正版；使用過程中遇到問題請查閱官方管道，本文不承擔任何責任。