Hey Team wave Been exploring the Agent Server implementation OpenHands #questions

Hey Team :wave: Been exploring the Agent Server i...

numerous-ambulance-67850

12/19/2025, 4:29 PM

Hey Team 👋 Been exploring the Agent Server implementation, when a agent server is stopped and started again, the existing conversation's llm api key (agent.llm.api_key) which was configured at the time conversation was created gets set to null. Is this expected ? Is there a way to update this llm key again ?

numerous-ambulance-67850

12/19/2025, 5:12 PM

The conversation doesn't update the new incoming state if it already exists. https://github.com/OpenHands/software-agent-sdk/blob/a3c39a54af6b481e311a2d5949585[…]nds-agent-server/openhands/agent_server/conversation_service.py

wooden-umbrella-84098

12/19/2025, 8:21 PM

CC @straight-sundown-84319 @chilly-france-44439

straight-sundown-84319

12/19/2025, 8:26 PM

Hi Mahesh! There is indeed a way! The key is this line in the logs when the server starts:

Copy code

[12/19/25 13:24:43] WARNING  ⚠️ OH_SECRET_KEY was not defined. Secrets will not be persisted between restarts.   config.py:148

We value your security, and do not store your LLM keys unencrypted. To fix this error, define an environment variable

OH_SECRET_KEY

e.g.:

Copy code

export OH_SECRET_KEY=notasecret

The agent server will then use this to encrypt your LLM keys when storing and loading them.

numerous-ambulance-67850

12/20/2025, 10:37 AM

This works thanks! I now understand how pydantic serialisation/deserialistion was happening.

numerous-ambulance-67850

12/20/2025, 10:55 AM

I also asked about this to the AI Chatbot on the OpenHands SDK homepage, but it wasn't able to answer. I feel it would be worth adding this to the docs. I have created a small PR noting this behaviour in the README of agent server. https://github.com/OpenHands/software-agent-sdk/pull/1465 Would love your feedback. Thanks.

Open in Slack

Previous Next