Ai好记 Note Manager for Openclaw

Search, read, export, move, and AI-classify Ai好记 notes and notebooks through the Openclaw Skills-powered open platform.

aihaoji-agent
v0.1.0
Jul 15, 2026
0
461
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install aihaoji

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install aihaoji using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is Ai好记 Note Manager?

Ai好记 is an API-driven note and notebook management skill for Openclaw Skills. It connects to the Ai好记 Agent Open Platform so an AI coding agent can locate real notebook IDs, fetch note details, inspect records and highlights, and perform controlled write actions such as moving, renaming, creating, or deleting notebooks.

This Openclaw Skills workflow is built for safe, high-signal operations: it never guesses IDs, hides internal identifiers in normal responses, and requires an explicit confirmation plan before any write. When the API is unavailable or access is denied, it reports the failure clearly instead of falling back to local directory scans.

Ai好记 Note Manager Use Cases

  • Search notebooks, sub-notebooks, and notes by tree, keyword, or full URL.
  • Review recent, oldest, or filtered notes inside a specific notebook.
  • Export full note content to local Markdown for offline review.
  • Inspect summaries, outlines, highlights, annotations, and my_record data.
  • Move single notes or batches of notes and notebooks between folders.
  • Create, rename, or delete notebooks after explicit user confirmation.
  • Run AI auto-classification workflows that read content first, then propose an organized move plan.

How Ai好记 Note Manager Works

  1. Verify authentication and endpoint configuration from ~/.aihaoji/config.json, AIHAOJI_API_KEY, or AIHAOJI_BASE_URL.
  2. Resolve real notebook and note IDs by querying GET /agent-open/api/v1/folders and GET /agent-open/api/v1/notes; never infer IDs from names alone.
  3. Load note details when needed, including semantic views (summary, outline, highlights), semantic_chunk_no, and optional include_records=true.
  4. If the user wants a change, prepare a plan that lists the target notebook, notes to move, and any new notebooks that must be created.
  5. Wait for explicit user confirmation before writing; creation, renaming, moving, and deleting are all guarded operations.
  6. Execute the approved API mutation, using the correct payload shape for single-item or batch move requests.
  7. Re-query folders or notes to verify the result and present the updated state.
  8. If the API returns 401/403/429/5xx, explain that the platform is unavailable or access is restricted; do not switch to local guessing.

Ai好记 Note Manager Setup

  1. Create an Ai好记 developer key at https://openapi.aihaoji.com and verify it with GET /agent-open/api/v1/auth/verify.
  2. Save credentials in ~/.aihaoji/config.json (preferred) or provide them through environment variables.
  3. If workspace auto-setup is available, run npx aihaoji-openclaw setup.
mkdir -p ~/.aihaoji
cat > ~/.aihaoji/config.json <<'EOF'
{
  "apiKey": "sk-sxxxxxxxx",
  "baseUrl": "https://openapi.aihaoji.com"
}
EOF
export AIHAOJI_API_KEY="sk-sxxxxxxxx"
export AIHAOJI_BASE_URL="https://openapi.aihaoji.com"
curl -H "Authorization: $AIHAOJI_API_KEY" \
  "$AIHAOJI_BASE_URL/agent-open/api/v1/auth/verify"
npx aihaoji-openclaw setup

Ai好记 Note Manager Data Schema & Taxonomy

Core data model

Entity Key fields Source / rules
Notebook tree folder_id, parent_id, children, folder_tree_text IDs must come from GET /agent-open/api/v1/folders; root notebooks use parent_id=0.
Note list note_id, folder_id, keyword, page_no, page_size, sort_mode, sort_order Use GET /agent-open/api/v1/notes for search, recency, and notebook-scoped listing.
Note detail note_id, semantic_view, semantic_chunk_no, content payload Use GET /agent-open/api/v1/notes/{note_id} for full content and semantic reading modes.
Records payload include_records, records_detail.records, my_record, ai_highlights, ai_highlights_status Used when the user asks for annotations, highlights, or my_record.
Mutation payload name, target_folder_id, move_item_list[], move_type Write actions must use real IDs returned by the API.
Export artifact Local Markdown file Generated only when include_export_markdown=true.

ID and metadata taxonomy

  • folder_id: actual notebook ID returned by GET /folders.
  • note_id: actual note ID returned by GET /notes or note detail.
  • parent_id: use 0 for top-level notebooks; do not send JSON null.
  • target_folder_id: destination notebook ID; use -1 when moving a notebook to the root.
  • move_item_list[].item_id: real item ID; move_type=1 for notes, move_type=2 for notebooks.
  • include_records: enable record-aware reads.
  • include_export_markdown: export note content locally in Markdown.
  • semantic_view: choose summary, outline, or highlights for concise reading.
  • sort_mode, sort_order, page_no, page_size, keyword: control search and pagination.

Ai好记 Note Manager Advanced Features

  • Tree-aware notebook navigation across nested folders and notebooks.
  • Semantic reading modes for fast review: summary, outline, and highlights.
  • Record-aware retrieval for annotations, AI highlights, and my_record content.
  • Local Markdown export when users want offline review or archiving.
  • Batch move support for both notes and notebooks using PC-like payloads.
  • AI auto-classification workflows that read content first, draft a move plan, and wait for confirmation before writing.
  • Strict ID validation and confirmation gating to prevent accidental notebook changes.
  • Platform-only behavior: Openclaw Skills does not guess content from local files when the API is unavailable.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Requires
Github Stars: 0
forks: 0

Featured*