Docs

ArkClaw Enterprise

Creating agent teams for ArkClaw

Building and managing my agents

You can build dedicated agents for ArkClaw, allowing multiple intelligent roles to perform their respective duties and independently handle assigned business tasks. In addition, the primary agent can automatically identify and assign tasks to matching sub-agents for multi-role collaboration.

Main advantages:

Flexible identity switching

You can switch to the appropriate agent identity with one click based on task requirements. For example, you can switch from "Recruitment specialist" to "Technical review expert", which enables a smooth transition across domains.

Lower O&M costs

All agents share the same underlying ArkClaw instance resources. You do not need to create or maintain separate ArkClaw instances for different businesses, nor do you need to modify configurations repeatedly. This significantly reduces resource consumption and routine O&M costs.

Intelligent task distribution

The primary agent (agent ID: main) can, based on business workflows and actual scenarios, automatically break down and assign tasks to each sub-agent via conversational commands. This enables multi-role collaboration and parallel task processing, greatly increasing overall task efficiency.

Prerequisites

You have purchased an ArkClaw instance as the primary agent. For details, refer to Creating your dedicated ArkClaw with one click.

Build my agents

ArkClaw allows you to build agents using preset templates or custom settings.

Use templates to build agents (recommended)

The Agent Gallery provides a variety of preset templates. Each template is pre-configured with skill plugins, souls, and permission rules. You can quickly build an agent with such a template.

Switch to the target ArkClaw page.

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

On the "Agent Gallery" tab, select a template that suits your business scenario, and then click "Add and initiate task". You are automatically redirected to the chat page where the current agent is selected, and the task is initiated. At the same time, the agent is automatically added to "My agents". You can then specify this agent whenever you initiate a task.

You can add multiple agents by using this method.

Use custom settings to build agents

If the preset agents in Agent Gallery do not meet your business goals, job responsibilities, or workflow requirements, you can create a custom agent. The following two creation methods are supported:

Create with AI

Enter a natural language description of your business requirements, and the system automatically generates an initial agent configuration. You can also manually modify it and continue to make fine-grained adjustments. This method is suitable for scenarios where you are not yet familiar with the agent configuration structure and want to quickly generate an initial setup from a requirements description, or where you are unfamiliar with individual configuration items and need the system to assist with the basic configuration.

Upload agent

Upload a local agent configuration package to complete deployment quickly. This method is suitable for scenarios where you already have a ready-made agent package and need to migrate it to the current account or workspace, or where you want to reuse the same agent configuration across multiple environments such as development, testing, and production.

Method 1: Create with AI (recommended)

Switch to the target ArkClaw page.

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

In the upper-right corner of the page, click "Add custom agent > Create with AI", and then choose to add a custom agent through the user interface or the chat box as needed.

Create manually via user interface
Quickly generate via prompt or natural language (recommended)
Visual manual creation supports fine-grained customization of all parameters, enabling precise debugging and standardized management. Suitable for complex and highly customized business scenarios.
Modify name and description: On the right side of the "Create agent" page, enter the agent name and description in the "Name" and "Description" fields, respectively.
Name: Enter a name for the agent. We recommend that you use a clear and easy-to-understand name to facilitate subsequent identification and management.
Description: Briefly describe the core features and application scenarios of the agent to facilitate subsequent matching with corresponding business requirements.
Configure agent capabilities.
Primary model: The model defaults to inheriting from the primary agent (agent ID: main). Click "Edit" to adjust it based on your requirements. For more information, see Configuring models for my agents.
Skills: By default, skills are preset. You can click "Edit all" or "+ Add" in the Skills section to add skills. For more usage instructions, refer to Configuring skills for my agents.
Tools: By default, tools are preset and enabled. You can click "Edit all" in the Tools section to make adjustments based on actual needs. For more usage instructions, refer to Configuring tools for my agents.
Code of conduct/Workflow/Agent profile/User profile: Check whether the content generated by the system meets your expectations. If adjustments are required, click the corresponding tab (e.g. "Agent profile") to switch to the configuration page, and directly modify the content in the text editing area. Modifications take effect immediately. For more usage instructions, refer to Configuring .md files for my agents.
Debug agent configuration: To verify whether the configuration meets expectations, we recommend that you perform debugging before completing the creation.
Click the "Debugging" button. In the pop-up chat box, enter and send commands in natural language.
View the debugging results:
If the results meet your expectations, click the "Complete creation" button.
If the results do not meet your expectations, click the "Exit debugging" button and reconfigure the agent.
Create agents using natural language or preset prompts. This approach is easy to get started with, efficient to set up, and applicable to a wide range of scenarios, with no complex manual configuration required. It significantly reduces the cost of creating and maintaining agents. Most suitable for quickly creating general-purpose agents.
Initiate a creation request: On the left side of the "Create agent" page, generate the initial configuration of the agent via natural language description or quick prompt.
Quick prompt: Select the corresponding prompt as instructed on the page and send it.
Natural language description: Enter the natural language description of the target agent in the chat box and send it.
Confirm the solution outline and initiate the build: After the system generates the solution outline, review the proposed agent name, core feature list, and other content, and confirm or adjust them based on business requirements:
Adjust the outline: If the solution fails to meet your expectations, click the "Request changes" button and add detailed revision comments to let the system regenerate the content.
Confirm the build: If the solution meets your business requirements, click the "Build" button. The system will automatically complete the basic configuration and initialization of the agent based on the solution outline, and output the change summary of the build process on the left.
Confirm and adjust the agent capabilities.
After the build is complete, the full configuration panel for the agent appears on the right side of the page. You can review and adjust the following content as needed:
Agent name/Description: Confirm whether the name and description generated by the system are accurate. If adjustments are required, directly modify the corresponding content. Modifications take effect immediately.
Primary model: The model defaults to inheriting from the primary agent (agent ID: main). Click "Edit" to adjust it based on your requirements. For more information, see Configuring models for my agents.
Tools: By default, tools are preset and enabled. You can click "Edit all" in the Tools section to make adjustments based on actual needs. For more usage instructions, refer to Configuring tools for my agents.
Skills: If the automatically generated skills do not fully cover your scenarios, click "+ Add" in the Skills section to add skills. For more usage instructions, refer to Configuring skills for my agents.
Code of conduct/Workflow/Agent profile/User profile: Switch to the corresponding configuration page (e.g., "Agent profile"), and edit the code of conduct, workflow, agent profile, and user profile separately to give ArkClaw a dedicated identity, response guardrails, standard operating procedures, and user-awareness capabilities. For more usage instructions, refer to Configuring .md files for my agents.
Debug agent configuration: To verify whether the configuration meets expectations, we recommend that you perform debugging before completing the creation.
Click the "Debugging" button. In the pop-up chat box, enter and send commands in natural language.
View the debugging results:
If the results meet your expectations, click the "Complete creation" button.
If the results do not meet your expectations, click the "Exit debugging" button and reconfigure the agent.

