Agent Configuration

Character Files (.json)

In ElizaOS, the "Soul" of the agent is defined in a single JSON file. This file controls the LLM (Large Language Model) prompting strategy.

Example: the_necromancer.json

{
  "name": "The Necromancer",
  "bio":,
  "lore":,
  "knowledge":,
  "style": {
    "all": ["archaic", "mysterious", "quantitative"],
    "chat": ["direct", "cryptic"]
  }
}

agent.config.json Reference

While the character file defines personality, the configuration file defines physics—the hard limits of what the agent is allowed to do.

Key Parameters:

  • riskLevel: 0.1 to 1.0. Controls the percentage of the Treasury allocated to a single trade.

  • buybackThreshold: 0.5 SOL. The minimum accumulated fees required to trigger a buyback event.

  • aggressionFactor: Determines slippage tolerance. High aggression means the agent will pay more gas to ensure a trade executes during high volatility.

  • allowedProtocols: A whitelist of contract addresses (e.g., Raydium, LazarusWrapper, Pump.fun) the agent can interact with.

Last updated