Docs

ArkClaw Enterprise

Changing agent configuration

Configuring .md files for my agents

By configuring Markdown (.md) files, you can define independent codes of conduct, workflow, profile, and user profile for each agent in ArkClaw and your team. This transforms every ArkClaw agent into a customized intelligent assistant with a distinct identity, strict operational boundaries, structured processes, and a deep understanding of its users.

Descriptions of Markdown file configurations and usage scenarios

Code of conduct (SOUL.md)

This file defines the baseline rules, security constraints, and core values that the agent must strictly follow. It covers value principles, prohibited actions, decision-making logic, and communication guidelines. Its purpose is to explicitly state what the agent must not do, as well as the criteria for judgment and trade-offs when encountering conflicts.

ArkClaw provides a default set of general code of conduct for each agent, which covers most business scenarios. We recommend keeping the default configuration. If the default content does not meet your business needs, you can adjust it as required.

Workflow (AGENTS.md)

This file defines the agent's business processes, collaboration standards, and task orchestration logic, including session start/stop conditions, task breakdown, delivery requirements, and collaboration agreements. The file defines how agents perform tasks and clarifies rules for starting, processing, and concluding individual sessions and tasks. You can choose whether to configure this based on your actual business needs.

Configuration not required: Lightweight Q&A agents, such as FAQ assistants or terminology translation tools, do not require a workflow.

Configuration required: When the agent needs to handle multi-step processes, clear sequences, or task decomposition scenarios, you can set up a workflow to ensure orderly and traceable execution. For example, a ticket assistant can operate following a 6-step workflow: "Receive ticket → Categorize → Assign → Track → Resolve → Satisfaction survey". This enables standardized management of the entire ticket lifecycle.

Agent profile (IDENTITY.md)

This file defines the core identity and soul of the agent, including its name, personality, and identity definition. It is used to clearly define "who I am" and maintain a consistent communication style and role identity. ArkClaw provides a preconfigured agent profile for each agent, covering most business scenarios. We recommend keeping the default configuration. If the default content does not meet your business needs, you can adjust it as required.

User profile (USER.md)

This file records basic user information and communication preferences, such as preferred forms of address, interaction habits, context memory, and privacy boundaries (for example, explicitly setting rules like "Do not discuss salary or politics in work contexts", which prompts the agent to proactively avoid these topics). This allows the agent to adapt to personalized needs and provide customized services in a more tailored manner.

Configuration not required: You do not need to configure a user profile if the agent serves a general audience and does not require personalization or long-term interaction, for example, disposable or short-term agents such as event Q&A bots, temporary launch-event assistants, or time-limited support helpers.

Configuration required: When personalized interaction or custom usage preferences are needed, configure a user profile to allow the agent to precisely adapt to your communication style, usage habits, and specific rules.

Operation instructions

Agent templates marked with the Featured label are featured templates. These templates incorporate prompts, workflows, dedicated skills, and other components that have been refined by the platform over time. As core digital assets of the platform, they are available for direct use only. Viewing detailed configurations and making edits or modifications are not supported.

Procedure

Step 1: Enter the Markdown configuration page

Switch to the target ArkClaw page.

In the left-side navigation pane, click "Agent Center".

Click the "My agents" tab.

Select the target agent and click the "Edit" or "View details" button.

Step 2: Configure agent Markdown files

By configuring a set of standardized Markdown (.md) files, you can define the agent's code of conduct, workflow, profile, and user profile. This enables fine-grained management of the agent without writing code.

In the MD configuration section, click the "Code of conduct"/"Workflow"/"Agent profile"/"User profile" tab to switch to the corresponding configuration page.

Click the text editing area and edit the content directly.

tip

You can write the content using your preferred format, such as plain text, bulleted lists, tables, or Markdown. The agent will parse it correctly.

After you complete editing, click the "Save" button to complete the operation.

(Optional) If you need to discard your current modifications, click the "Cancel" button.

tip

After canceling, unsaved content will be lost and cannot be recovered.

Last updated: 2026.07.31 18:50:44