Repository navigation
v2.3.7b1
Pre-releaseAtMem 2.3.7 beta 1 — reliable Windows onboarding
AtMem 2.3.7b1 is a prerelease correction for native Windows and Windows Store
Python installations. It makes dashboard and companion discovery use the
active Python user installation, replaces POSIX-only process and durability
assumptions, and lets atmem init provision the Bun runtime required by the
separately packaged AtFlows dashboard. AtMem 2.3.6 remains the stable
recommendation while this beta receives clean-install review.
Install or upgrade
In the intended Python environment:
python -m pip install --pre --upgrade atmem==2.3.7b1
atmem --version
atmem init
atmem statuspip install installs AtMem, atmem-atbot==0.1.0, and atflows==0.1.2; it
does not execute a post-install downloader or start a service. If compatible
Bun 1.1 or newer is absent, the subsequent atmem init command clearly
announces and downloads the pinned official Bun 1.4.2 archive, verifies its
release-pinned SHA-256 before extraction, and stores the executable under
~/.atmem/runtime/bun/1.4.2. It does not require administrator rights or
modify global PATH. A compatible system Bun is reused instead.
The matching OpenClaw bridge is
openclaw-memory-atmem@2.3.7-beta.1. Existing OpenClaw users should run:
atmem openclaw upgrade
atmem control verify --probeWhat changed from 2.3.6
Automatic, verified Bun provisioning at initialization
atmem init now provisions Bun only when AtFlows needs it and no compatible
runtime is available. AtMem pins the official release URL and SHA-256 for the
supported Windows, Linux, and macOS x64 and ARM64 archives, enforces a 200 MiB
download limit, extracts only the single Bun executable, verifies its reported
version, and records source metadata beside the private runtime. Download and
verification progress goes to stderr so atmem init --json keeps valid JSON on
stdout.
atmem status identifies the Bun version, path, and whether it is a system or
AtMem-managed runtime. The managed path is added only to the environment of the
AtFlows process started by AtMem. AtFlows remains a separate service and data
store; installing or initializing AtMem does not configure any application to
send telemetry.
Windows Store Python launch and process fixes
Windows Store Python commonly installs console scripts and packages in its
user scheme. AtMem now discovers the exact nt_user scripts directory for the
AtFlows launcher. The dashboard daemon no longer hides the user-site package
with isolated-mode startup; instead it removes PYTHONPATH and PYTHONHOME,
uses AtMem's private runtime directory as its working directory, and marks the
detached process non-interactive. This prevents a background AtBot setup prompt
while preserving the safe deterministic fallback. Its bounded readiness window
also accommodates the slower first import from a cold Windows wheel environment.
Process status uses the Windows process API instead of the unsupported
POSIX-style os.kill(pid, 0) probe. The shared implementation is used by the
dashboard, Home service, AtBot service, and delegated provider lifecycle.
Portable durability and private-file checks
Directory fsync operations now use a portable helper: POSIX retains directory
fsync, while Windows treats unsupported directory handles as a platform
limitation after file flush and atomic replacement complete. The encrypted
evidence-key path no longer rejects a regular Windows file merely because NTFS
ACLs are not represented as Unix 0600 bits; POSIX mode-bit enforcement is
unchanged. Other optional provider/configuration paths retain their existing
platform constraints in this beta. No cryptographic format or authorization
rule changes.
Migration and compatibility
- No database, Home, evidence, memory, or account migration is required.
- Existing Home data and companion configuration are preserved.
- Existing compatible system Bun installations remain preferred and are not
modified. - A previously provisioned AtMem-managed Bun runtime is reused after its
recorded executable digest and version validate; normal package downgrade
does not silently delete it. - AtBot remains
atmem-atbot==0.1.0; model-assisted intelligence remains opt-in
and the safe deterministic fallback remains available. - AtFlows remains
atflows==0.1.2. Its first web-runtime preparation may still
need network access for its locked JavaScript dependencies. - Python 3.10–3.13 remains supported. The native Windows CI smoke on Python
3.14 is an early portability check, not an expanded support promise. - OpenClaw, framework, memory, retrieval, evidence, and authorization semantics
are otherwise unchanged from 2.3.6.
Honest beta limitations
- Automatic Bun provisioning occurs during
atmem init, not during pip's wheel
installation. Python packaging intentionally has no reliable post-install
hook for this external runtime. - Provisioning requires HTTPS access to the pinned official GitHub release. A
blocked or offline download leaves AtMem core memory usable but AtFlows
stopped, with an actionable error. - Automatic assets cover Windows, Linux, and macOS on x64 and ARM64. Other
platforms must install compatible Bun independently. - The managed Bun executable does not place
bunon the user's globalPATH;
it is private to AtMem-managed AtFlows. - Some optional delegated-provider setup and broader Unix-oriented tests still
assume POSIX permission bits. This beta qualifies core onboarding, Home,
dashboard, AtFlows, process, and durability paths on Windows; it does not
claim every optional provider lifecycle is native-Windows complete. - AtMem records and governs supported agent boundaries; it still cannot prove
external side effects without independent receipts.
Roll back
To return to the stable release:
python -m pip install --upgrade atmem==2.3.6
atmem openclaw upgrade
atmem statusDowngrading changes executable behavior but does not rewrite Home data or
delete the private Bun runtime. It can be removed manually while AtFlows is
stopped if it is no longer wanted.