PolarDB Agent Express

更新时间:
复制 MD 格式

A PolarDB Agent Express application provides two connection endpoints: one for the PolarDB Agent Express Dashboard and another for SSH. The dashboard allows you to manage the application through a graphical user interface, while SSH provides management access through a command-line interface. This guide explains how to obtain these connection endpoints and manage your PolarDB Agent Express application using both the dashboard and SSH.

Prerequisites

  1. Configure an IP address whitelist or security group for the PolarDB Agent Express application.

  2. Obtain the connection endpoints for the PolarDB Agent Express application.

PolarDB Agent Express Dashboard

The PolarDB Agent Express Dashboard is the graphical management interface for a PolarDB Agent Express application. It provides features such as Skills management, conversational interaction, and system configuration. For more information about configuration, see the OpenClaw documentation.

  1. In a web browser, open the public network connection endpoint for your PolarDB Agent Express application.

    Note

    On the AI application list page, you can also click Actions in the Develop Application column of the target application to open the PolarDB Agent Express Gateway panel.

  2. On the Control page, go to the Overview tab. Enter the gateway token, which is the value of the secret.gateway.auth.token configuration parameter, and then click Connect. A normal health status in the upper-right corner indicates a successful connection.

Log on and manage with SSH

After you log on to a PolarDB Agent Express application by using SSH, you can perform system administration tasks and use the OpenClaw CLI tool.

Logging on to PolarDB Agent Express

Run the following command to log on to the PolarDB Agent Express application:

ssh node@<connection-endpoint> -p<port>

If you receive a no matching host key type found error, add the following parameters to your command:

ssh -o HostKeyAlgorithms=+rsa-sha2-512,rsa-sha2-256,ecdsa-sha2-nistp256,ssh-ed25519 \
    -o PubkeyAcceptedKeyTypes=+rsa-sha2-512,rsa-sha2-256,ecdsa-sha2-nistp256,ssh-ed25519 \
    node@<connection-endpoint> -p<port>
Note
  • The username is node, and the default port is 2222. Replace <connection-endpoint> with the private or public network SSH connection endpoint for your PolarDB Agent Express application.

  • The SSH logon password is set with the secret.ssh.password parameter. Before logging on for the first time, go to the Configure tab on the application details page and click Modify to set the password. The PolarDB Agent Express application does not store the password in plaintext. Store it securely.

Configuring password-free logon

After your first logon, add your local SSH public key to the /home/node/.ssh/authorized_keys file in the PolarDB Agent Express application. This allows password-free logon for subsequent sessions.

  1. In your local terminal, display your public key:

    cat ~/.ssh/id_rsa.pub
  2. After you log on to the PolarDB Agent Express application, append your public key to the authorized_keys file:

    echo "your-public-key-content" >> /home/node/.ssh/authorized_keys

Using the OpenClaw CLI

After logging on to PolarDB Agent Express, run the following command to set an alias for the OpenClaw CLI:

alias openclaw='node /app/dist/index.js'

Once the alias is set, you can use the openclaw command to manage the PolarDB Agent Express application. For example, to view installed Skills, run the following command:

openclaw skills list