Customize Your Agent

Agent Configuration

Create your agent configuration file in the config/agents/ directory. You can use the provided default.agent.json as a template or create your own:

{
  "name": "Your Agent name",
  "bio": "Your AI Agent Bio",
  "lore": [
    "Some lore of your AI Agent 1",
    "Some lore of your AI Agent 2"
  ],
  "objectif": [
    "first objectif that your AI Agent need to follow",
    "second objectif that your AI Agent need to follow"
  ],
  "knowledge": [
    "first knowledge of your AI Agent",
    "second knowledge of your AI Agent"
  ],
  "interval": "Your agent interval between each transaction in ms",
  "chat_id": "Your Agent Chat-id",
  "external_client": [
    "first external_client",
    "second external_client"
  ],
  "allowed_external_client_tools": [
    "first allowed_external_client_tools",
    "second allowed_external_client_tools"
  ],
  "mcp" : true || false
}

Configuration Fields Explained

Below is a list of fields for defining an agent:

Field	Description
`name`	Your agent's identifier.
`bio`	A brief description of your agent's purpose.
`lore`	Background information that defines your agent's character.
`objectif`	A list of tasks and goals your agent should accomplish.
`knowledge`	Areas of expertise your agent should have.
`interval`	Time between actions (in milliseconds) for autonomous mode.
`chat_id`	Unique identifier for chat sessions.
`external_client`	List of external platforms (e.g., 'discord', 'wikipedia').
`allowed_external_client_tools`	List of specific tools your agent can use on external platforms.
`mcp`	Boolean value that enables or disables MCP (Model Context Protocol) features. .

The agent will check these limits before executing any transfers. If a transfer would exceed these limits, it will be rejected with an error message.

Social Media Integration

Environment Setup

Add these variables to your .env file:

To configure your environment for social media, you must establish the appropriate connections with the various platforms. This step is essential to enable your agent to interact with social networks, publish content, monitor mentions, and analyze the performance of your posts.

Social Network	Link to README
Twitter	Twitter README (opens in a new tab)
Discord	Discord README (opens in a new tab)
Telegram	Telegram README (opens in a new tab)

Running Your Agent

Ensure all configurations are in place.

Start the agent by specifying your config file:

pnpm run local --agent=your-config-file.json

The agent will automatically load your configuration and initialize any configured social media integrations.

Create Your First Agent Agent Actions