單節點安裝與驗證
在已取得的 MeshMac 節點(建議 macOS 13+、可 SSH)上,任選一種方式安裝 OpenClaw。
方式一:curl 一鍵安裝
curl -sSL https://get.openclaw.io/install | sh
方式二:Docker
docker pull openclaw/runtime:latest
docker run -d --name openclaw -p 8080:8080 openclaw/runtime:latest
安裝完成後執行 onboarding 與健康檢查:
openclaw onboard— 依提示完成首次設定(節點名稱、預設通道等)。openclaw doctor— 檢查運行環境、依賴與埠占用,依輸出修復後再繼續。
doctor 確認無報錯,再配置飛書/釘釘,可避免通道連線與環境問題混在一起排查。
飛書/釘釘通道配置
通道用於接收與回覆企業 IM 的訊息,以下為精簡步驟,便於小團隊對接。
飛書:① 在飛書開放平台建立自建應用,取得 App ID 與 App Secret。② 啟用「接收訊息」與「發送訊息」權限,並設定請求網址為 OpenClaw 回調 URL(如 https://你的節點/feishu/webhook)。③ 在 OpenClaw 設定檔或 UI 中填入 App ID、Secret 與回調路徑,重啟服務後在群組中 @ 機器人測試。
釘釘:① 在釘釘開發者後台建立企業內應用,取得 AppKey 與 AppSecret。② 開通機器人權限並設定 Outgoing 回調位址指向 OpenClaw(如 https://你的節點/dingtalk/callback)。③ 在 OpenClaw 中配置釘釘 AppKey、Secret 與回調路徑,重啟後在群內 @ 機器人驗證收發。
| 項目 | 飛書 | 釘釘 |
|---|---|---|
| 憑證 | App ID + App Secret | AppKey + AppSecret |
| 回調路徑範例 | /feishu/webhook |
/dingtalk/callback |
| 驗證方式 | 群組 @ 機器人收發 | 群內 @ 機器人收發 |
日常任務配置示例
示例一:定時提醒 — 在 OpenClaw 中新增排程任務,類型選「提醒」或「發送訊息」;設定 cron(如每日 9:00 0 9 * * *),目標通道選飛書或釘釘對應群組,內容填寫提醒文案。儲存後由排程引擎按時推送,可在群內收到固定時間的提醒。
示例二:簡單審批 — 建立「審批」類型任務:觸發條件為收到關鍵字(如「請審批」)或指定表單;動作可設為發送審批卡片到群組、並將「同意/拒絕」回傳至 OpenClaw,再由規則將結果寫入日誌或通知指定成員。小團隊可先做單步「收到→發卡片→記錄結果」再擴展多級審批。
常見報錯排查
doctor 報錯「port already in use」 — 表示 8080 或指定埠被占用,可改設定檔中的埠或關閉佔用進程後重啟。
飛書/釘釘收不到回調 — 確認回調 URL 可從外網訪問、HTTPS 有效,且應用權限與 IP 白名單(若有)已正確設定;用 curl 對回調 URL 發測試請求檢查 OpenClaw 日誌。
定時任務不觸發 — 檢查 cron 表達式與時區、排程服務是否常駐;確認任務已啟用且通道選擇正確。
更多多節點與任務佇列實戰可參考站內多節點部署與任務佇列同步、多機協同與任務交接。