<h2 id="table-of-contents">Table of contents</h2>
<ul>
<li><a href="#why-build-my-own">Why build my own?</a></li>
<li><a href="#key-features">Key Features</a>
<ul>
<li><a href="#memory">Memory</a>
<ul>
<li><a href="#storage">Storage</a></li>
<li><a href="#search">Search</a></li>
<li><a href="#active-recall">Active recall</a></li>
</ul>
</li>
<li><a href="#discord-gateway">Discord gateway</a>
<ul>
<li><a href="#gateway-webhook">Gateway webhook</a></li>
<li><a href="#mention-detection">Mention detection</a></li>
<li><a href="#thread-tracking">Thread tracking</a></li>
<li><a href="#catchup-on-reconnect">Catchup on reconnect</a></li>
</ul>
</li>
<li><a href="#scheduling">Scheduling</a>
<ul>
<li><a href="#commitment-tracking">Commitment tracking</a></li>
<li><a href="#cronjobs-out-of-process">CronJobs (out-of-process)</a></li>
</ul>
</li>
<li><a href="#persona">Persona</a></li>
<li><a href="#self-improvement-and-observability">Self-improvement and observability</a>
<ul>
<li><a href="#pai-self-improver-cron">pai-self-improver cron</a></li>
</ul>
</li>
</ul>
</li>
</ul>
<h1 id="why-build-my-own">Why build my own?</h1>
<p>OpenClaw is really feature rich, popular, and arguably useful. It's also just... not
mine. I rolled it out <a href="/openclaw-mvp.html">for a prior post</a> as a test and while it
was neat, I learned very little and didn't trust it since I didn't understand what
it was doing or why.</p>
<p>I decided it'd be fun to build some of the features I find most useful from it into my
own AI assistant tool, and keep the scope much more narrow to my own specific usecases.</p>
<p>I named it Pai, for "Pericak AI".</p>
<h1 id="key-features">Key Features</h1>
<h2 id="memory">Memory</h2>
<p>It's nice when talking to Pai on discord, for it to remember things. ChatGPT and similar
tools have been doing it for so long now it's kind of expected.</p>
<h3 id="storage">Storage</h3>
<p>Three plain-markdown files are stored in a k8s PVC that I back up to Google cloud.</p>
<ul>
<li><code>MEMORY.md</code>: sectioned by <code>##</code> headers</li>
<li><code>daily/YYYY-MM-DD.md</code>: rolling notes</li>
<li><code>COMMITMENTS.md</code>: YAML-fenced follow-ups</li>
</ul>
<p>A typed MCP wraps the files and exposes <code>memory_save</code>,
<code>memory_search</code>, <code>memory_recall</code>, <code>memory_get</code>, <code>memory_list</code>,
<code>memory_commitment_due</code>, <code>memory_commitment_done</code>, <code>memory_promote</code>.</p>
<p>Example of a <code>COMMITMENTS.md</code> block:</p>
<pre><code class="language-markdown">---
id: c-2026-05-08-001
status: pending
precision: precise
due: 2026-05-08T19:00:00Z
scope: channel:1482815120000000000
---
Remind Kyle about the dentist appointment at 3 PM.
</code></pre>
<p>The MCP exists rather than letting Pai use Read/Glob/Grep because
the typed contract reduces malformed entries and the commitment
lifecycle wants <code>due</code> / <code>done</code> semantics in the protocol. The files
themselves are plain markdown, auditable without the MCP running.</p>
<p>This tradeoff of using
an MCP tool kind of sucks, I'm not totally sold on it over a skill. My claude startup
time got kind of bad and I had to tune some settings, so now the MCP servers may not be
ready by the time it tries to use them.</p>
<h3 id="search">Search</h3>
<p>Builtin Python <a href="https://en.wikipedia.org/wiki/Okapi_BM25">BM25 (Best Matching 25</a>
over the markdown. Pai runs it on-demand to try and remember things.</p>
<p><code>memory_search</code> returns ranked hits with provenance: <code>{path, line, snippet, score}</code>. Pai calls it mid-turn, when it decides it needs to look something up.
No embeddings, no API keys.</p>
<h3 id="active-recall">Active recall</h3>
<p>A subagent calls BM25 proactively before Pai tries to respond, enriching the chat context
with memory details. This slows things down but gets better answers, I'm not sold on
it actually being better than active search yet but it's conceptually neat.</p>
<p>This is directly inspired by openclaw's Active Memory plugin pattern.</p>
<h2 id="discord-gateway">Discord gateway</h2>
<h3 id="gateway-webhook">Gateway webhook</h3>
<p>To watch for Discord activity there's a long-lived outbound websocket to
Discord's <code>gateway.discord.gg</code> from a K8s Deployment.</p>
<p>The gateway's got some other bells and whistles:</p>
<ul>
<li>A per-session queue with a serialization lock handled by an asyncio coroutine
<ul>
<li>A "session" = a Discord channel or thread ID</li>
<li>If you message @Pai 3 times, it doesn't fire 3 responses off at once due to the lock. It answers #1, then probably merges #2 and #2.</li>
</ul>
</li>
<li>Stored transcripts: per-session rolling records of recent dialogue, basically allows look-back to prior messages</li>
<li>Idle thread sweeper: Pai always replies in threads, never in the main channel. The threads accumulate.
<ul>
<li>It's a coroutine that runs every 5 minutes, if something is idle for an hour post a farewell, unbind the thread, and delete the local transcript</li>
</ul>
</li>
<li>Periodic review every 15 minutes for unmentioned messages: Just polls for anything it classifies as ~"should respond to" when not mentioned directly</li>
<li>Health server on :8080/healthz - tiny aiohttp web app used for k8s liveness probe</li>
</ul>
<p>There's no service or ingress pointing at it. Only K8s itself talks to it.</p>
<h3 id="mention-detection">Mention detection</h3>
<p>I had to fix this up myself, it handles three forms of mentions</p>
<ol>
<li>user mentions (<code>&#x3C;@id></code>) via <code>msg.mentions</code></li>
<li>literal <code>&#x3C;@bot_user_id></code> substring</li>
<li>role mentions matching any role the bot itself holds.</li>
</ol>
<p>The role was needed in my case because the role is also called Pai, it kept geting mixed up.</p>
<h3 id="thread-tracking">Thread tracking</h3>
<p>Threads bind on mention OR on Pai's own posts. Pai creates a thread to reply to a
parent-channel mention; without auto-bind, follow-ups in that thread silently get ignored.</p>
<h3 id="catchup-on-reconnect">Catchup on reconnect</h3>
<p>Helps avoid orphaned messages from things like mentions sent on pod reset.
<code>_catchup</code> runs once per <code>on_ready</code>.</p>
<h2 id="scheduling">Scheduling</h2>
<p>Two layers: in-process for items requested soon, and creates K8s CronJobs
for daily or recurring schedules.</p>
<h3 id="commitment-tracking">Commitment tracking</h3>
<p>Every 60 seconds it polls <code>COMMITMENTS.md</code> for entries with <code>status: pending AND due &#x3C;= now</code>, spawns Pai with a small tool list (<code>send_message</code>, <code>create_thread</code>,
<code>memory_commitment_done</code>) to execute on the commitments each.</p>
<p>Each commitment carries a <code>precision</code> field, either <code>precise</code> (for
explicit "remind me at...") or <code>soft</code> (for inferred follow-ups),
which Pai uses to phrase the message. Same delivery path either
way.</p>
<p>Inspired by openclaw's inferred-commitments.</p>
<h3 id="cronjobs-out-of-process">CronJobs (out-of-process)</h3>
<p>Per-task YAML in <code>infra/ai-agents/cronjobs/helm/templates/</code>.</p>
<p>At the time of writing this I have it summarizing the news, writing curated
horroscopes for my wife and kids, making nightly SEO improvements to the site, and
syncing any new blog posts to twitter bluesky and mastadon. I've also got an experimental
one called "autolearn" that is meant to look into emerging technologies, but it's kind
of bad so far.</p>
<h2 id="persona">Persona</h2>
<p><code>.claude/agents/pai.md</code> is one inline definition: voice, Discord
behaviour, security rules (Discord messages are untrusted input),
tool list, memory directives, browser scope. Repo-level <code>CLAUDE.md</code>
adds cross-project rules.</p>
<p>Per-user factual content (Kyle, Kara, family, projects) lives in
<code>MEMORY.md</code> and surfaces via recall, not in a separate persona
file. That's closer to what openclaw's <code>USER.md</code> is supposed to do
without the auto-injection token cost.</p>
<h2 id="self-improvement-and-observability">Self-improvement and observability</h2>
<p>A PostToolUse hook emits structured JSON per tool call. A DaemonSet ships
container stdout to OpenObserve's <code>k8s_logs</code> stream.</p>
<p>OpenObserve MCP exposes a bunch of tools that let Pai interact with it.</p>
<h3 id="pai-self-improver-cron">pai-self-improver cron</h3>
<p>Daily CronJob runs at 09:00 UTC. It queries the last 24h of failures,
clusters by normalized signature, threshold 3+ recurrences, and caps 5
proposals per run. Each run produces one Linear issue (label
<code>pai-self-improver</code>) and one Discord summary.</p>


Kyle Pericak

"It works in my environment"

Categories

Tags