← Back to Skills Marketplace
iazrael

OpenNotebook

by azrael · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ Security Clean
152
Downloads
0
Stars
1
Active Installs
1
Versions
Install in OpenClaw
/install opennotebook
Description
OpenNotebook 知识管理平台客户端。支持笔记本、源文件、笔记、AI搜索、转换管道等操作。首次使用请配置 OPENNOTEBOOK_BASE_URL 和 OPENNOTEBOOK_API_KEY。
Usage Guidance
This skill is coherent with its stated purpose (an OpenNotebook client) but check a few practical items before installing: - Ensure you trust the OpenNotebook server URL you supply; the client will send the API key and any files you upload to that server. Treat OPENNOTEBOOK_API_KEY as a secret. - The skill relies on the Python requests library but the registry metadata doesn't declare that dependency; install requests (pip install requests) or ensure your environment includes it before running. - The SKILL.md example shows adding a skill folder to sys.path (example uses /root/.openclaw/skills/opennotebook). Only add the actual trusted skill path and avoid running or importing unreviewed code as root. - The CLI saves config to ~/.openclaw/opennotebook.env. If you run the CLI, it may create/modify that file — review its contents to avoid accidental credential exposure. - If you need higher assurance, review the full code in opennotebook.py and opennotebook_client.py for any behavior you don't expect (they appear straightforward), and run tests in a non-production environment first. If these notes are acceptable, the skill looks consistent and implementationally reasonable.
Capability Analysis
Type: OpenClaw Skill Name: opennotebook Version: 1.0.0 The 'opennotebook' skill bundle is a comprehensive client for the OpenNotebook knowledge management platform. It provides a CLI (opennotebook.py) and a Python library (opennotebook_client.py) to manage notebooks, upload sources (files, URLs, text), and perform AI-driven searches and transformations. The code follows standard practices, such as using environment variables for configuration and providing extensive integration and unit tests (test_integration.py, test_opennotebook.py). No evidence of data exfiltration, malicious execution, or harmful prompt injection was found; the file upload and network capabilities are consistent with the stated purpose of the tool.
Capability Assessment
Purpose & Capability
Name/description (OpenNotebook client) matches the code and required env vars (OPENNOTEBOOK_BASE_URL, OPENNOTEBOOK_API_KEY). The CLI and client code implement notebooks, sources, notes, search, transformations, models, chat, podcasts etc. Requesting an API key and base URL is proportional to that functionality.
Instruction Scope
SKILL.md instructs writing/reading a config file at ~/.openclaw/opennotebook.env and shows CLI usage that can upload arbitrary files you point it at. It also suggests adding a skill path (example: /root/.openclaw/skills/opennotebook) to sys.path and importing the client — that is an explicit instruction to execute local skill code in the agent environment, which is expected for a local client but worth noting. There are no instructions to read unrelated system files or exfiltrate data to unexpected endpoints; all network calls target the user-supplied base URL.
Install Mechanism
There is no install spec (instruction-only), so nothing is automatically downloaded. However, the code depends on the Python 'requests' package; the requirement list only names python3. opennotebook.py prints a message prompting pip install requests if missing, but the skill metadata does not declare this dependency — an operational omission rather than a covert install.
Credentials
The two required environment values (OPENNOTEBOOK_BASE_URL, OPENNOTEBOOK_API_KEY) are appropriate for an API client. Minor inconsistency: registry metadata lists no primary credential even though OPENNOTEBOOK_API_KEY is functionally the primary secret. The code reads only those env vars (and an optional timeout), not unrelated secrets.
Persistence & Privilege
always:false and no special system-wide modifications. The skill writes/reads its own config file under ~/.openclaw and does not request OS-level privileges. Autonomous invocation of the skill is allowed by default (normal for skills) but not excessive here.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install opennotebook
  3. After installation, invoke the skill by name or use /opennotebook
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of the OpenNotebook knowledge management client. - Provides a full-featured command-line client for OpenNotebook, supporting notebooks, sources, notes, AI search, transformations, and more. - Supports configuration via environment variables for base URL and API key. - Includes usage examples and detailed documentation for all available commands. - Python API client included for integration in custom scripts or agents. - API documentation referenced for advanced usage.
Metadata
Slug opennotebook
Version 1.0.0
License MIT-0
All-time Installs 1
Active Installs 1
Total Versions 1
Frequently Asked Questions

What is OpenNotebook?

OpenNotebook 知识管理平台客户端。支持笔记本、源文件、笔记、AI搜索、转换管道等操作。首次使用请配置 OPENNOTEBOOK_BASE_URL 和 OPENNOTEBOOK_API_KEY。 It is an AI Agent Skill for Claude Code / OpenClaw, with 152 downloads so far.

How do I install OpenNotebook?

Run "/install opennotebook" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is OpenNotebook free?

Yes, OpenNotebook is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does OpenNotebook support?

OpenNotebook is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created OpenNotebook?

It is built and maintained by azrael (@iazrael); the current version is v1.0.0.

💬 Comments