Deploy OpenClaw Plugin

This guide walks you through deploying the OpenClaw plugin as a bot in your Feihan workspace. By the end, your team members will be able to chat with the OpenClaw bot directly from the Feihan client.

Prerequisites

If you haven't installed Feihan Server yet, please follow the Quick Install guide first to set up your server environment.

Step 1 — Create a New App

  1. Sign in to Feihan Admin Console and navigate to Workspace > App Management.
  2. Click the New App button in the upper-right corner.

Click New App to create an application

Step 2 — Fill in App Information

In the Create Enterprise App dialog, fill in the following fields:

FieldValue
App Namee.g., Feihan Lobster
App DescriptionA brief description of the bot's purpose
App IconUpload an icon for easy identification
App GroupSelect an existing group from the dropdown, or create a new one if needed

Click OK to create the app.

Fill in app details and click OK

Step 3 — Open App Details

After the app is created, you will see OpenClaw in the App List. Click Details to enter the app configuration page.

Click Details to configure the app

Step 4 — Enable Bot Capability

  1. On the App Details page, scroll down to the App Capabilities section. You will see a Bot toggle that is disabled by default.
  2. Click the Edit button at the bottom of the page.

Click Edit to modify app settings

  1. Turn on the Bot toggle to enable bot capability for this app, then click Save.

Enable Bot toggle and click Save

Step 5 — Copy App Credentials

After saving, copy the App ID and App Secret from the App Credentials section at the top of the page. You will need these credentials when configuring the OpenClaw plugin.

Warning

Keep your App Secret safe. Do not share it publicly or commit it to version control.

Copy App ID and App Secret

Step 6 — Install and Configure the OpenClaw Plugin

Prerequisites

Make sure you have OpenClaw installed on your machine before proceeding.

Install the Plugin

Open a terminal on the machine where OpenClaw is running and execute:

openclaw plugins install @feihan-im/openclaw-plugin

Configure the Channel

Run the following command, replacing the three placeholders with the values you copied in Step 5:

openclaw channels add --channel feihan \
  --app-token <APP_ID> \
  --token <APP_SECRET> \
  --url <BACKEND_URL>
FlagWhat to fill inWhere to find it
--app-tokenApp IDFeihan Admin Console → Workspace → App Management → App Details
--tokenApp SecretSame page as App ID (treat as a password, do not share)
--urlYour Feihan server addresse.g. http://192.168.10.10:21000

Managing Multiple Accounts (Optional)

Adding an Account

If you need to connect more than one Feihan bot, run the same command with an --account flag to give the new account a name:

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

The --account value is a custom name you choose (e.g. bot2, sales-bot) to identify this account. The first account you configured in Step 6 is automatically named default. All accounts start independently when the gateway starts.

Disabling an Account

To temporarily stop a bot account without removing its config:

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

To re-enable it, edit ~/.openclaw/openclaw.json and set "enabled": true on the account entry (or remove the "enabled" field — accounts are enabled by default).

Removing an Account

To permanently remove a bot account and delete its config:

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

After any account change (add, disable, enable, or remove), restart the gateway with openclaw gateway restart for the changes to take effect.

Restart the Gateway

After configuration, restart the gateway to apply the changes:

openclaw gateway restart

Advanced Configuration

To modify other settings (such as encryption or request timeout), edit ~/.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
        }
      }
    }
  }
}
FieldTypeDefaultDescription
appIdstringrequiredFeihan application ID
appSecretstringrequiredFeihan application secret
backendUrlstringrequiredFeihan backend URL
enabledbooleantrueEnable/disable this account
enableEncryptionbooleantrueUse encrypted communication between OpenClaw and Feihan server
requestTimeoutnumber30000How long to wait for a response from Feihan server before timing out (in milliseconds)

Step 7 — Verify the Bot

Once the plugin is installed, open the Feihan client, search for OpenClaw in the search bar, and you should see it appear under Contacts. Click to start a conversation and verify the bot is working correctly.

Search for OpenClaw bot in Feihan client

You have successfully deployed the OpenClaw plugin. Your team members can now interact with the OpenClaw bot in the Feihan client.