import{_ as e,o as r,c as o,ag as a}from"./chunks/framework.DXGyWiRo.js";const m=JSON.parse('{"title":"Bot Management","description":"","frontmatter":{},"headers":[],"relativePath":"getting-started/bot.md","filePath":"getting-started/bot.md","lastUpdated":1774787421000}'),n={name:"getting-started/bot.md"};function i(s,t,d,l,g,c){return r(),o("div",null,[...t[0]||(t[0]=[a('

Bot Management ​

A Bot is an independent AI agent that comes with its own isolated container, persistent memory, and configurable personality. Bots can chat via various messaging platforms (Channels) and perform complex tasks using specialized tools.

Creating a Bot ​

  1. Navigate to the Bots page from the sidebar.
  2. Click the Create Bot button.
  3. Fill in the basic info:
  4. Click Create.

Bot Detail Page ​

Once created, clicking on a bot card takes you to its Detail Page, where you can manage its entire lifecycle through specialized tabs.

Tab Overview ​

TabDescription
OverviewHealth checks for container, database, channels, and memory.
GeneralCore settings: models, providers, reasoning, heartbeat, compaction, and danger zone.
ContainerContainer lifecycle (create/start/stop), snapshots, data export/import.
MemoryBrowse, search, create, edit, and compact memories.
PlatformsChannel configurations (Telegram, Discord, Feishu, QQ, Matrix, WeCom, WeChat, Web).
AccessACL rules — control who can chat with the bot.
EmailEmail bindings and outbox.
TerminalInteractive terminal access to the bot's container.
FilesFile manager for the bot's container filesystem.
MCPMCP connection management (Stdio, Remote, OAuth).
HeartbeatHeartbeat configuration and execution logs.
CompactionMemory compaction logs.
ScheduleCron-based scheduled tasks and execution logs.
SkillsMarkdown-based skill files that define bot personality and capabilities.

Configuring the Bot's Core Settings ​

After creating a bot, the most important step is configuring its runtime settings. These define how the bot talks, remembers, searches, and uses browser automation.

  1. Navigate to your bot's Detail Page.
  2. Go to the General tab.
  3. Configure the core fields:
  4. Click Save at the bottom of the form.

If you have not created these resources yet, set them up first:

General Tab Reference ​

The General tab contains all the core parameters that define your bot's behavior and runtime configuration.

FieldDescription
Chat ModelThe main LLM used for generating chat responses.
Memory ProviderThe memory backend assigned to the bot. The built-in provider can optionally define its own memory and embedding models.
Search ProviderThe search engine used for web browsing capabilities.
Browser ContextThe browser environment used for web automation, such as viewport, locale, and mobile behavior.
LanguageThe bot's primary communication language.
Reasoning EnabledIf the selected model supports reasoning (like OpenAI o1), enable this to use its deep thinking capabilities.
Reasoning EffortSet the level of reasoning effort (low, medium, high).
Heartbeat EnabledToggle periodic autonomous activity.
Heartbeat IntervalHow often (in minutes) the heartbeat triggers.
Heartbeat ModelThe LLM used for heartbeat tasks (can differ from the chat model).
Compaction EnabledToggle automatic memory compaction.
Compaction ModelThe LLM used for memory compaction.
ACL Default EffectDefault access control behavior (allow or deny) when no ACL rule matches.

Terminal Tab ​

The Terminal tab provides interactive shell access to the bot's container:

Deleting a Bot ​

To permanently remove a bot and all its associated data (including container files and memory):

  1. Navigate to the General tab in the Bot Detail page.
  2. Scroll to the Danger Zone at the bottom.
  3. Click Delete Bot and confirm the action.

Warning: This action is irreversible. All persistent data for this bot will be lost.

',28)])])}const b=e(n,[["render",i]]);export{m as __pageData,b as default};