DocsICP FilingConsole
官方文档
首页

One-click deployment of Hermes Agent on EDS

更新时间：
复制 MD 格式
我的收藏

Deploy Hermes Agent on Elastic Desktop Service (EDS) and integrate it with IM platform bots such as DingTalk, WeChat, Lark, and WeCom. Hermes Agent is an open-source AI agent with a built-in learning loop that accumulates skills from experience and keeps evolving. It supports multi-channel communication, works with mainstream large language models (LLMs), and can be deployed in the cloud at low cost.

Prerequisites

Note

Hermes Agent cloud computers support only Linux. Windows and other operating systems are not supported. Before you purchase or change an image, make sure the cloud computer runs Linux.

Account and authentication

Register an Alibaba Cloud account, and complete Individual identity verification or Enterprise identity verification.

Get an LLM API key

Hermes Agent requires an LLM API key to run. Before deployment, prepare the following:

  • Base URL: the endpoint of the LLM service

  • API Key: the access key for authentication

  • A list of supported model IDs

If you don't have an API key, use the Alibaba Cloud Bailian Token Plan. It uses pay-as-you-go billing, suitable for individual users exploring LLM capabilities. See Quick start (Alibaba Cloud Bailian Token Plan).

Download the Alibaba Cloud Workspace client

  1. Go to the Alibaba Cloud Workspace client page to download the client for your platform. macOS, Windows, Android, and iOS clients are available.

  2. After the download completes, sign in to EDS Personal Edition with your Alibaba Cloud account. See Cloud computer usage overview.

Important

Hermes Agent deployment involves sensitive information such as IM platform account credentials and LLM API keys. Follow these security practices:

  • Keep API keys and IM platform credentials safe and prevent unauthorized disclosure.

  • Configure and use Hermes Agent only in trusted network environments.

  • Regularly review and rotate API keys to keep your account secure.

Deploy a cloud computer

Create a Hermes Agent cloud computer

Purchase a cloud computer

  1. Go to the EDS quick purchase page.

  2. Follow the on-screen instructions to purchase HermesAgent One-Click Deployment. The plan includes an EDS Personal Gold monthly card with 2,000 Wuying Credits.

    Note

    Wuying Credits are the billing unit for cloud computer resource consumption. For example, on a 4-core CPU/8 GiB memory cloud computer, 2,000 Wuying Credits support 500 hours of runtime. See Lingdou.

Change the image of an existing cloud computer

Important

Changing the image erases all software and personal data on the system disk and data disk of the cloud computer. This data cannot be recovered. Proceed with caution.

  1. Open the Alibaba Cloud Workspace client and select Personal Edition to sign in.

    image

  2. After you sign in to the Workspace client, click Manage on the target cloud computer card.

    image

  3. On the management page, click the Image tab, then click Change Image.

  4. Click Select Image. On the image selection page, click Favorite Image by Image Code.

  5. Enter the image code HermesAgent (case-sensitive), then click OK.

  6. Select the favorited HermesAgent image, then click OK.

  7. On the Change Image page, click Confirm Shutdown and Change. Wait for the image update to complete, then connect to the cloud computer to start configuration.

Configure 24/7 operation

To keep Hermes Agent running 24/7, disable the auto-shutdown/sleep-on-disconnect feature of the cloud computer.

  1. Click Manage on the target cloud computer card.

  2. Click the Policy tab, then turn off Auto-shutdown/Sleep on Disconnect.

Configure Hermes Agent

After the cloud computer is deployed, configure Hermes Agent.

Configure the LLM

Configure a model for Hermes Agent to enable AI conversation. Two configuration methods are supported:

Configure the model in the Hermes console

image

  1. Open the Workspace client, sign in to Personal Edition, and connect to the Hermes Agent cloud computer you created.

  2. Open the Hermes app on the desktop to start configuration.

  3. In the Hermes left navigation pane, click Models, then click Add Provider.

  4. Click Custom, then configure the Base URL, API Key, and default model.

  5. After configuration, click Add.

Configure the model in the mini program

  1. Scan the following QR code to sign in to the EDS Personal mini program.

    image

  2. Click the Hermes cloud computer card you created, then click Hermes App Configuration.

  3. On the Model Configuration page, click Add Model.

  4. Select a Provider and Model Name, enter the API Key, then click Add and Enable.

Configure the WeChat channel

After you configure the WeChat channel, you can send tasks and commands to Hermes Agent through WeChat.

  1. Open the Hermes app on the Hermes Agent cloud computer desktop.

  2. In the Hermes left navigation pane, click Channels. In the Weixin section, click Scan to Log In.

  3. Open WeChat and start a chat with the AI bot.

Troubleshoot WeChat integration

If you can't send messages to Hermes Agent through WeChat after configuration, follow these steps to troubleshoot:

  1. Wait for the gateway to be ready: After the first configuration, the gateway service may take 1–2 minutes to start. If there's no response after 5 minutes, try restarting the Hermes app.

  2. Check the WeChat login status: After scanning the QR code, make sure WeChat shows "Logged in." If the session disconnects, scan the QR code again to sign in.

What's next

Switch the cloud computer OS language

To switch the cloud computer OS interface language:

  1. Click the icon in the upper-right corner of the desktop to open Settings.

  2. In the left navigation pane, select Region & Language.

  3. Click Manage Installed Languages.

  4. On the Language tab, drag the target language to the top of the list.

  5. Click Apply System-Wide.

  6. Restart the cloud computer for the change to take effect.

Important

Restarting or stopping the cloud computer will terminate running processes and lose unsaved files and data. Before restarting, make sure all data in the cloud computer is saved or backed up.

Upgrade Hermes

When Hermes Agent starts, it prompts you to upgrade if a new version is detected. Before upgrading, note the following:

  • If errors occur after the upgrade (such as resolve_runtime_provider-related errors), restore from a restore point to revert to the pre-upgrade state: sign in to the Workspace client, click Manage on the target cloud computer card, click the Restore Point tab, select the restore point from before the upgrade, then click Restore. Restore points are created automatically by the system at approximately 5:00 AM every day.

  • If problems persist after restoring, click Restore to Initial Image on the Image tab, or change the image of the cloud computer to the Hermes image.

Important

Image changes erase all data. Back up important configurations before proceeding.

Previous：Redeem cloud computers and Wuying Credits with a voucherNext：Deploy CoPaw on EDS Personal in one click