claw-starter-kit

你的 AI 私人助手，一键启动。基于 OpenClaw，中文用户友好。

OpenClaw Stars Chinese MIT License

这是什么？

一个预配置好的 OpenClaw AI 助手模板，帮你跳过繁琐的初始化，5 分钟拥有自己的 AI 私人助手。

包含：

• 灵魂三件套：SOUL.md / USER.md / IDENTITY.md 模板
• 心跳配置：HEARTBEAT.md 预设日常检查项
• 记忆系统：MEMORY.md + memory/ 目录结构
• 工作指南：AGENTS.md 行为准则
• 工具笔记：TOOLS.md 本地工具速查
• 推荐 Skills：精选实用技能列表

快速开始

1. 安装 OpenClaw

npm install -g openclaw

2. 使用模板

# 克隆此模板
git clone https://github.com/wubaiqing/claw-starter-kit.git workspace
cd workspace

3. 个性化配置

编辑以下文件，把助手变成「你的」：

# 定义助手的性格和行为
vim SOUL.md

# 告诉助手关于你的信息
vim USER.md

# 给助手起名字、设定形象
vim IDENTITY.md

4. 配置

修改 ~/.openclaw/openclaw.json 把 agents 参数指向到 ~/workspace 目录

{
  agents: { defaults: { workspace: "~/workspace" } }
}

5. 配置环境变量（全局）

使用提供的脚本将环境变量注入到系统 Shell 配置中：

# 1. 先在 .env.example 中填写环境变量的值
vim .env.example

# 2. 运行注入脚本
./scripts/inject-env.sh

# 3. 使配置生效（根据你的 Shell 选择）
source ~/.zshrc   # zsh 用户
# 或
source ~/.bashrc  # bash 用户

6. 启动

openclaw gateway start

然后在 Telegram / 飞书 上跟你的助手说声「你好」！

文件结构

workspace/
├── AGENTS.md          # 助手的行为准则和工作流程
├── SOUL.md            # 灵魂文件：性格、语气、边界
├── USER.md            # 用户画像：让助手了解你
├── IDENTITY.md        # 身份设定：名字、形象、Vibe
├── HEARTBEAT.md       # 心跳检查项：助手定期自动执行
├── MEMORY.md          # 长期记忆：重要事件和经验
├── TOOLS.md           # 工具笔记：本地配置速查
├── TODO.md            # 任务清单
├── .env.example       # 环境变量示例（填写后使用 inject-env.sh 注入）
├── memory/            # 每日记忆文件
│   └── .gitkeep
├── content/           # 内容输出目录
│   └── .gitkeep
├── skills/            # Skills 目录（自定义/扩展）
│   └── .gitkeep
├── scripts/           # 实用脚本
│   └── inject-env.sh  # 环境变量注入脚本
└── docs/
    └── SKILLS-GUIDE.md  # 推荐技能清单和安装指南

推荐 Skills

完整技能列表请查看 ClawdHub。

备份策略（约定）

• 系统级运行目录：OpenClaw 的运行态目录（通常位于用户主目录下的隐藏目录）
• 你的自定义配置/文档/skills：本仓库目录（你 clone 到哪里就是哪里）
• 所有“备份类文件”统一归档到：专用备份目录（按你机器习惯设置）

备注：文档中避免出现服务器绝对路径；按“角色/用途”描述即可。

安全提醒

• 不要把 API Key 提交到 Git（使用 .env 或环境变量）
• 安装 Skill 前检查源码
• clawdbot.json 配置文件权限建议设为 chmod 600
• 定期检查和清理 MEMORY.md 中的敏感信息

License

MIT License - 自由使用、修改、分发。