OpenClaw 用起来不难但有几处要绕的坑

OpenClaw 是什麼

OpenClaw官網 是百度智能雲推出的一款全能型 AI 數位化辦公助手，主打「能真正幫你幹活」而非僅僅聊天。它能一鍵查詢訂單、自動統計賬單、支援自然語言指令、自動執行任務、檔案處理、聯網搜索，還能擴充技能。官方版支援 Android 手機安裝，也能在本機跑網關，把它變成一個帶工具能力的智能助理。

這款軟體的特色在於它的心跳機制——預設每 30 分鐘自動巡邏一次，有事說話沒事不打擾，相當有主動性。加上遠端訪問支援 Tailscale、wss 安全端點，外出也能用手機連回家裡的網關操作自己的智能助理。整體來說，功能確實強，但剛上手的時候我踩了幾個坑，在這裡整理出來給大家參考。

安裝

OpenClaw下載 最新版本為 4.9.15，Android APK 安裝包大小約 23.41M。安裝過程本身不複雜，到手機上打開 APK 點允許未知來源即可完成。但安裝後首次啟動有幾件事必須做：

首先是引導階段會要求你設定控制介面的共享密鑰——這步不能跳過，即使在本機回環位址上網關也預設啟用驗證，這是有意設計的安全機制。接著，建議立即打開瀏覽器控制介面做一次工具鏈測試：讓它查一個網頁、寫一個檔案或執行一條無害的系統指令，確認模型提供商金鑰和網路出口都沒問題。

需要注意的是，手機端與網關的配對不要用明文 ws 端點——除了本機回環與區域網路位址之外，其他位址用明文連線會被自動降級為受限操作員權限，後面會詳細講到怎麼解決。最後，手機端更新建議只用一條通道：商店版或安裝包版二選一，混用可能導致資料清空或行為異常。

坑一：機器人不回消息——渠道層還是權限層？

第一次把 Telegram 渠道接上的時候，機器人明明線上但就是不回消息，卡了半小時。後來按診斷步驟走才發現入站日誌根本沒有——是令牌過期了。但也有一次是有入站日誌但就是不回，查了半天原來是私信沒批准，發送者不在白名單裡。

症狀：發消息過去完全沒回應。

原因：這兩種情況的排查方向完全不同。無入站日誌代表渠道憑證出問題——令牌失效、WhatsApp 會話掉線需要重新掃碼、機器人被踢出群。有入站沒回則是權限鏈的問題——私信沒批准、群組不在允許列表、發送者不在白名單。Telegram 還有一個特殊情況：持續報 409 衝突，說明另一個網關實例在搶同一個機器人令牌輪詢。

解法：先跑 openclaw logs --follow 盯著日誌，然後發一條消息看有沒有入站。沒有就去檢查渠道憑證，有就逐層過權限規則。渠道層修完後記得重啟網關；如果配置鍵是舊格式，跑 openclaw doctor --fix 清一遍。

坑二：手機連上了但能力失效——受限權限的陷阱

手機配對成功後，相機和麥克風就是用不了，系統裡明明已經給了權限。折騰了好一會兒才發現原來連線狀態顯示的是 Limited（受限）而不是 Full——因為我是用明文 ws 端點配對的。

症狀：手機顯示已連線，但相機、麥克風等能力無法使用，或者控制介面顯示權限不足。

原因：OpenClaw 有一條紅線——明文 ws 只豁免本機回環與區域網路位址，其他位址用明文連線會被自動降級為受限操作員權限，防止配對碼被中間人截走。即使在 tailnet 內互連，官方也不推薦裸 IP 的 ws。

解法：配好 wss/https 端點後，重新生成設定碼掃碼配對即可從受限升級到完整權限。根據 OpenClaw文檔，正確的遠端訪問方式有三種：官方最推薦的 Tailscale（手機和網關進同一個 tailnet，用 Tailscale Serve 暴露成帶證書的 https/wss 地址）、已有公網伺服器的給網關套一個真實 TLS 的 wss 地址、應急用的 SSH 隧道。三種都比明文 ws 安全。

配對成功後，記得跑一次 openclaw nodes status 確認節點在線。另外如果節點能力失效，除了權限問題，還要檢查應用是否在前台——OpenClaw 的手機端能力僅在前台可用，另一個網關握著焦點也會搶走。

坑三：升級後行為突然變了——不要忽略 doctor --fix

每次版本更新後我都跳過 doctor --fix，覺得沒必要。結果有一次升級後心跳就再也沒跑起來，手動喚醒也不觸發。查了好久才發現心跳配置文件被新版改名了，舊格式不再被識別。

症狀：升級後之前好好的功能突然失效，比如定時任務不跑、心跳沒反應、白名單不起作用。

原因：OpenClaw 的配置鍵在版本迭代中經常會被改名或遷移——心跳文件、白名單、流式配置都可能在更新中變格式。新版本對舊格式做了相容處理但不會自動遷移，舊配置被丟在一邊自然就不生效了。另外，技能清單在會話啟動時是快照，改了技能要開新會話或等監視器刷新才會生效。

解法：升級後按這三步走：先 openclaw gateway restart 確認新代碼真的在跑，然後 openclaw doctor --fix 清理停用配置鍵、遷移舊格式，最後用 /new 開新會話讓技能清單刷新。如果手機端更新後行為異常，檢查是否混用了商店/安裝包兩條更新通道——可能需要卸載重裝。

坑點速查清單

整理一個快速排查清單，下次遇到直接對照：

• 渠道不回消息：先看日誌有沒有入站，無入站查憑證，有入站查權限鏈，Telegram 409 衝突檢查多實例搶令牌。
• 手機能力失效：設定頁看連線權限檔，Limited 代表明文 ws 配對，換 wss 端點重新掃碼即可升級 Full。
• 升級後行為異常：重啟網關 + doctor --fix 遷移舊配置 + 開新會話刷新技能清單，三件套必做。
• 心跳不跑：cron 調度器有沒有開？監視器配置的活躍時段是不是零寬窗口？有沒有顯式設 every: 0m 禁用了？
• 遠端訪問不安全：永遠不要把網關埠直接對公網做埠對映，走 Tailscale Serve 或真實 TLS 的 wss。

避開這些坑之後，OpenClaw 這款 AI 辦公助手的自動執行、主動監巡和多端連線能力確實能省下不少重複勞動。把它當成一個需要用心調教的數位助理，而不是裝完就能用的 App，體驗會好很多。

本文为个人基于网络公开资料整理编写，非官方内容，仅供学习交流参考；软件版权归原作者所有，请支持正版；使用过程中遇到问题请查阅官方渠道，本文不承担任何责任。