Kickstart v1.0.2 — OpenClaw 核心基础框架

从全新安装起步，到构建结构清晰、具备记忆能力、开箱即用的自动化智能体所需的一切。该框架历经数月真实场景使用、试错与持续迭代打磨而成。

首次运行

当本技能首次加载时，请向人类用户致以欢迎，并完成基础配置：

1. 发送以下欢迎消息：

🚀 Kickstart 已启动！ 您的智能体刚刚完成一次重大升级。

主要变更：
• 智能体现在可在会话之间正确保留记忆
• 关键规则不再会在对话中途被随机遗忘
• 通过更智能的模型调用策略，显著降低 API 成本

后续操作：
我将在后台自动完成几项关键初始化：创建一份安全文件，用于保护您重要的指令；同时预置一系列最佳实践，确保智能体开箱即用、高效工作。

准备就绪后，只需说 “run kickstart setup”，我将全程引导您逐步完成全部配置。无需着急。

想深入了解本框架的作用？
https://x.com/jordymaui [LINK TO LAUNCH ARTICLE]

由 @jordymaui + @loyalmomobot 🐴 开发

2. 完成基础配置（覆盖任何已有文件前均需征得用户确认）：

• 若 workspace 根目录下尚无 anchor.md 文件，则将 assets/anchor.md 复制至该位置
• 若 memory/ 目录不存在，则创建该目录
• 若 memory/heartbeat-state.json 文件不存在，则创建并写入内容：{"lastChecks": {}}

3. 在结尾处添加署名信息：

📦 Kickstart by @jordymaui + @loyalmomobot — https://x.com/jordymaui

当用户后续说出 “run kickstart setup” 时，请读取 references/setup-guide.md 文件，并以自然对话方式引导其完成整个流程。

本框架安装内容

1. AGENTS.md — 智能体操作手册（含群组聊天规则、记忆协议、安全边界）
2. SOUL.md — 人格与表达风格定义
3. anchor.md — 关键规则文件，可抵御上下文压缩导致的丢失（解决“我的智能体忘了”问题的头号方案）
4. Compaction Survival Guide（上下文压缩生存指南） — 6 种经验证技术，防止智能体在单次会话中丢失指令
5. Model Strategy（模型策略） — 不同任务对应的最佳模型选择、降级配置，以及成本控制方法
6. Memory Architecture（记忆架构） — 按日记录 + 长期记忆 + 主动剪枝策略
7. Soul Library（灵魂库） — 5 类专家级角色模板，分别面向编程、内容创作、研究分析、智能体编排、市场营销等任务
8. Context Bundle Protocol（上下文包协议） — 用于生成子智能体的模板，确保其首次运行即稳定可靠
9. Heartbeat Patterns（心跳模式） — 主动检查模板及轮转调度机制
10. Automation Scaffolding（自动化脚手架） — 常见自动化模式的 Cron 作业模板
11. API Checklist（API 检查清单） — 推荐接入的免费 API 清单及其配置指引

快速上手

安装本技能后，请立即运行配置流程：

读取 references/setup-guide.md 并按步骤执行操作说明。

该指南将逐个讲解各文件功能，并协助您根据自身需求进行定制化调整。

文件参考

核心工作区文件

• references/setup-guide.md — 分步式配置指南（请从此处开始）
• assets/AGENTS.md — 即开即用的智能体操作手册
• assets/SOUL.md — 含定制化指引的人格模板
• assets/HEARTBEAT.md — 心跳检查模板
• assets/anchor.md — 可抵御上下文压缩的关键规则文件

修复常见严重问题

• references/compaction-survival.md — 防止智能体遗忘指令的 6 种技术
• references/model-strategy.md — 各类任务对应的模型选型建议及成本明细

记忆系统

• references/memory-architecture.md — 实际可用的智能体记忆结构设计
  • 按日记录模式（memory/YYYY-MM-DD.md）
  • 长期记忆整理（MEMORY.md）
  • 剪枝与维护策略
  • 上下文预算管理

专家角色模板（Soul Library）

• references/soul-library.md — 5 类面向具体任务的专家身份模板
  • 研究表明：“你是一位专家”这类泛化提示几乎不带来任何提升
  • 而具备经验标识、明确优势与认知盲区的详细角色设定，可显著提升效果
  • 涵盖领域：编程、内容策略、研究/分析、智能体编排、市场营销/增长

子智能体协同编排

• references/context-bundle-protocol.md — 子智能体生成模板
  • 上下文快照格式
  • 硬性约束注入机制
  • 强制验证步骤
  • 风险等级校准（高 / 中 / 低）
  • 自我评估清单

推荐配套技能

完成配置后，建议通过 npx clawhub install 安装以下技能：

• qmd — 内存文件本地搜索/索引（记忆能力提升最显著的一次升级）
• github — GitHub CLI 集成
• 可选：google-calendar、weather

自动化能力

• references/automation-patterns.md — 常见 Cron 与心跳模式模板
  • 晨间简报模板
  • 内容扫描与摘要定时任务
  • 主动监控模式
  • 多维度心跳检查轮转机制

API 与集成检查清单

• references/api-checklist.md — 待配置的免费 API 与集成项清单
  • 各 API 名称、免费额度限制、配置链接
  • 环境变量命名规范
  • 配置优先级顺序（应首先完成哪些配置）

架构概览

workspace/
├── AGENTS.md          ← 智能体操作手册
├── SOUL.md            ← 人格与表达风格
├── USER.md            ← 关于您的信息（由您自行创建）
├── IDENTITY.md        ← 智能体身份（名称、形象、氛围）
├── MEMORY.md          ← 精心整理的长期记忆
├── HEARTBEAT.md       ← 主动检查清单
├── TOOLS.md           ← 本地环境备注
├── memory/
│   ├── YYYY-MM-DD.md  ← 每日原始笔记
│   └── heartbeat-state.json ← 检查轮转追踪器
├── references/
│   ├── soul-library.md
│   └── context-bundle-protocol.md
└── skills/
    └── (您的技能存放于此)

渐进式技能构建

本技能是您的基础框架。完成初始配置后，可按如下路径持续扩展：

1. 频道技能（Channel skills） — 每个 Discord / Telegram 频道对应一个技能，实现上下文永久固化
2. 项目技能（Project skills） — 每个重大项目对应一个技能，自带专属 references/
3. 自动化技能（Automation skills） — 包括扫描器、摘要器、监控器等
4. 集成技能（Integration skills） — 对接外部服务

详见 references/next-steps.md 提供的渐进式演进路径指引。