Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.openhands.dev/llms.txt

Use this file to discover all available pages before exploring further.

Agent Canvas separates Customize from Settings.
  • Customize — teach the agent new things. Skills give it domain knowledge and specific instructions. MCP Servers connect it to external tools and data sources.
  • Settings — configure how the agent runs. Choose your LLM, store secrets, tune context handling, and set agent behavior. Settings are saved per backend.

Customize

Open the top-level Customize area to manage: Use the section navigation inside Customize to switch between those pages.
MCP configuration lives under Customize > MCP Servers, not under Settings.

Settings

The Settings area currently includes the following sections:
SectionPurpose
AgentAgent behavior and agent-specific capabilities
LLMProvider, model, API key, and profile configuration
CondenserContext compression and summarization behavior
VerificationApproval and verification-related behavior
ApplicationUI-level preferences and app behavior
SecretsStored secrets used by the active backend
On local backends, the LLM page also includes an Available Profiles area for saved profiles.

Configuration Is Per Backend

Both Customize and Settings are tied to the active backend. That means:
  • Changing backends changes which configuration you are editing
  • Skills, MCP servers, secrets, and other settings saved for one backend do not automatically apply to every other backend
  • The available options can differ depending on backend capabilities

Practical Example

You might use this split like this:
  • Add a GitHub review skill in Customize > Skills
  • Add a Slack or fetch MCP server in Customize > MCP Servers
  • Save your preferred model in Settings > LLM
  • Store tokens in Settings > Secrets