Integrate OpenClaw with Discord - Simple Application Server

This document shows how to integrate the OpenClaw service with Discord. This integration lets you interact with OpenClaw directly in Discord using natural language.

Prerequisites

Before you configure the messaging channel, you must purchase and configure a Simple Application Server instance with the OpenClaw application image. You can follow the steps in this section or refer to Deploy OpenClaw image. If you have already completed this setup, you can skip this section.

Purchase and configure a Simple Application Server instance with the OpenClaw application image

Step 1: Purchase an OpenClaw plan

Important

If you already have a Simple Application Server instance, you can skip this step and deploy OpenClaw using the reset system feature. When you reset the system, select the OpenClaw image from the list of application images. Resetting the system erases all data on the system disk. Back up your data if necessary. For more information, see Reset system.

Purchase a Simple Application Server instance pre-installed with the OpenClaw application.
On the Simple Application Server page, resource configurations are preset. If you want to change any settings, refer to the following descriptions.
- Instance: Memory must be 2 GiB or higher. You can switch plans based on your needs.
- Region: The default is US (Virginia).
  Important
  Servers in Chinese mainland regions cannot be configured to work with overseas IM applications such as WhatsApp, Telegram, Discord, and Slack.
- Purchase Configuration: The default subscription period is 12 months. You can change the duration based on your needs.

Step 2: Configure OpenClaw

In the Simple Application Server console, click the instance ID on the server card. On the Server Overview page, click the Application Details tab.
In the Steps to Use OpenClaw section, click Execute Command under Open Port to open firewall access to the port that the OpenClaw service uses.
Important
- To prevent malicious scanning and targeted attacks, OpenClaw no longer uses a fixed default port during initialization. Instead, it automatically generates a random port. You can view the port number of OpenClaw in the console.
- Opening the port exposes the service to public access. You can disable public access to the Web UI with a single click. For more information, see How to enable or disable public access to the OpenClaw Web UI?
Click Execute Command under Configure OpenClaw to configure the Model Studio API Key.
You can configure two types of Model Studio API Keys:
- Coding Plan plan-specific API Key (recommended): This plan uses a fixed monthly fee and provides a monthly request quota. Calls that exceed the quota fail and do not incur charges. This prevents unexpected costs.
  The Coding Plan currently supports models such as qwen3.5-plus, kimi-k2.5, MiniMax-M2.5, and glm-5. For a detailed list of models, see Coding Plan overview.
- A Model Studio API Key billed by token usage.
You can configure the API Key using System Recommendation or Manual Input. For cost control, the system recommends the Model Studio Coding Plan API Key. For lower latency, it recommends the API Key for the Model Studio service that is geographically closest to your server. If you need to use an API Key from a different region or account, select Manual Input.
- System Recommendation (drop-down list)
  After you make a selection, click Next.
  Server region
  Recommended API region
  Coding plan API region
  US and European regions
  US (Virginia)
  Singapore
  China (Hong Kong) and other Asian regions
  Singapore
- Manual Input
  Click the button to switch to manual input. Enter the Model Studio API Key, select its corresponding region, and then click Next.
  Important
  If you manually configure the API Key, make sure you select the correct region for the API Key. If you select an incorrect region, model calls fail.
Under Access Web UI Panel, click Get Address to obtain the address of the OpenClaw Web UI. You can use this web page to chat with the OpenClaw agent.
If required, you can refer to Disable public access to the OpenClaw Web UI to disable public access to the Web UI with one click.
(Optional) View the token.
In Application Details > Basic Configuration > View Token, click View to view and save the token.
Warning
Do not share the full URL that contains the token. This link includes authentication credentials. Anyone who has this link can bypass login verification and gain administrator access to the OpenClaw console.

Prepare Discord

Log in to the Discord Developer Portal, click the New Application button, enter a name for the Discord Bot, agree to the terms, and click the Create button.
Go to the Application page, click Bot in the left navigation bar, and click Reset Token to generate a new token.
Important
After you confirm, Discord generates a token. Important: Copy this token and store it securely. Do not share it publicly. You will need this token for the OpenClaw configuration.
On the Bot page, scroll down to Privileged Gateway Intents and enable Message Content Intent, Server Members Intent, and Presence Intent. Click Save Changes at the bottom.
Click OAuth2 on the left side of the page and select OAuth2 URL Generator.
1. Configure Scopes. We recommend that you first select bot and applications.commands based on the principle of least privilege.
2. Configure Bot Permissions and select View Channels, Send Messages, Read Message History, Embed Links, Attach Files, and Add Reactions.
In a browser, open the Generated URL at the bottom of the page and select the Discord server where you want to add the bot. Click Continue and grant authorization to invite the bot to the corresponding Discord server.
Important
You must have administrator permissions for the Discord server you select.

Integrate with Discord

1. Configure Discord in the OpenClaw wizard

Go to the Servers page in the Simple Application Server console.
On the server card, click Remote Connection.
In the Remote Connection dialog box, select Connect with One-click on Workbench and click Log On Now.
After you log on to the server, run the following command.
Note
Use your keyboard for the following steps. Use the arrow keys to navigate and press Enter to confirm your selections.
```
openclaw onboard
```
A prompt will ask if you understand the risks. Select Yes to continue.
For the Onboarding mode, select QuickStart.
For Config handling, select Use existing values.
For Model/auth provider, select Skip for now > All providers > Keep current.
Note
If you have already configured the Model Studio API Key in the previous steps, you can skip this step. If you have not yet configured a model, you must configure the model API Key at this step from the command line.
Next, in the Select channel step, select Discord (Bot API).
Enter the Discord bot token that you saved in the previous step.
Set Configure access permissions to Yes.
For Access Permission Mode, select Open (allow all channels).
Configure Skills. Select No. For an initial deployment, limiting permissions improves stability and security.
Enable Hooks (if prompted). Select session-memory.
Select Restart to apply the configuration.
Install command completion (if prompted). Select No.
Important
Selecting Yes can cause high CPU load on the server, which may lead to performance issues with OpenClaw.
After you complete these steps, the system automatically finishes the deployment. The deployment is complete when the configuration wizard closes and the command-line interface appears.

2. Test the bot

In your Discord server's contact list, click the Discord bot you added and send it a message.
During the first interaction, the bot automatically generates a pairing code.
Remotely connect to your Simple Application Server and run the following command:
Important
Replace <code> in the command with your Pairing code. Do not include the <> symbols.
```
openclaw pairing approve discord <code>
```
OpenClaw is now connected to Discord.

Server region	Recommended API region	Coding plan API region
US and European regions	US (Virginia)	Singapore
China (Hong Kong) and other Asian regions	Singapore	Singapore