給新手看的命令參考
先看懂每條命令是做什麼的，再決定要不要複製執行。這一頁專門按新手能理解的方式來寫，也會明確標出有風險的操作。
install
6
在安裝或更新 OpenClaw 前，先確認目前機器上的 Node.js 版本。
node -v顯示 npm 版本，確認安裝 OpenClaw 需要的套件管理工具已經可用。
npm -v移除舊的 OpenClaw 套件名稱，避免與目前的 CLI 衝突。
npm uninstall -g clawdbot || true
npm uninstall -g moltbot || true
npm uninstall -g openclaw || true下載最新支援版本的 OpenClaw 命令列工具，並讓整台機器都能直接呼叫。
npm i -g openclaw@latest顯示目前 OpenClaw CLI 的版本號，確認命令已經可用。
openclaw --version開啟 OpenClaw 的快速引導，協助你完成第一次設定。
openclaw onboard --flow quickstartupdate
5
重新啟動 gateway 服務，讓新的設定或通道變更生效。
openclaw gateway restart先嘗試新版 gateway 重啟指令，失敗時再退回舊版重啟指令。
openclaw gateway restart || openclaw restart先安裝最新 OpenClaw CLI，再立即重新啟動 gateway，讓新版本馬上生效。
npm i -g openclaw@latest
openclaw gateway restart || openclaw restart用更詳細的模式重新啟動 gateway，方便你觀察啟動時實際載入了什麼。
openclaw gateway restart --verbose用舊的頂層重啟寫法執行 OpenClaw 重啟，並顯示詳細輸出。
openclaw restart --verboselogs
3
只看最新一小段日誌，方便快速定位錯誤，不必翻很長的舊輸出。
openclaw logs | tail -n 100從 OpenClaw 日誌中篩出與飛書、webhook、回呼事件相關的輸出。
openclaw logs | grep -i -E "feishu|webhook|event|callback" || true持續輸出 gateway 容器日誌，方便你一邊操作一邊觀察實際發生了什麼。
docker compose logs -f openclaw-gatewaydocker
6
在 Ubuntu 上安裝 Docker Engine 和 Docker Compose，然後輸出版本確認工具可用。
sudo apt install -y docker.io docker-compose
docker --version
docker-compose --version調整 Linux 權限，讓目前帳號之後執行 Docker 時不必每次都加 sudo。
sudo usermod -aG docker $USER先讓官方初始化腳本可執行，再真正執行它來建立 Docker 版 OpenClaw 環境。
chmod +x ./docker-setup.sh
./docker-setup.sh不是在宿主機本地執行，而是在 Docker 的 CLI 容器內啟動 OpenClaw 快速引導。
docker compose exec openclaw-cli openclaw onboard --flow quickstart同時重新啟動目前 Docker 堆疊中的 gateway 和 CLI 容器。
docker compose restart openclaw-gateway openclaw-cli停止這個 Docker Compose 專案中的 OpenClaw 容器，但不會直接刪除它們。
docker compose stopbackup
1
把 `~/.openclaw` 目錄壓縮成一個 `.tar.gz` 備份檔，方便你複製保存。
tar -czf openclaw-backup.tar.gz ~/.openclaw