Method 2: Create a custom agent by uploading a file

Create an agent by uploading a local package to import the agent configuration. After the upload is complete, the system automatically parses the package contents and initializes the agent. This method is primarily suitable for migrating an existing agent across environments.

warning

Prepare the agent package to upload. The file must be in .zip or .tar.gz format and must not exceed 10 MB.

If you have not yet prepared the agent package, or are unfamiliar with its internal structure, you can obtain a reference file in either of the following ways:

Click "Download and view sample.zip file" to download a sample file, and then use its directory structure and configuration specifications as a reference to prepare your file.

Refer to "Export an agent" in Manage my agents to export an existing agent as a standard configuration package for direct upload.

Go to the upload page.

Switch to the target ArkClaw page, and select "Agent Center" in the left-side navigation pane.

In the upper-right corner of the page, select "Add custom agent > Upload agent".

Upload agent: Click the upload area (inside the dashed box) and follow the on-screen instructions to select a local file, or drag and drop the .zip file directly into the dashed box, and then wait for the upload to complete.

tip

If you have not yet prepared the agent package, or are unfamiliar with its internal structure, you can obtain a reference file in either of the following ways:

Click "Download and view sample.zip file" to download a sample file, and then use its directory structure and configuration specifications as a reference to prepare your file.

Refer to "Export an agent" in Manage my agents to export an existing agent as a standard configuration package for direct upload.

Confirm and adjust the agent capabilities.

After the upload is complete, the full configuration panel for the agent is displayed on the right side of the page. You can check or adjust the following as needed:

Agent name/description: To make adjustments, modify the content directly. Modifications take effect immediately.

Primary model: The model defaults to inheriting from the primary agent (agent ID: main). Click "Edit" to adjust it based on your requirements. Learn more

Tools: The tools currently supported by this agent. Click "Edit all" in the Tools section to adjust as needed. Learn more

Skills: The skills currently supported by this agent. Click "+ Add" in the Skills section to add a skill. Learn more

Code of conduct/Workflow/Agent profile/User profile: The code of conduct, workflow, agent profile, and user profile currently supported by this agent. If adjustments are required, click the corresponding tab (e.g., "Agent profile") to switch to the configuration page, and directly modify the content in the text editing area. Modifications take effect immediately. Learn more

Debug agent configuration: To verify whether the configuration meets expectations, we recommend that you perform debugging before completing the creation.

Click the "Debugging" button. In the pop-up chat box, enter and send commands in natural language.

View the debugging results:

If the results meet your expectations, click the "Create" button.

If the results do not meet your expectations, click the "Exit debugging" button and reconfigure the agent.

Manage my agents

After the setup is complete, your agent appears as a card in the "My agents > Custom agents" list. You can perform the following actions:

Use an agent to initiate a task

View agent details

Delete the agent

Update agent configuration

Export an agent

Select the target card and click the "Initiate task" button on the card. The system will automatically redirect to the chat box, and you can start using ArkClaw.

Subsequent steps

After adding agents, you can enable the team collaboration scheduling mode. The system then intelligently matches specialized sub-agents to handle cross-domain collaboration to improve task processing efficiency. Learn more

Last updated: 2026.10.14 17:50:22