部署 OpenClaw 外掛

本指南將引導你在飛函工作台中將 OpenClaw 外掛部署為機器人。完成後,團隊成員即可在飛函用戶端中直接與 OpenClaw 機器人對話。

前提條件

如果你尚未安裝飛函伺服器端,請先按照快速安裝指南搭建伺服器端環境。

第 1 步 — 建立新應用

  1. 登入飛函管控台,導航至工作台 > 應用管理
  2. 點擊右上角的新增應用按鈕。

點擊新增應用以建立應用

第 2 步 — 填寫應用資訊

建立企業應用對話框中,填寫以下欄位:

欄位
應用名稱例如:飛函龍蝦
應用描述簡要描述機器人的用途
應用圖示上傳一個便於識別的圖示
應用分組從下拉選單中選擇已有分組,或根據需要新建一個

點擊確定完成應用建立。

填寫應用資訊並點擊確定

第 3 步 — 開啟應用詳情

應用建立完成後,你將在應用列表中看到 OpenClaw。點擊詳情進入應用設定頁面。

點擊詳情以設定應用

第 4 步 — 啟用機器人能力

  1. 應用詳情頁面中,向下捲動到應用能力區域。你會看到一個預設關閉的機器人開關。
  2. 點擊頁面底部的編輯按鈕。

點擊編輯以修改應用設定

  1. 開啟機器人開關以啟用該應用的機器人能力,然後點擊儲存

啟用機器人開關並點擊儲存

第 5 步 — 複製應用憑證

儲存後,從頁面頂部的應用憑證區域複製 App IDApp Secret。設定 OpenClaw 外掛時需要用到這些憑證。

Warning

請妥善保管 App Secret,不要公開分享或提交到版本控制系統中。

複製 App ID 和 App Secret

第 6 步 — 安裝並設定 OpenClaw 外掛

前提條件

請確保在繼續之前已在你的機器上安裝了 OpenClaw

安裝外掛

在運行 OpenClaw 的機器上開啟終端,執行以下命令:

openclaw plugins install @feihan-im/openclaw-plugin

設定頻道

執行以下命令,將三個佔位符替換為你在第 5 步中複製的值:

openclaw channels add --channel feihan \
  --app-token <APP_ID> \
  --token <APP_SECRET> \
  --url <BACKEND_URL>
參數填寫內容取得位置
--app-tokenApp ID飛函管控台 → 工作台 → 應用管理 → 應用詳情
--tokenApp Secret與 App ID 同一頁面(請視為密碼,切勿分享)
--url你的飛函伺服器端位址例如 http://192.168.10.10:21000

管理多個帳號(選用)

新增帳號

如果需要接入多個飛函機器人,可以使用 --account 參數為新帳號指定名稱:

openclaw channels add --channel feihan \
  --account bot2 \
  --app-token <APP_ID> \
  --token <APP_SECRET> \
  --url <BACKEND_URL>

--account 的值是你自訂的名稱(例如 bot2sales-bot),用於標識該帳號。第 6 步中設定的第一個帳號會自動命名為 default。所有帳號在閘道啟動時獨立運行。

停用帳號

如需臨時停止某個機器人帳號而不刪除其設定:

openclaw channels remove --channel feihan --account <ACCOUNT_ID>

如需重新啟用,編輯 ~/.openclaw/openclaw.json,將該帳號條目的 "enabled" 設為 true(或直接刪除 "enabled" 欄位——帳號預設為啟用狀態)。

刪除帳號

如需永久移除某個機器人帳號並刪除其設定:

openclaw channels remove --channel feihan --account <ACCOUNT_ID> --delete
Tip

每次帳號變更(新增、停用、啟用或刪除)後,請執行 openclaw gateway restart 重啟閘道以使變更生效。

重啟閘道

設定完成後,重啟閘道以套用變更:

openclaw gateway restart

進階設定

如需修改其他設定(例如加密或請求逾時),編輯 ~/.openclaw/openclaw.json

{
  "channels": {
    "feihan": {
      "accounts": {
        "default": {
          "appId": "your_app_id",
          "appSecret": "your_app_secret",
          "backendUrl": "http://192.168.10.10:21000",
          "enableEncryption": true,
          "requestTimeout": 30000
        }
      }
    }
  }
}
欄位類型預設值說明
appIdstring必填飛函應用 ID
appSecretstring必填飛函應用密鑰
backendUrlstring必填飛函伺服器端位址
enabledbooleantrue啟用/停用此帳號
enableEncryptionbooleantrue啟用 OpenClaw 與飛函伺服器端之間的加密通訊
requestTimeoutnumber30000等待飛函伺服器端回應的逾時時間(毫秒)

第 7 步 — 驗證機器人

外掛安裝完成後,開啟飛函用戶端,在搜尋欄中搜尋 OpenClaw,你應該能在通訊錄中看到它。點擊即可發起對話,驗證機器人是否正常運作。

在飛函用戶端中搜尋 OpenClaw 機器人

你已成功部署 OpenClaw 外掛。團隊成員現在可以在飛函用戶端中與 OpenClaw 機器人進行互動了。