OpenClaw Memory Kit
Quick Start
- - Use
scripts/bootstrap-openclaw-memory.ps1 to generate the sharable workspace, config, env template, and launcher scripts. - Read references/architecture.md when you need the conceptual model behind the memory system.
- Read references/generated-files.md when you need to explain or customize the generated output.
- Read references/sanitization.md when the user wants to verify which private details must never be copied.
Workflow
- 1. Default to an isolated target root such as
~/.openclaw-memory-kit unless the user asks to merge into an existing OpenClaw state directory. - Keep the base kit memory-focused. Treat Feishu, Telegram, WeChat, and Memos as optional follow-up integrations instead of required setup.
- For the current tested OpenClaw build, install
memory-lancedb-pro together with a matching local openclaw package inside the generated state directory. This keeps openclaw/plugin-sdk resolvable for the memory plugin on newer releases. - Never copy the source user's raw
.env, live app IDs, channel bindings, private LAN addresses, personal scope names, or filesystem usernames. Use placeholders only. - Run the bootstrap script. Use
-Force only when the user explicitly wants to overwrite an existing kit. - If the user wants a human-facing handoff, point them to the package-level
OPENCLAW-MEMORY-KIT.md.
Script
Run the generator from PowerShell:
CODEBLOCK0
Add -Force to overwrite generated files. Add -SkipCorePluginInstall if the user only wants files and will install plugins later.
Output Expectations
The bootstrap script should generate:
- - INLINECODE10
- INLINECODE11 and a placeholder
.env if one does not already exist - INLINECODE13 and
package-lock.json when core memory dependencies are installed - INLINECODE15 and INLINECODE16
- INLINECODE17 prompt files
- INLINECODE18 collaboration, memory, and task system documents
- INLINECODE19 ,
plugins.slots.memory, and plugins.entries.memory-lancedb-pro.config in INLINECODE22 - memory mirror and task board directories
Customization Points
- - Change the role lineup in the
New-RoleCatalog function. - Change provider/model defaults in the
New-OpenClawConfig function. - Keep optional channel plugins outside the base scaffold unless the user explicitly asks to prewire them.
- For current OpenClaw builds, treat Feishu as bundled-or-optional depending on the target install. Only add a manual Feishu plugin command when the target build is missing Feishu.
- The current tested memory install path is state-local npm dependencies, not
openclaw plugins install memory-lancedb-pro, because the plugin still expects local openclaw/plugin-sdk resolution.
OpenClaw 记忆工具包
快速开始
工作流程
- 1. 默认使用隔离的目标根目录,例如 ~/.openclaw-memory-kit,除非用户要求合并到现有的 OpenClaw 状态目录中。
- 保持基础工具包以记忆为核心。将飞书、Telegram、微信和 Memos 视为可选的后续集成,而非必需配置。
- 对于当前测试的 OpenClaw 构建版本,在生成的状态目录内同时安装 memory-lancedb-pro 和匹配的本地 openclaw 包。这确保了在较新版本中,记忆插件能够解析 openclaw/plugin-sdk。
- 绝不复制源用户的原始 .env、实时应用 ID、频道绑定、私有局域网地址、个人作用域名称或文件系统用户名。仅使用占位符。
- 运行引导脚本。仅当用户明确想要覆盖现有工具包时,才使用 -Force 参数。
- 如果用户需要人工交接,请引导他们查看包级别的 OPENCLAW-MEMORY-KIT.md 文件。
脚本
在 PowerShell 中运行生成器:
powershell
& $PSScriptRoot\scripts\bootstrap-openclaw-memory.ps1
-TargetRoot $HOME\.openclaw-memory-kit
-PrimaryModel minimax/M2.5
-GatewayPort 18789
添加 -Force 参数以覆盖已生成的文件。如果用户只需要文件并计划稍后安装插件,请添加 -SkipCorePluginInstall 参数。
输出预期
引导脚本应生成:
- - openclaw.json
- .env.example 和一个占位符 .env(如果尚不存在)
- 安装核心记忆依赖时的 package.json 和 package-lock.json
- start-gateway.ps1 和 start-gateway.cmd
- workspace/agents// 提示文件
- workspace/shared/ 协作、记忆和任务系统文档
- openclaw.json 中的 plugins.load.paths、plugins.slots.memory 和 plugins.entries.memory-lancedb-pro.config
- 记忆镜像和任务面板目录
自定义点
- - 在 New-RoleCatalog 函数中更改角色列表。
- 在 New-OpenClawConfig 函数中更改提供者/模型默认值。
- 除非用户明确要求预配置,否则将可选的频道插件保留在基础脚手架之外。
- 对于当前的 OpenClaw 构建版本,根据目标安装情况将飞书视为捆绑或可选。仅当目标构建版本缺少飞书时,才添加手动飞书插件命令。
- 当前测试的记忆安装路径是状态本地的 npm 依赖项,而非 openclaw plugins install memory-lancedb-pro,因为该插件仍然期望本地 openclaw/plugin-sdk 解析。