• 繁體中文
  • 部署 OpenClaw 外掛

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

    前提條件

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

    第 1 步 — 建立新應用

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

    點擊新增應用以建立應用

    第 2 步 — 填寫應用資訊

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

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

    點擊確定完成應用建立。

    填寫應用資訊並點擊確定

    第 3 步 — 開啟應用詳情

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

    點擊詳情以設定應用

    第 4 步 — 啟用機器人能力

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

    點擊編輯以修改應用設定

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

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

    第 5 步 — 複製應用憑證

    儲存後,從頁面頂部的應用憑證區域複製 App ID 和 App 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 的值是你自訂的名稱(例如 bot2、sales-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 機器人進行互動了。