← Back to Skills Marketplace
3004
Downloads
8
Stars
14
Active Installs
3
Versions
Install in OpenClaw
/install 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.
Usage Guidance
This skill is a local, filesystem-based notebook and appears coherent with its description. Before installing, note:
- It will create and write files under WORKSPACE/notebook (the code uses CLAWD_WORKSPACE if set, otherwise infers the workspace). Ensure you are comfortable with files being created there and that the agent has write permission.
- The code reads an optional CLAWD_WORKSPACE env var but the skill metadata does not list it; if you rely on a custom workspace set that env var.
- There are no network calls or credential requests in the code. Dependencies (js-yaml, uuid) are in package.json; if you plan to run the CLI, install dependencies in a controlled environment (or review package-lock) before running.
- If you want extra assurance, run the CLI in a sandboxed environment or inspect/execute the files locally rather than granting the agent broad runtime access.
Capability Analysis
Type: OpenClaw Skill
Name: notebook
Version: 1.0.2
The OpenClaw Notebook skill is designed as a local-first personal knowledge base. All file system operations in `cli.js` and `lib/store.js` are strictly confined to the skill's designated data directory (`/data/notebook/` within the workspace), preventing arbitrary file access. There are no external network calls, dynamic code execution, or attempts to access sensitive system resources. The `SKILL.md` provides clear instructions for the AI agent on how to interact with the user and utilize the skill's CLI, without any evidence of prompt injection designed to subvert the agent's behavior or exfiltrate data.
Capability Assessment
Purpose & Capability
Name/description (local-first personal knowledge base) match the code: store.js implements local YAML object types, index.json, and per-type object files under a workspace 'notebook' directory. No unrelated cloud APIs or unexpected capabilities are present.
Instruction Scope
SKILL.md instructs the agent to define types and manage objects via the CLI. The runtime code performs only filesystem operations to manage types and objects; the instructions do not ask the agent to read unrelated files, network endpoints, or credentials.
Install Mechanism
There is no install spec (instruction-only), which is low risk. The package.json/package-lock list js-yaml and uuid as dependencies; if a user chooses to run the CLI they may need to install those. No downloads from untrusted URLs or archive extraction are present.
Credentials
The skill declares no required env vars, but the code reads process.env.CLAWD_WORKSPACE to locate the workspace (optional fallback behavior exists). This is a minor mismatch: the env var is optional and reasonable for configuring workspace location, but it isn't documented in requires.env.
Persistence & Privilege
always is false; the skill does not request persistent system privileges or modify other skills. It writes data into a workspace-level 'notebook' directory only and does not alter global agent configuration.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install notebook - After installation, invoke the skill by name or use
/notebook - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.2
Version 1.0.2
- Removed unused data files: data/index.json and data/types.yaml.
- Updated internal storage logic in lib/store.js to remove reliance on the deleted files.
- No user-facing feature changes; all core workflows remain unchanged.
- Documentation (SKILL.md) updated for consistency, with no major content changes.
v1.0.1
- Added a YAML frontmatter section with name and description to SKILL.md.
- Clarified description to emphasize local-first, YAML-based knowledge base with no cloud lock-in.
- No changes to skill logic; documentation only.
v1.0.0
Initial release: introduces a guided object-based personal knowledge base.
- Onboards users step-by-step to define and use custom object types (ideas, projects, tasks, or custom).
- Provides interactive setup, including field customization and first object creation.
- Offers commands for adding, linking, listing, expanding, and editing objects.
- Stores data locally in YAML and JSON (no cloud dependencies).
- Supports extensible object types, inter-object linking, and customizable workflows.
Metadata
Frequently Asked Questions
What is Notebook?
Local-first personal knowledge base for tracking ideas, projects, tasks, habits, and any object type you define. YAML-based with no cloud lock-in. It is an AI Agent Skill for Claude Code / OpenClaw, with 3004 downloads so far.
How do I install Notebook?
Run "/install notebook" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Notebook free?
Yes, Notebook is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Notebook support?
Notebook is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Notebook?
It is built and maintained by Seth Rose (@thesethrose); the current version is v1.0.2.
More Skills