Files
Memoh/getting-started/schedule.html
T
2026-03-09 15:38:06 +00:00

39 lines
34 KiB
HTML
Raw Blame History

This file contains invisible Unicode characters
This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
<!DOCTYPE html>
<html lang="en" dir="ltr">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>Scheduled Tasks | Memoh Documentation</title>
<meta name="description" content="Multi-Member, Structured Long-Memory, Containerized AI Agent System.">
<meta name="generator" content="VitePress v1.6.4">
<link rel="preload stylesheet" href="/assets/style.COoKA1-f.css" as="style">
<link rel="preload stylesheet" href="/vp-icons.css" as="style">
<script type="module" src="/assets/app.CFQrAvF4.js"></script>
<link rel="preload" href="/assets/inter-roman-latin.Di8DUHzh.woff2" as="font" type="font/woff2" crossorigin="">
<link rel="modulepreload" href="/assets/chunks/theme.B0ckB4ri.js">
<link rel="modulepreload" href="/assets/chunks/framework.BZohXCq9.js">
<link rel="modulepreload" href="/assets/getting-started_schedule.md.CNDu3SiN.lean.js">
<link rel="icon" href="/logo.png">
<script id="check-dark-mode">(()=>{const e=localStorage.getItem("vitepress-theme-appearance")||"auto",a=window.matchMedia("(prefers-color-scheme: dark)").matches;(!e||e==="auto"?a:e==="dark")&&document.documentElement.classList.add("dark")})();</script>
<script id="check-mac-os">document.documentElement.classList.toggle("mac",/Mac|iPhone|iPod|iPad/i.test(navigator.platform));</script>
</head>
<body>
<div id="app"><div class="Layout" data-v-fed1f3d6><!--[--><!--]--><!--[--><span tabindex="-1" data-v-a25f5db6></span><a href="#VPContent" class="VPSkipLink visually-hidden" data-v-a25f5db6>Skip to content</a><!--]--><!----><header class="VPNav" data-v-fed1f3d6 data-v-8f6a06d2><div class="VPNavBar" data-v-8f6a06d2 data-v-e42a4d1c><div class="wrapper" data-v-e42a4d1c><div class="container" data-v-e42a4d1c><div class="title" data-v-e42a4d1c><div class="VPNavBarTitle has-sidebar" data-v-e42a4d1c data-v-d3112b8f><a class="title" href="/" data-v-d3112b8f><!--[--><!--]--><!--[--><img class="VPImage logo" src="/logo.png" alt="Memoh" data-v-4ea68547><!--]--><span data-v-d3112b8f>Memoh</span><!--[--><!--]--></a></div></div><div class="content" data-v-e42a4d1c><div class="content-body" data-v-e42a4d1c><!--[--><!--]--><div class="VPNavBarSearch search" data-v-e42a4d1c><!--[--><!----><div id="local-search"><button type="button" class="DocSearch DocSearch-Button" aria-label="Search"><span class="DocSearch-Button-Container"><span class="vp-icon DocSearch-Search-Icon"></span><span class="DocSearch-Button-Placeholder">Search</span></span><span class="DocSearch-Button-Keys"><kbd class="DocSearch-Button-Key"></kbd><kbd class="DocSearch-Button-Key">K</kbd></span></button></div><!--]--></div><nav aria-labelledby="main-nav-aria-label" class="VPNavBarMenu menu" data-v-e42a4d1c data-v-9175dda3><span id="main-nav-aria-label" class="visually-hidden" data-v-9175dda3> Main Navigation </span><!--[--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/" tabindex="0" data-v-9175dda3 data-v-6a150605><!--[--><span data-v-6a150605>Guides</span><!--]--></a><!--]--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/blogs/" tabindex="0" data-v-9175dda3 data-v-6a150605><!--[--><span data-v-6a150605>Blogs</span><!--]--></a><!--]--><!--]--></nav><div class="VPFlyout VPNavBarTranslations translations" data-v-e42a4d1c data-v-06507d70 data-v-be779828><button type="button" class="button" aria-haspopup="true" aria-expanded="false" aria-label="Change language" data-v-be779828><span class="text" data-v-be779828><span class="vpi-languages option-icon" data-v-be779828></span><!----><span class="vpi-chevron-down text-icon" data-v-be779828></span></span></button><div class="menu" data-v-be779828><div class="VPMenu" data-v-be779828 data-v-3472f68e><!----><!--[--><!--[--><div class="items" data-v-06507d70><p class="title" data-v-06507d70>English</p><!--[--><div class="VPMenuLink" data-v-06507d70 data-v-058d8208><a class="VPLink link" href="/zh/getting-started/schedule.html" data-v-058d8208><!--[--><span data-v-058d8208>简体中文</span><!--]--></a></div><!--]--></div><!--]--><!--]--></div></div></div><div class="VPNavBarAppearance appearance" data-v-e42a4d1c data-v-f62f81f9><button class="VPSwitch VPSwitchAppearance" type="button" role="switch" title aria-checked="false" data-v-f62f81f9 data-v-37f1304f data-v-30be283b><span class="check" data-v-30be283b><span class="icon" data-v-30be283b><!--[--><span class="vpi-sun sun" data-v-37f1304f></span><span class="vpi-moon moon" data-v-37f1304f></span><!--]--></span></span></button></div><div class="VPSocialLinks VPNavBarSocialLinks social-links" data-v-e42a4d1c data-v-7d10330c data-v-756072eb><!--[--><a class="VPSocialLink no-icon" href="https://github.com/memohai/Memoh" aria-label="github" target="_blank" rel="noopener" data-v-756072eb data-v-57e28dd3><span class="vpi-social-github"></span></a><!--]--></div><div class="VPFlyout VPNavBarExtra extra" data-v-e42a4d1c data-v-d3d9fc8f data-v-be779828><button type="button" class="button" aria-haspopup="true" aria-expanded="false" aria-label="extra navigation" data-v-be779828><span class="vpi-more-horizontal icon" data-v-be779828></span></button><div class="menu" data-v-be779828><div class="VPMenu" data-v-be779828 data-v-3472f68e><!----><!--[--><!--[--><div class="group translations" data-v-d3d9fc8f><p class="trans-title" data-v-d3d9fc8f>English</p><!--[--><div class="VPMenuLink" data-v-d3d9fc8f data-v-058d8208><a class="VPLink link" href="/zh/getting-started/schedule.html" data-v-058d8208><!--[--><span data-v-058d8208>简体中文</span><!--]--></a></div><!--]--></div><div class="group" data-v-d3d9fc8f><div class="item appearance" data-v-d3d9fc8f><p class="label" data-v-d3d9fc8f>Appearance</p><div class="appearance-action" data-v-d3d9fc8f><button class="VPSwitch VPSwitchAppearance" type="button" role="switch" title aria-checked="false" data-v-d3d9fc8f data-v-37f1304f data-v-30be283b><span class="check" data-v-30be283b><span class="icon" data-v-30be283b><!--[--><span class="vpi-sun sun" data-v-37f1304f></span><span class="vpi-moon moon" data-v-37f1304f></span><!--]--></span></span></button></div></div></div><div class="group" data-v-d3d9fc8f><div class="item social-links" data-v-d3d9fc8f><div class="VPSocialLinks social-links-list" data-v-d3d9fc8f data-v-756072eb><!--[--><a class="VPSocialLink no-icon" href="https://github.com/memohai/Memoh" aria-label="github" target="_blank" rel="noopener" data-v-756072eb data-v-57e28dd3><span class="vpi-social-github"></span></a><!--]--></div></div></div><!--]--><!--]--></div></div></div><!--[--><!--]--><button type="button" class="VPNavBarHamburger hamburger" aria-label="mobile navigation" aria-expanded="false" aria-controls="VPNavScreen" data-v-e42a4d1c data-v-2f352f04><span class="container" data-v-2f352f04><span class="top" data-v-2f352f04></span><span class="middle" data-v-2f352f04></span><span class="bottom" data-v-2f352f04></span></span></button></div></div></div></div><div class="divider" data-v-e42a4d1c><div class="divider-line" data-v-e42a4d1c></div></div></div><!----></header><div class="VPLocalNav has-sidebar empty" data-v-fed1f3d6 data-v-35fedc2e><div class="container" data-v-35fedc2e><button class="menu" aria-expanded="false" aria-controls="VPSidebarNav" data-v-35fedc2e><span class="vpi-align-left menu-icon" data-v-35fedc2e></span><span class="menu-text" data-v-35fedc2e>Menu</span></button><div class="VPLocalNavOutlineDropdown" style="--vp-vh:0px;" data-v-35fedc2e data-v-b1705a02><button data-v-b1705a02>Return to top</button><!----></div></div></div><aside class="VPSidebar" data-v-fed1f3d6 data-v-297c64fb><div class="curtain" data-v-297c64fb></div><nav class="nav" id="VPSidebarNav" aria-labelledby="sidebar-aria-label" tabindex="-1" data-v-297c64fb><span class="visually-hidden" id="sidebar-aria-label" data-v-297c64fb> Sidebar Navigation </span><!--[--><!--]--><!--[--><div class="no-transition group" data-v-c16c12a8><section class="VPSidebarItem level-0" data-v-c16c12a8 data-v-9a07bd0b><!----><div class="items" data-v-9a07bd0b><!--[--><div class="VPSidebarItem level-1 is-link" data-v-9a07bd0b data-v-9a07bd0b><div class="item" data-v-9a07bd0b><div class="indicator" data-v-9a07bd0b></div><a class="VPLink link link" href="/index.html" data-v-9a07bd0b><!--[--><p class="text" data-v-9a07bd0b>Overview</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-9a07bd0b data-v-9a07bd0b><div class="item" data-v-9a07bd0b><div class="indicator" data-v-9a07bd0b></div><a class="VPLink link link" href="/about.html" data-v-9a07bd0b><!--[--><p class="text" data-v-9a07bd0b>About Memoh</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-c16c12a8><section class="VPSidebarItem level-0" data-v-c16c12a8 data-v-9a07bd0b><div class="item" role="button" tabindex="0" data-v-9a07bd0b><div class="indicator" data-v-9a07bd0b></div><h2 class="text" data-v-9a07bd0b>Installation</h2><!----></div><div class="items" data-v-9a07bd0b><!--[--><div class="VPSidebarItem level-1 is-link" data-v-9a07bd0b data-v-9a07bd0b><div class="item" data-v-9a07bd0b><div class="indicator" data-v-9a07bd0b></div><a class="VPLink link link" href="/installation/docker.html" data-v-9a07bd0b><!--[--><p class="text" data-v-9a07bd0b>Docker</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-c16c12a8><section class="VPSidebarItem level-0 has-active" data-v-c16c12a8 data-v-9a07bd0b><div class="item" role="button" tabindex="0" data-v-9a07bd0b><div class="indicator" data-v-9a07bd0b></div><h2 class="text" data-v-9a07bd0b>Getting Started</h2><!----></div><div class="items" data-v-9a07bd0b><!--[--><div class="VPSidebarItem level-1 is-link" data-v-9a07bd0b data-v-9a07bd0b><div class="item" data-v-9a07bd0b><div class="indicator" data-v-9a07bd0b></div><a class="VPLink link link" href="/getting-started/provider-and-model.html" data-v-9a07bd0b><!--[--><p class="text" data-v-9a07bd0b>LLM Provider and Model</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-9a07bd0b data-v-9a07bd0b><div class="item" data-v-9a07bd0b><div class="indicator" data-v-9a07bd0b></div><a class="VPLink link link" href="/getting-started/bot.html" data-v-9a07bd0b><!--[--><p class="text" data-v-9a07bd0b>Bot Management</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-9a07bd0b data-v-9a07bd0b><div class="item" data-v-9a07bd0b><div class="indicator" data-v-9a07bd0b></div><a class="VPLink link link" href="/getting-started/container.html" data-v-9a07bd0b><!--[--><p class="text" data-v-9a07bd0b>Container Management</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-9a07bd0b data-v-9a07bd0b><div class="item" data-v-9a07bd0b><div class="indicator" data-v-9a07bd0b></div><a class="VPLink link link" href="/getting-started/files.html" data-v-9a07bd0b><!--[--><p class="text" data-v-9a07bd0b>Files Management</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-9a07bd0b data-v-9a07bd0b><div class="item" data-v-9a07bd0b><div class="indicator" data-v-9a07bd0b></div><a class="VPLink link link" href="/getting-started/skills.html" data-v-9a07bd0b><!--[--><p class="text" data-v-9a07bd0b>Bot Skills</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-9a07bd0b data-v-9a07bd0b><div class="item" data-v-9a07bd0b><div class="indicator" data-v-9a07bd0b></div><a class="VPLink link link" href="/getting-started/mcp.html" data-v-9a07bd0b><!--[--><p class="text" data-v-9a07bd0b>MCP Connections</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-9a07bd0b data-v-9a07bd0b><div class="item" data-v-9a07bd0b><div class="indicator" data-v-9a07bd0b></div><a class="VPLink link link" href="/getting-started/channels.html" data-v-9a07bd0b><!--[--><p class="text" data-v-9a07bd0b>Bot Channels</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-9a07bd0b data-v-9a07bd0b><div class="item" data-v-9a07bd0b><div class="indicator" data-v-9a07bd0b></div><a class="VPLink link link" href="/getting-started/browser.html" data-v-9a07bd0b><!--[--><p class="text" data-v-9a07bd0b>Browser Contexts</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-9a07bd0b data-v-9a07bd0b><div class="item" data-v-9a07bd0b><div class="indicator" data-v-9a07bd0b></div><a class="VPLink link link" href="/getting-started/memory.html" data-v-9a07bd0b><!--[--><p class="text" data-v-9a07bd0b>Memory Management</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-9a07bd0b data-v-9a07bd0b><div class="item" data-v-9a07bd0b><div class="indicator" data-v-9a07bd0b></div><a class="VPLink link link" href="/getting-started/subagents.html" data-v-9a07bd0b><!--[--><p class="text" data-v-9a07bd0b>Subagents</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-9a07bd0b data-v-9a07bd0b><div class="item" data-v-9a07bd0b><div class="indicator" data-v-9a07bd0b></div><a class="VPLink link link" href="/getting-started/heartbeat.html" data-v-9a07bd0b><!--[--><p class="text" data-v-9a07bd0b>Heartbeat</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-9a07bd0b data-v-9a07bd0b><div class="item" data-v-9a07bd0b><div class="indicator" data-v-9a07bd0b></div><a class="VPLink link link" href="/getting-started/schedule.html" data-v-9a07bd0b><!--[--><p class="text" data-v-9a07bd0b>Scheduled Tasks</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-9a07bd0b data-v-9a07bd0b><div class="item" data-v-9a07bd0b><div class="indicator" data-v-9a07bd0b></div><a class="VPLink link link" href="/getting-started/search-provider.html" data-v-9a07bd0b><!--[--><p class="text" data-v-9a07bd0b>Search Providers</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-9a07bd0b data-v-9a07bd0b><div class="item" data-v-9a07bd0b><div class="indicator" data-v-9a07bd0b></div><a class="VPLink link link" href="/getting-started/email.html" data-v-9a07bd0b><!--[--><p class="text" data-v-9a07bd0b>Email Providers</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-c16c12a8><section class="VPSidebarItem level-0" data-v-c16c12a8 data-v-9a07bd0b><div class="item" role="button" tabindex="0" data-v-9a07bd0b><div class="indicator" data-v-9a07bd0b></div><h2 class="text" data-v-9a07bd0b>Memory Providers</h2><!----></div><div class="items" data-v-9a07bd0b><!--[--><div class="VPSidebarItem level-1 is-link" data-v-9a07bd0b data-v-9a07bd0b><div class="item" data-v-9a07bd0b><div class="indicator" data-v-9a07bd0b></div><a class="VPLink link link" href="/memory-providers/index.html" data-v-9a07bd0b><!--[--><p class="text" data-v-9a07bd0b>Overview</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-9a07bd0b data-v-9a07bd0b><div class="item" data-v-9a07bd0b><div class="indicator" data-v-9a07bd0b></div><a class="VPLink link link" href="/memory-providers/builtin.html" data-v-9a07bd0b><!--[--><p class="text" data-v-9a07bd0b>Built-in</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-c16c12a8><section class="VPSidebarItem level-0" data-v-c16c12a8 data-v-9a07bd0b><div class="item" role="button" tabindex="0" data-v-9a07bd0b><div class="indicator" data-v-9a07bd0b></div><h2 class="text" data-v-9a07bd0b>Channels</h2><!----></div><div class="items" data-v-9a07bd0b><!--[--><div class="VPSidebarItem level-1 is-link" data-v-9a07bd0b data-v-9a07bd0b><div class="item" data-v-9a07bd0b><div class="indicator" data-v-9a07bd0b></div><a class="VPLink link link" href="/channels/index.html" data-v-9a07bd0b><!--[--><p class="text" data-v-9a07bd0b>Overview</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-9a07bd0b data-v-9a07bd0b><div class="item" data-v-9a07bd0b><div class="indicator" data-v-9a07bd0b></div><a class="VPLink link link" href="/channels/telegram.html" data-v-9a07bd0b><!--[--><p class="text" data-v-9a07bd0b>Telegram</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-9a07bd0b data-v-9a07bd0b><div class="item" data-v-9a07bd0b><div class="indicator" data-v-9a07bd0b></div><a class="VPLink link link" href="/channels/feishu.html" data-v-9a07bd0b><!--[--><p class="text" data-v-9a07bd0b>Feishu (Lark)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-9a07bd0b data-v-9a07bd0b><div class="item" data-v-9a07bd0b><div class="indicator" data-v-9a07bd0b></div><a class="VPLink link link" href="/channels/discord.html" data-v-9a07bd0b><!--[--><p class="text" data-v-9a07bd0b>Discord</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-9a07bd0b data-v-9a07bd0b><div class="item" data-v-9a07bd0b><div class="indicator" data-v-9a07bd0b></div><a class="VPLink link link" href="/channels/qq.html" data-v-9a07bd0b><!--[--><p class="text" data-v-9a07bd0b>QQ</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><!--]--><!--[--><!--]--></nav></aside><div class="VPContent has-sidebar" id="VPContent" data-v-fed1f3d6 data-v-b7673a1a><div class="VPDoc has-sidebar has-aside" data-v-b7673a1a data-v-b4547c88><!--[--><!--]--><div class="container" data-v-b4547c88><div class="aside" data-v-b4547c88><div class="aside-curtain" data-v-b4547c88></div><div class="aside-container" data-v-b4547c88><div class="aside-content" data-v-b4547c88><div class="VPDocAside" data-v-b4547c88 data-v-f5225fdd><!--[--><!--]--><!--[--><!--]--><nav aria-labelledby="doc-outline-aria-label" class="VPDocAsideOutline" data-v-f5225fdd data-v-3d6074c1><div class="content" data-v-3d6074c1><div class="outline-marker" data-v-3d6074c1></div><div aria-level="2" class="outline-title" id="doc-outline-aria-label" role="heading" data-v-3d6074c1>On this page</div><ul class="VPDocOutlineItem root" data-v-3d6074c1 data-v-554af1ab><!--[--><!--]--></ul></div></nav><!--[--><!--]--><div class="spacer" data-v-f5225fdd></div><!--[--><!--]--><!----><!--[--><!--]--><!--[--><!--]--></div></div></div></div><div class="content" data-v-b4547c88><div class="content-container" data-v-b4547c88><!--[--><!--]--><main class="main" data-v-b4547c88><div style="position:relative;" class="vp-doc _getting-started_schedule" data-v-b4547c88><div><h1 id="scheduled-tasks" tabindex="-1">Scheduled Tasks <a class="header-anchor" href="#scheduled-tasks" aria-label="Permalink to &quot;Scheduled Tasks&quot;"></a></h1><p>Scheduled Tasks allow you to automate recurring bot actions using cron expressions. This is useful for sending periodic reports, checking external data, performing maintenance, or triggering any routine task without manual intervention.</p><h2 id="concept-cron-based-automation" tabindex="-1">Concept: Cron-Based Automation <a class="header-anchor" href="#concept-cron-based-automation" aria-label="Permalink to &quot;Concept: Cron-Based Automation&quot;"></a></h2><p>A <strong>Schedule</strong> is a cron-triggered rule bound to a specific bot. When a schedule fires, it sends a command to the agent, which executes it using its available tools, skills, and context. The bot can then deliver results to any connected channel.</p><hr><h2 id="schedule-fields" tabindex="-1">Schedule Fields <a class="header-anchor" href="#schedule-fields" aria-label="Permalink to &quot;Schedule Fields&quot;"></a></h2><table tabindex="0"><thead><tr><th>Field</th><th>Description</th></tr></thead><tbody><tr><td><strong>Name</strong></td><td>A display name for the task (e.g., &quot;Morning News Summary&quot;).</td></tr><tr><td><strong>Description</strong></td><td>A brief explanation of what the task does.</td></tr><tr><td><strong>Pattern</strong></td><td>A cron expression that defines when the task runs (e.g., <code>0 9 * * *</code> for daily at 9:00 AM).</td></tr><tr><td><strong>Command</strong></td><td>The natural-language instruction sent to the agent when the schedule triggers (e.g., &quot;Summarize today&#39;s top tech news and send it to the Telegram channel&quot;).</td></tr><tr><td><strong>Enabled</strong></td><td>Whether the schedule is currently active.</td></tr><tr><td><strong>Max Calls</strong></td><td>Optional limit on the total number of executions. Leave empty for unlimited.</td></tr><tr><td><strong>Current Calls</strong></td><td>The number of times this schedule has already fired.</td></tr></tbody></table><hr><h2 id="cron-pattern-reference" tabindex="-1">Cron Pattern Reference <a class="header-anchor" href="#cron-pattern-reference" aria-label="Permalink to &quot;Cron Pattern Reference&quot;"></a></h2><p>The <code>pattern</code> field uses standard cron syntax with five fields:</p><div class="language- vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang"></span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span>┌───────────── minute (0–59)</span></span>
<span class="line"><span>│ ┌───────────── hour (0–23)</span></span>
<span class="line"><span>│ │ ┌───────────── day of month (131)</span></span>
<span class="line"><span>│ │ │ ┌───────────── month (1–12)</span></span>
<span class="line"><span>│ │ │ │ ┌───────────── day of week (06, Sun=0)</span></span>
<span class="line"><span>│ │ │ │ │</span></span>
<span class="line"><span>* * * * *</span></span></code></pre></div><p><strong>Common examples:</strong></p><table tabindex="0"><thead><tr><th>Pattern</th><th>Meaning</th></tr></thead><tbody><tr><td><code>0 9 * * *</code></td><td>Every day at 9:00 AM</td></tr><tr><td><code>*/30 * * * *</code></td><td>Every 30 minutes</td></tr><tr><td><code>0 0 * * 1</code></td><td>Every Monday at midnight</td></tr><tr><td><code>0 8,20 * * *</code></td><td>Every day at 8:00 AM and 8:00 PM</td></tr><tr><td><code>0 0 1 * *</code></td><td>First day of every month at midnight</td></tr></tbody></table><hr><h2 id="viewing-schedules" tabindex="-1">Viewing Schedules <a class="header-anchor" href="#viewing-schedules" aria-label="Permalink to &quot;Viewing Schedules&quot;"></a></h2><ol><li>Navigate to the Bot <strong>Detail Page</strong>.</li><li>Select the <strong>Schedule</strong> tab.</li><li>The list shows all schedules for this bot, including their name, cron pattern, enabled status, and execution counts.</li><li>Click <strong>Refresh</strong> to reload the list.</li></ol><hr><h2 id="creating-schedules" tabindex="-1">Creating Schedules <a class="header-anchor" href="#creating-schedules" aria-label="Permalink to &quot;Creating Schedules&quot;"></a></h2><p>Schedules are primarily created in two ways:</p><h3 id="via-the-bot-conversational" tabindex="-1">Via the Bot (Conversational) <a class="header-anchor" href="#via-the-bot-conversational" aria-label="Permalink to &quot;Via the Bot (Conversational)&quot;"></a></h3><p>The bot itself has access to a <code>schedule</code> tool. You can ask the bot to create a schedule in natural language:</p><blockquote><p>&quot;Create a schedule called &#39;Daily Digest&#39; that runs every day at 8 AM and sends me a summary of my unread emails.&quot;</p></blockquote><p>The bot will translate this into a cron expression and register the schedule automatically.</p><h3 id="via-the-api" tabindex="-1">Via the API <a class="header-anchor" href="#via-the-api" aria-label="Permalink to &quot;Via the API&quot;"></a></h3><p>You can also create schedules programmatically using the REST API:</p><div class="language- vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang"></span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span>POST /api/bots/{bot_id}/schedule</span></span></code></pre></div><div class="language-json vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">json</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">{</span></span>
<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> &quot;name&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;Daily Digest&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> &quot;description&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;Summarize unread emails every morning&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> &quot;pattern&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;0 8 * * *&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> &quot;command&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;Summarize my unread emails and send the result to Telegram.&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> &quot;enabled&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">true</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> &quot;max_calls&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">null</span></span>
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">}</span></span></code></pre></div><hr><h2 id="execution-flow" tabindex="-1">Execution Flow <a class="header-anchor" href="#execution-flow" aria-label="Permalink to &quot;Execution Flow&quot;"></a></h2><p>When a schedule fires:</p><ol><li>The cron service triggers the schedule.</li><li>The <code>current_calls</code> counter is incremented.</li><li>If <code>max_calls</code> is set and reached, the schedule is automatically disabled.</li><li>The agent receives the <code>command</code> along with the schedule context.</li><li>The agent executes the command using its tools (e.g., web search, file read, send message).</li><li>Results can be delivered to any connected channel.</li></ol><hr><h2 id="schedule-vs-heartbeat" tabindex="-1">Schedule vs. Heartbeat <a class="header-anchor" href="#schedule-vs-heartbeat" aria-label="Permalink to &quot;Schedule vs. Heartbeat&quot;"></a></h2><table tabindex="0"><thead><tr><th>Feature</th><th>Schedule</th><th>Heartbeat</th></tr></thead><tbody><tr><td><strong>Trigger</strong></td><td>Cron expression (flexible timing)</td><td>Fixed interval (minutes)</td></tr><tr><td><strong>Command</strong></td><td>Custom natural-language instruction</td><td>Generic &quot;routine check&quot; prompt</td></tr><tr><td><strong>Max Calls</strong></td><td>Optional execution limit</td><td>Unlimited</td></tr><tr><td><strong>Use Case</strong></td><td>Specific recurring tasks</td><td>Periodic autonomous thinking</td></tr></tbody></table><p>Both features complement each other: use <strong>Heartbeat</strong> for general-purpose periodic activity and <strong>Schedule</strong> for precise, task-oriented automation.</p></div></div></main><footer class="VPDocFooter" data-v-b4547c88 data-v-57f47480><!--[--><!--]--><div class="edit-info" data-v-57f47480><div class="edit-link" data-v-57f47480><a class="VPLink link vp-external-link-icon no-icon edit-link-button" href="https://github.com/memohai/Memoh/edit/main/docs/docs/getting-started/schedule.md" target="_blank" rel="noreferrer" data-v-57f47480><!--[--><span class="vpi-square-pen edit-link-icon" data-v-57f47480></span> Edit on GitHub<!--]--></a></div><div class="last-updated" data-v-57f47480><p class="VPLastUpdated" data-v-57f47480 data-v-76b89e12>Last Updated: <time datetime="2026-03-01T10:01:03.000Z" data-v-76b89e12></time></p></div></div><nav class="prev-next" aria-labelledby="doc-footer-aria-label" data-v-57f47480><span class="visually-hidden" id="doc-footer-aria-label" data-v-57f47480>Pager</span><div class="pager" data-v-57f47480><a class="VPLink link pager-link prev" href="/getting-started/heartbeat.html" data-v-57f47480><!--[--><span class="desc" data-v-57f47480>Previous page</span><span class="title" data-v-57f47480>Heartbeat</span><!--]--></a></div><div class="pager" data-v-57f47480><a class="VPLink link pager-link next" href="/getting-started/search-provider.html" data-v-57f47480><!--[--><span class="desc" data-v-57f47480>Next page</span><span class="title" data-v-57f47480>Search Providers</span><!--]--></a></div></nav></footer><!--[--><!--]--></div></div></div><!--[--><!--]--></div></div><footer class="VPFooter has-sidebar" data-v-fed1f3d6 data-v-eda79520><div class="container" data-v-eda79520><p class="message" data-v-eda79520>Published under AGPLv3</p><p class="copyright" data-v-eda79520>Copyright © 2024 Memoh</p></div></footer><!--[--><!--]--></div></div>
<script>window.__VP_HASH_MAP__=JSON.parse("{\"about.md\":\"Dtv0dtOs\",\"blogs_2026-02-16.md\":\"cjgZmunL\",\"blogs_index.md\":\"B2P01evP\",\"channels_discord.md\":\"WNpdGj29\",\"channels_feishu.md\":\"BBJ8KQPd\",\"channels_index.md\":\"T_VHXXZf\",\"channels_qq.md\":\"B_4bodh-\",\"channels_telegram.md\":\"B9i-uoiX\",\"getting-started_bot.md\":\"AR4RHnpe\",\"getting-started_browser.md\":\"B8YEEooM\",\"getting-started_channels.md\":\"C0YPWL-y\",\"getting-started_container.md\":\"D49M0dHe\",\"getting-started_email.md\":\"BRkUZLh2\",\"getting-started_files.md\":\"CczR71or\",\"getting-started_heartbeat.md\":\"B-SMiJUD\",\"getting-started_mcp.md\":\"Bb2toM2o\",\"getting-started_memory.md\":\"Dt7Ez9Lk\",\"getting-started_provider-and-model.md\":\"BquaPnJe\",\"getting-started_schedule.md\":\"CNDu3SiN\",\"getting-started_search-provider.md\":\"R9B5DkBj\",\"getting-started_skills.md\":\"DzSZ-qiC\",\"getting-started_subagents.md\":\"6oBLlW8a\",\"index.md\":\"D1yGsPie\",\"installation_docker.md\":\"qkaakAVc\",\"memory-providers_builtin.md\":\"BDxazTz6\",\"memory-providers_index.md\":\"DNPBOVmb\",\"zh_concepts_identity-and-binding.md\":\"7e9GdoK6\",\"zh_concepts_index.md\":\"Brd21jcS\",\"zh_index.md\":\"CZQRt_rQ\",\"zh_style_terminology.md\":\"DLv5QofI\"}");window.__VP_SITE_DATA__=JSON.parse("{\"lang\":\"en-US\",\"dir\":\"ltr\",\"title\":\"Memoh Documentation\",\"description\":\"Multi-Member, Structured Long-Memory, Containerized AI Agent System.\",\"base\":\"/\",\"head\":[],\"router\":{\"prefetchLinks\":true},\"appearance\":true,\"themeConfig\":{\"siteTitle\":\"Memoh\",\"sidebar\":{\"/blogs/\":[{\"text\":\"Blogs\",\"link\":\"/blogs/index.md\",\"items\":[{\"text\":\"Introduction (Feb 2026)\",\"link\":\"/blogs/2026-02-16.md\"}]}],\"/\":[{\"text\":\"Overview\",\"link\":\"/index.md\"},{\"text\":\"About Memoh\",\"link\":\"/about.md\"},{\"text\":\"Installation\",\"items\":[{\"text\":\"Docker\",\"link\":\"/installation/docker.md\"}]},{\"text\":\"Getting Started\",\"items\":[{\"text\":\"LLM Provider and Model\",\"link\":\"/getting-started/provider-and-model.md\"},{\"text\":\"Bot Management\",\"link\":\"/getting-started/bot.md\"},{\"text\":\"Container Management\",\"link\":\"/getting-started/container.md\"},{\"text\":\"Files Management\",\"link\":\"/getting-started/files.md\"},{\"text\":\"Bot Skills\",\"link\":\"/getting-started/skills.md\"},{\"text\":\"MCP Connections\",\"link\":\"/getting-started/mcp.md\"},{\"text\":\"Bot Channels\",\"link\":\"/getting-started/channels.md\"},{\"text\":\"Browser Contexts\",\"link\":\"/getting-started/browser.md\"},{\"text\":\"Memory Management\",\"link\":\"/getting-started/memory.md\"},{\"text\":\"Subagents\",\"link\":\"/getting-started/subagents.md\"},{\"text\":\"Heartbeat\",\"link\":\"/getting-started/heartbeat.md\"},{\"text\":\"Scheduled Tasks\",\"link\":\"/getting-started/schedule.md\"},{\"text\":\"Search Providers\",\"link\":\"/getting-started/search-provider.md\"},{\"text\":\"Email Providers\",\"link\":\"/getting-started/email.md\"}]},{\"text\":\"Memory Providers\",\"items\":[{\"text\":\"Overview\",\"link\":\"/memory-providers/index.md\"},{\"text\":\"Built-in\",\"link\":\"/memory-providers/builtin.md\"}]},{\"text\":\"Channels\",\"items\":[{\"text\":\"Overview\",\"link\":\"/channels/index.md\"},{\"text\":\"Telegram\",\"link\":\"/channels/telegram.md\"},{\"text\":\"Feishu (Lark)\",\"link\":\"/channels/feishu.md\"},{\"text\":\"Discord\",\"link\":\"/channels/discord.md\"},{\"text\":\"QQ\",\"link\":\"/channels/qq.md\"}]}],\"/zh/\":[{\"text\":\"文档总览\",\"link\":\"/zh/index.md\"}]},\"nav\":[{\"text\":\"Guides\",\"link\":\"/\"},{\"text\":\"Blogs\",\"link\":\"/blogs/\"}],\"logo\":{\"src\":\"/logo.png\",\"alt\":\"Memoh\"},\"socialLinks\":[{\"icon\":\"github\",\"link\":\"https://github.com/memohai/Memoh\"}],\"footer\":{\"message\":\"Published under AGPLv3\",\"copyright\":\"Copyright © 2024 Memoh\"},\"search\":{\"provider\":\"local\"},\"editLink\":{\"pattern\":\"https://github.com/memohai/Memoh/edit/main/docs/docs/:path\",\"text\":\"Edit on GitHub\"},\"lastUpdated\":{\"text\":\"Last Updated\",\"formatOptions\":{\"dateStyle\":\"short\",\"timeStyle\":\"medium\"}}},\"locales\":{\"root\":{\"label\":\"English\",\"lang\":\"en\"},\"zh\":{\"label\":\"简体中文\",\"lang\":\"zh\"}},\"scrollOffset\":134,\"cleanUrls\":false}");</script>
</body>
</html>