bear-notes

What This Skill Does

The bear-notes skill provides a bridge between OpenClaw and the Bear app on macOS via the grizzly CLI tool. It allows for seamless creation, retrieval, and management of notes within the Bear ecosystem. By leveraging x-callback-url capabilities, it enables the agent to read note content, append text, list tags, and perform searches without manual intervention. Whether you need to dump quick thoughts, append research findings to existing projects, or query your knowledge base for specific tags, this skill automates the heavy lifting while maintaining the organizational structure of your Bear library.

Installation

To integrate this skill, first ensure Bear is installed and running on your macOS system. Install the skill using the command: clawhub install openclaw/openclaw/skills/bear-notes. For operations requiring advanced interaction—such as appending text or listing tags—you must authenticate by obtaining an API token from Bear (Help > API Token) and saving it to ~/.config/grizzly/token. Configuration can be further customized via ~/.config/grizzly/config.toml to set global defaults for timeout and callback URLs.

Use Cases

This skill is perfect for users who treat Bear as their primary "second brain." Common use cases include auto-tagging and saving notes from web research, appending project updates to ongoing notes throughout the day, or creating automated summaries of meeting transcripts. By enabling AI-driven note management, you can maintain a cleaner inbox by categorizing notes instantly using the CLI-based tagging system.

Example Prompts

1. "Create a new note titled 'Project Ideas' with the content 'Implement OAuth2 flow' and tag it with 'development'."
2. "Search for all notes tagged with 'work' and summarize the top three most recent entries."
3. "Append the following text to my 'Daily Standup' note: 'Resolved the API integration bug by updating the authentication headers.'"

Tips & Limitations

Note IDs are unique identifiers specific to Bear; always use the --enable-callback flag when you need the agent to receive data back from the application. Be aware that the skill requires the Bear application to be open to process requests. If you experience issues, verify that your token file is correctly formatted and that no other process is blocking the default callback port. Use the --dry-run flag if you want to verify the target URL generated by the CLI before committing changes.