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

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 runtime settings: chat/title/image models, memory/search/browser/TTS bindings, timezone, language, reasoning, and danger zone.
ContainerContainer lifecycle (create/start/stop), snapshots, data export/import.
MemoryBrowse, search, create, edit, and compact memories.
PlatformsChannel configurations such as Telegram, Discord, Feishu, QQ, Matrix, WeCom, WeChat, Misskey, DingTalk, and Web.
AccessACL rules and default access behavior.
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, model selection, and execution logs.
CompactionSession context compaction settings and 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 settings are split across a few tabs instead of living in one giant form.

  1. Navigate to your bot's Detail Page.
  2. Start with the General tab for chat/runtime bindings.
  3. Use the Heartbeat tab for scheduled autonomous activity.
  4. Use the Compaction tab for session context compaction behavior.
  5. Use the Access tab to refine ACL rules after the initial ACL preset.

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


General Tab Reference

The General tab contains the settings that shape everyday conversation behavior.

FieldDescription
Chat ModelThe main LLM used for generating chat responses.
Title ModelOptional model used to generate session titles.
Image Generation ModelOptional model used by image-generation features. Pick a chat model that supports image-output.
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.
TTS ModelOptional speech model used for text-to-speech output. Speech models come from the TTS Providers flow, not the normal chat provider flow.
Browser ContextThe browser environment used for web automation, such as viewport, locale, and mobile behavior.
TimezonePer-bot timezone. If empty, Memoh inherits the user timezone and then falls back to the system timezone.
LanguageThe bot's primary communication language.
Reasoning EnabledAvailable when the selected chat model exposes reasoning compatibility.
Reasoning EffortSet the level of reasoning effort (low, medium, high).

Notes:


Heartbeat Tab Reference

Heartbeat is configured from its own tab.

FieldDescription
Heartbeat EnabledEnable or disable periodic autonomous activity.
Heartbeat IntervalHow often the heartbeat runs, in minutes.
Heartbeat ModelOptional dedicated model for heartbeat tasks. This can differ from the main chat model.

The Heartbeat tab also includes heartbeat execution logs, so you can review what the bot did during autonomous runs.


Compaction Tab Reference

Compaction is now about session context compaction, not memory maintenance.

FieldDescription
Compaction EnabledEnable or disable automatic context compaction.
Compaction ThresholdEstimated token threshold that triggers compaction.
Compaction RatioHow aggressively the session context should be reduced.
Compaction ModelOptional dedicated model used to summarize old session context.

The Compaction tab also exposes compaction logs so you can see recent successful, pending, or failed runs.

For the runtime behavior, see Context Compaction.


Access And ACL

At creation time, the bot starts from an ACL preset. After that, use the Access tab for fine-grained control.

Two layers matter:

Use the Access tab to refine conversation, group, and thread rules after the initial setup.


Most users only need the chat and discuss behavior described in Sessions.

If you manage bot settings through the API or custom automation, the settings schema also includes discuss_probe_model_id for discuss-mode specific setups. Treat it as an advanced setting rather than a required field for normal bot creation.


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.

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