nvimclaw
Bridge to live Neovim over OpenClaw's node plugin. Use for reading or editing named and unnamed buffers, discovering open buffers, running surgical Ex substitutions, inspecting cursor/selection/diagnostics, and Neovim chat-to-session messaging. Skill: nvimclaw Owner: utrumsit Summary: Bridge to live Neovim over OpenClaw's node plugin. Use for reading or editing named and unnamed buffers, discovering open buffers, running surgical Ex substitutions, inspecting cursor/selection/diagnostics, and Neovim chat-to-session messaging. Tags: latest:0.1.10 Version history: v0.1.10 | 2026-09-02T15:44:34.404Z | auto nvimclaw 0.1.10 - Updated SKILL.md for new version. - R
Rank
62
Safety
84
Downloads
1.2k
Updated
Oct 11, 2026
Version
0.1.10
Source
CLAWHUB
About
What it does, and when to use it.
Capability contract not published. No trust telemetry is available yet. 1.2K downloads reported by the source. Last updated 10/11/2026.
Avoid when
- Contract metadata is missing or unavailable for deterministic execution.
Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing
Public facts
Every fact links back to the source it came from.
- Vendor
- Clawhubvendor · observed Oct 11, 2026
- Protocol compatibility
- OpenClawcompatibility · observed Oct 11, 2026
- Adoption signal
- 1.2K downloadsadoption · observed Oct 11, 2026
- Latest release
- 0.1.10release · observed Sep 2, 2026
- Handshake status
- UNKNOWNsecurity
Install and run
Setup complexity: low.
clawhub skill install s17bhthv0zfmhbk81pyvhr1zvd83wgdq:nvimclaw- Setup complexity is classified as HIGH. You must provision dedicated cloud infrastructure or an isolated VM. Do not run this directly on your local workstation.
- Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.
Contract: missing
curl -s "https://www.xpersona.co/api/v1/agents/clawhub-utrumsit-nvimclaw/snapshot"
Documentation
CLAWHUB
145,414 characters of source documentation, loaded on request.
Extracted files
3 files captured from the source.
SKILL.md
---
name: "nvimclaw"
description: "Bridge to live Neovim over OpenClaw's node plugin. Use for reading or editing named and unnamed buffers, discovering open buffers, running surgical Ex substitutions, inspecting cursor/selection/diagnostics, and Neovim chat-to-session messaging."
version: "0.1.10"
requires:
nvimclaw: ">=0.1.5"
---
# nvimclaw — talk to a Neovim instance over the OpenClaw bridge
Use this skill whenever the user wants the agent to read, edit, or inspect something in their **live Neovim**. The bridge gives the agent access to buffers, the Ex command line (notably `:substitute`), cursor state, selections, and diagnostics — directly, without copy/paste or asking where files are.
nvimclaw is the **Neovim equivalent of `vscode.openclaw`**: it registers a Neovim instance as an *OpenClaw node* and exposes a `nvim.*` command surface the agent can invoke. It also exposes a **surface** (a chat buffer inside Neovim) so the user can summon the same agent session from inside the editor. Session, persona, and memory carry across surfaces.
The tool surface covers any file in any configured workspace — Markdown, Lua, Python, prose, configuration files, or anything else Neovim is editing live.
## Setup, once — never re-derive this
nvimclaw is a Neovim plugin that connects to the OpenClaw gateway with two roles:
- an operator-scoped chat surface for `sessions.send`
- a node-scoped tool surface for `node.invoke.request`
Operator chat can connect with the gateway token. The gateway may be local to Neovim or remote over `ws://` through an SSH tunnel. The node tool surface also needs gateway trust: `gateway.nodes.allowCommands` must include the `nvim.*` command names, and the `nvimclaw node` pairing must be approved once before commands become effective.
1. **Install the plugin** (lazy.nvim):
```lua
-- lua/plugins/nvimclaw.lua
return {
"utrumsit/nvimclaw",
event = "VeryLazy",
config = function()
require("nvimclaw").setup({
-- existing OpenClaw session key; default is "agent:main:main"
session = "agent:main:main",
})
end,
}
```
2. **Install the skill** (this file, as an agent):
```bash
openclaw skills install @utrumsit/nvimclaw
```
3. **Gateway URL and token.** The plugin reads the OpenClaw gateway token from the default location (`~/.openclaw/openclaw.json`, the standard `openclaw` CLI config) or the `OPENCLAW_GATEWAY_TOKEN` env var. If `~/.openclaw/openclaw.json` has `gateway.mode = "remote"` and `gateway.remote.url = "ws://..."`, nvimclaw uses that URL unless the user overrides `gateway` in `setup()`. For a remote OpenClaw over SSH tunnel, `ws://127.0.0.1:18789` is still correct on the Neovim machine.
4. **First launch.** On first run the plugin generates an Ed25519 device-identity keypair at `~/.local/state/nvimclaw/identity.json` (mode 0600), opens an operator WebSocket for chat, then opens a node-role WebSocket for tools after registering commands.
5. **Node a_meta.json
{
"ownerId": "kn7b7pyf1tvgebnnwvr1xs81r982g2te",
"slug": "nvimclaw",
"version": "0.1.10",
"publishedAt": 1788363874404
}skill-card.md
## Description: Bridge to live Neovim over OpenClaw's node plugin. Use for reading or editing named and unnamed buffers, discovering open buffers, running surgical Ex substitutions, inspecting cursor/selection/diagnostics, and Neovim chat-to-session messaging. This skill is ready for commercial/non-commercial use. ## Publisher: [utrumsit](https://clawhub.ai/user/utrumsit) ### License/Terms of Use: MIT-0 ## Use Case: Developers and agent operators use nvimclaw to let an agent inspect and edit live Neovim buffers, read diagnostics, cursor, and selection state, and coordinate chat turns from inside Neovim. ### Deployment Geography for Use: Global ## Known Risks and Mitigations: Risk: The skill gives an agent controlled access to inspect and potentially edit live Neovim buffers, including sensitive editor content. Mitigation: Install only when this editor access is intended, avoid sending chat turns from sensitive buffers, and disable or limit automatic context attachment when sensitive content should not be shared. Risk: Privileged tools can mutate buffers or run destructive Ex commands. Mitigation: Keep privileged tools disabled unless needed, require confirmation for destructive Ex commands, and use dry runs plus optimistic locks for buffer edits. Risk: Broad command allowlists on shared gateways can expose newly added privileged Neovim tools before they are reviewed. Mitigation: Prefer explicit command allowlists on shared gateways and approve node pairings only for trusted Neovim instances. ## Reference(s): - [ClawHub skill page](https://clawhub.ai/utrumsit/skills/nvimclaw) - [nvimclaw plugin repository](https://github.com/utrumsit/nvimclaw) - [vscode.openclaw reference implementation](https://github.com/xiaoyaner-home/openclaw-vscode/) ## Skill Output: **Output Type(s):** [text, markdown, code, shell commands, configuration, guidance] **Output Format:** [Markdown guidance with inline shell, Vim, Lua, and JSON snippets] **Output Parameters:** [1D] **Other Properties Related to Output:** [May include JSON command parameters for OpenClaw node invocation.] ## Skill Version(s): 0.1.10 (source: frontmatter and server release evidence) ## Ethical Considerations: Users should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.
AionUi
Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!
activepieces
AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
cherry-studio
AI productivity studio with smart chat, autonomous agents, and 300+ assistants.
CopilotKit
The Frontend for Agents & Generative UI. React + Angular
Machine-readable data
The same record, as JSON, for agents and crawlers.
{
"facts": [
{
"factKey": "vendor",
"category": "vendor",
"label": "Vendor",
"value": "Clawhub",
"href": "https://clawhub.ai/utrumsit/skills/nvimclaw",
"sourceUrl": "https://clawhub.ai/utrumsit/skills/nvimclaw",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-11T02:56:31.921Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "OpenClaw",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-utrumsit-nvimclaw/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-utrumsit-nvimclaw/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-10-11T02:56:31.921Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "1.2K downloads",
"href": "https://clawhub.ai/utrumsit/nvimclaw",
"sourceUrl": "https://clawhub.ai/utrumsit/nvimclaw",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-11T02:56:31.921Z",
"isPublic": true
},
{
"factKey": "latest_release",
"category": "release",
"label": "Latest release",
"value": "0.1.10",
"href": "https://clawhub.ai/utrumsit/nvimclaw",
"sourceUrl": "https://clawhub.ai/utrumsit/nvimclaw",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-09-02T15:44:34.404Z",
"isPublic": true
},
{
"factKey": "handshake_status",
"category": "security",
"label": "Handshake status",
"value": "UNKNOWN",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-utrumsit-nvimclaw/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-utrumsit-nvimclaw/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true
}
],
"events": [
{
"eventType": "release",
"title": "Release 0.1.10",
"description": "nvimclaw 0.1.10 - Updated SKILL.md for new version. - Removed skill-card.md. - Version bumped from 0.1.9 to 0.1.10. - No feature or interface changes; documentation and metadata updates only.",
"href": "https://clawhub.ai/utrumsit/nvimclaw",
"sourceUrl": "https://clawhub.ai/utrumsit/nvimclaw",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-09-02T15:44:34.404Z",
"isPublic": true
}
]
}Record generated Oct 11, 2026.
