← Back to Skills Marketplace
535
Downloads
1
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install joplin-cli
Description
Joplin 命令行操作（Shell 模式）。用于通过 CLI 创建、查看、编辑、同步笔记，适合脚本和自动化任务。
README (SKILL.md)
Joplin CLI Skill
通过命令行直接操作 Joplin，无需 API 服务。
常用命令
# 笔记本操作
joplin mkbook "笔记本名" # 创建笔记本
joplin use "笔记本名" # 切换当前笔记本
joplin ls / # 列出所有笔记本
joplin ls -l # 列出当前笔记本的笔记（含ID）
# 笔记操作
joplin mknote "标题" # 创建笔记
joplin cat \x3Cid|标题> # 查看笔记内容
joplin set \x3Cid> title "新标题" # 修改标题
joplin set \x3Cid> body "内容" # 修改内容
joplin edit \x3Cid> # 用编辑器打开
# 同步
joplin sync # 同步到远程
引用笔记
- 用 ID：
joplin cat fe889 - 用标题：
joplin cat "我的笔记" - 用
$n引用当前选中的笔记（TUI 模式）
详细文档
references/COMMANDS.md— 完整命令参考references/INSTALL.md— 安装指南
Usage Guidance
This skill is coherent: it simply documents and runs Joplin CLI commands and expects the 'joplin' binary to be present. Before installing/using it: 1) ensure the joplin binary on your system is the official/trusted build (npm or distro packages) because the skill will execute it; 2) be aware that any agent invocation will be able to read and modify your Joplin data (in ~/.config/joplin) and can run 'joplin sync' to send data to configured remote endpoints — only configure trusted sync targets and avoid placing high-value secrets in sync.password if you do not trust the agent; 3) this skill will not install Joplin for you, so install and verify the CLI yourself; 4) if you want to limit risk, run the skill in an environment with only the notes you want the agent to access or avoid giving it commands that configure new remote sync endpoints.
Capability Analysis
Type: OpenClaw Skill
Name: joplin-cli
Version: 0.1.0
The skill bundle provides a straightforward interface for the Joplin CLI tool, as described in its documentation. All documented commands and capabilities, including file system access, network synchronization, and credential handling (for sync targets), are inherent features of the legitimate Joplin CLI. There is no evidence of intentional malicious behavior, data exfiltration, persistence mechanisms, or prompt injection attempts against the OpenClaw agent within the `SKILL.md` or other files. The `allowed-tools: Bash(joplin:*)` permission is broad but necessary for the skill's stated purpose of operating the Joplin CLI.
Capability Assessment
Purpose & Capability
Name/description state CLI operations for Joplin; the skill only requires the 'joplin' binary and the SKILL.md documents CLI commands and sync configuration. Requested artifacts (none) match expected needs for a CLI helper.
Instruction Scope
Instructions only tell the agent to run joplin commands (create/list/edit/sync/etc.). The docs reference Joplin config and data paths (~/.config/joplin) and show how to set sync passwords and endpoints; while that is expected for a sync-capable note tool, it means any agent run can operate on local notes and trigger sync to remote endpoints if invoked — expected but worth noting.
Install Mechanism
No install spec or external downloads are present (instruction-only). The INSTALL.md describes standard install options (npm, AUR) and references official sources; nothing in the skill writes code or fetches arbitrary archives.
Credentials
The skill declares no required environment variables or credentials. The documentation shows how users may configure sync credentials in Joplin itself, which is appropriate for the described functionality. There are no unrelated credential requests.
Persistence & Privilege
always is false and model invocation is allowed (platform default). The skill does not request persistent system changes or modify other skills' configs. It simply allows the agent to run Joplin CLI commands when invoked.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install joplin-cli - After installation, invoke the skill by name or use
/joplin-cli - Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.0
Initial release.
- Provides common Joplin CLI commands for notebook and note management.
- Supports creating, viewing, editing, and syncing notes via the command line.
- Suitable for scripting and automation tasks.
- Includes references to detailed command and installation documentation.
v0.0.1
- Initial release of joplin-cli skill.
- Supports creating, viewing, editing, and syncing Joplin notes via command line (Shell mode).
- Suitable for scripting and automation tasks.
- Requires local Joplin CLI binary; does not use API service.
- Includes basic usage examples and references for commands and installation.
Metadata
Frequently Asked Questions
What is Joplin Cli?
Joplin 命令行操作（Shell 模式）。用于通过 CLI 创建、查看、编辑、同步笔记，适合脚本和自动化任务。 It is an AI Agent Skill for Claude Code / OpenClaw, with 535 downloads so far.
How do I install Joplin Cli?
Run "/install joplin-cli" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Joplin Cli free?
Yes, Joplin Cli is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Joplin Cli support?
Joplin Cli is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Joplin Cli?
It is built and maintained by KGTAF (@killgfat); the current version is v0.1.0.
More Skills