笔记本：Openclaw Skills 的本地优先个人知识库

什么是 笔记本？

笔记本是专为 Openclaw Skills 构建的强大个人知识管理系统，优先考虑数据所有权和灵活性。与依赖云的工具不同，此技能以 YAML 格式将所有信息存储在本地，确保没有供应商锁定。它允许开发人员和高级用户定义自己的数据结构——无论是为了跟踪软件功能、项目里程碑还是个人习惯——使其成为以终端为中心的工作流中通用的数字组织中心。

通过利用 Openclaw Skills 的力量，笔记本将原始文本转化为结构化数据库。用户可以定义自定义字段，如状态选择、优先级和长篇笔记，允许 AI 代理通过智能提问和上下文链接协助捕捉和扩展想法。

下载入口:https://github.com/openclaw/skills/tree/main/skills/thesethrose/notebook

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

npx clawhub@latest install notebook

2. 手动安装

将技能文件夹复制到以下位置之一

全局模式 ~/.openclaw/skills/ 工作区 /skills/

优先级：工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

请帮我使用 Clawhub 安装 notebook。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。

笔记本 应用场景

• 管理新软件想法的功能待办列表或“灵感垃圾场”。
• 跟踪长期项目目标和多步骤执行计划。
• 维护结构化的阅读列表或专业联系人的个人 CRM。
• 使用自定义元数据和优先级构建本地任务管理系统。
• 链接零散的信息，例如将特定想法连接到更大的项目。

笔记本 工作原理

1. 用户通过指定文本、数字或选择列表等字段来定义新的对象类型。
2. 技能在本地工作区的 types.yaml 文件中初始化模式。
3. 通过命令添加新对象，使用 YAML 条目填充本地数据目录。
4. 用户可以调用扩展协议，代理会提出澄清问题以增加条目的深度。
5. 通过链接不同类型的对象建立关系，创建网络化知识库。
6. 系统维护一个 index.json，以便在所有存储的对象中进行快速搜索和检索。

笔记本 配置指南

要在 Openclaw Skills 环境中开始使用笔记本，请定义您的第一个对象类型以初始化目录结构：

# 定义一个用于跟踪想法的自定义类型
notebook type-add idea title:text status:select(raw|expanded|archived) priority:select(high|medium|low) tags:text notes:longtext

# 添加您的第一个条目
notebook add idea "Initial Project Concept" -t research -p high

笔记本 数据架构与分类体系

笔记本技能使用扁平文件结构在 /data/notebook/ 目录中组织数据，以实现最大的便携性：

文件/文件夹	描述
objects/	包含为每个创建的对象生成的独立 YAML 文件。
types.yaml	存储自定义对象类型的模式定义。
index.json	用于快速搜索和交叉引用的元数据索引。

支持的字段类型

• text: 短字符串值。
• longtext: 多行描述或笔记。
• select(a|b|c): 单选下拉选项。
• number: 用于跟踪指标的数字数据。
• date: 标准化日期格式。
• list: 用于标签或集合的字符串数组。

name: Notebook
description: Local-first personal knowledge base for tracking ideas, projects, tasks, habits, and any object type you define. YAML-based with no cloud lock-in.

Notebook Skill Object Based Personal Knowledge Base

Purpose: Track any object type you define such as ideas, projects, tasks, habits, books, and people.

Location: {WORKSPACE}/skills/notebook/

Agent Onboarding Protocol

Guide the user through setup when no object types exist.

Step 1 Suggest a First Type

It looks like you have not defined any object types yet.
Notebook works best when you define the types of things you want to track.

What would you like to start with?

1. Ideas for capturing thoughts and features
2. Projects for long term work with goals
3. Tasks for actionable items with due dates
4. Something custom tell me what you want to track

Step 2 Define the Type Together

If they choose a preset:

Great. Let us set up [type].

I will create it with useful fields. You can add or remove them later.

For [type], what fields do you want?
- title (text, required)
- status (select)
- priority (select)
- tags (text)
- notes (longtext)
- [custom fields]

What fields should [type] have?

If they want custom:

Tell me what you want to track and what details matter.

Example: I want to track books I read. I need title, author, status, rating, and notes.

I will translate that into a type definition.

Step 3 Create the First Object

Now let us add your first [type].

What do you want to track as your first [type]?

Example: The Andromeda Strain for books or Home automation for projects

Step 4 Show the Workflow

Perfect. You now have:
- Type: [typename] with [N] fields
- 1 [typename] object: [title]

What would you like to do next?

- notebook list [typename] to see all items
- notebook expand [typename] [title] to add details
- notebook add [typename] to add another
- notebook type-add [typename] to add more fields later

Step 5 Offer Expansion

Would you like to deepen this [typename] with some questions?
Say expand and I will ask questions to add depth.

Quick Reference

Defining Types

notebook type-add typename field1:text field2:select(a|b|c) field3:number

Field types:

• text for short strings
• longtext for multi line notes
• select(a|b|c) for one option from a list
• number for numeric values
• date for dates
• list for an array of strings

Working with Objects

notebook add typename "Title" [-t tag1,tag2 -p priority]
notebook list typename
notebook get typename title
notebook expand typename title
notebook edit typename "title" field:value
notebook link type1:title1 type2:title2
notebook delete typename title
notebook find "query"
notebook stats

Example Workflow

# 1. Define a type
notebook type-add idea title:text status:select(raw|expanded|archived) priority:select(high|medium|low) tags:text notes:longtext

# 2. Add your first idea
notebook add idea "Voice capture while driving" -t voice,automation -p high

# 3. Deepen it
notebook expand idea "voice capture"

# 4. Link to other objects
notebook add project "Home automation" -t household
notebook link idea:"voice capture" project:"home automation"

# 5. Update as you work
notebook edit idea "voice capture" status:expanded

Data Location

/data/notebook/
├── objects/
├── types.yaml
└── index.json

Design Principles

• User defined: You define the types that matter.
• Local first: Uses YAML files with no cloud or vendor lock in.
• Linkable: Objects can reference each other.
• Extensible: Add types and fields as needed.
• Expandable: Use intelligent questioning to deepen thinking.