Skip to main content

Set up OpenHands to connect to FriendliAI. Once you complete these steps, your agent will send requests to FriendliAI.

To get started, complete the following steps:

1

Install OpenHands

If you haven't already, install OpenHands.

2

Get a FriendliAI API Key

If you need a new API key, create one.

3

Set Up OpenHands

  1. Start Agent Canvas. Then, open http://localhost:8000.
  2. On Choose your agent, select OpenHands. Then, click Next.
  3. On Set up your LLM, click the Advanced tab.
  4. Connect OpenHands to FriendliAI’s API:
    1. In Authentication, select API key.
    2. In Custom Model, enter the FriendliAI model ID with the friendliai/ provider prefix. For example, enter friendliai/zai-org/GLM-5.3.
    3. In Base URL, paste the following FriendliAI base URL:
    4. In API Key, paste your FriendliAI API key.
    5. Click Next.
If you already finished the first-time setup, open Settings > LLM and add a new LLM profile with the same values instead.
To learn more, see OpenHands Docs > Manage LLM Profiles.
4

Send a Prompt to OpenHands

Open your agent and send a prompt. For example, use the following prompt:

Explore your codebase.

To learn more, see OpenHands Docs > First Time Setup.

Help

Find answers to common agent setup questions.
Last modified on September 2, 2026