A precise Language Server Protocol integration for Openclaw Skills that enables deep code intelligence and navigation.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install lsp-assist
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install lsp-assist 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 lsp-assist?
lsp-assist is a specialized integration designed for Openclaw Skills that brings the full power of the Language Server Protocol (LSP) to AI coding agents. While basic agents often rely on grep or simple string searches, lsp-assist provides a deeper understanding of the codebase by interacting directly with official language servers like pyright and the typescript-language-server. This allows agents to resolve complex symbol definitions, track cross-file references, and perform type-aware analysis with the same accuracy as a modern IDE.
Built with performance and security in mind, this skill supports both a high-throughput daemon mode for ongoing development sessions and a one-shot mode for quick, isolated queries. It acts as the bridge between an agent's logical reasoning and the technical truth of a compiled or interpreted project, making it an essential component for any developer building sophisticated agents with Openclaw Skills.
lsp-assist Use Cases
- Resolve function and class definitions precisely using the go-to-definition feature
- Identify all call sites and usages across a project with find-references
- Retrieve detailed type information and documentation via hover signatures
- Automatically detect and report syntax or type errors through real-time diagnostics
- Navigate large codebases by searching for specific workspace symbols by name
How lsp-assist Works
- The AI agent or user identifies a need for code intelligence, such as finding a definition or checking for errors.
- The lsp-assist client initializes a connection to the appropriate language server based on the file extension (TypeScript or Python).
- In Daemon mode, a persistent HTTP server is established to maintain the language server state across multiple queries, significantly reducing latency.
- The skill performs strict security checks, ensuring all requested file paths are contained within the designated project root.
- The tool communicates with the language server via JSON-RPC over stdio to fetch precise metadata.
- The raw LSP response is parsed and formatted into a clean, structured JSON object.
- The agent receives the data to accurately perform edits or navigate to the correct file location.
lsp-assist Setup
To integrate lsp-assist into your environment for Openclaw Skills, ensure you have Python 3.10+ and the necessary language servers installed.
# Install the required language servers globally
npm i -g typescript-language-server typescript
pip install pyright
# To start the daemon for a specific project
python3 scripts/lsp_client.py daemon --lang typescript --root /path/to/project --port 9876
# For a single query without a persistent daemon (One-shot mode)
python3 scripts/lsp_client.py --lang python --root . goto --file main.py --line 5 --col 10
lsp-assist Data Schema & Taxonomy
The skill returns structured JSON data to ensure compatibility with agentic workflows. Below is the mapping of actions to their output structures:
| Action | Return Format | Description |
|---|---|---|
goto / refs |
Array<Object> |
Contains file, line, and col keys for symbol locations. |
hover |
String |
A markdown-formatted string describing the symbol type and documentation. |
diag |
Array<Object> |
Lists severity, line, and message for project errors. |
symbols |
Array<Object> |
Detailed list including symbol name, kind, and container. |
ping |
Object |
Health check returning {"status": "ok"}. |
lsp-assist Advanced Features
- Daemon Mode: Allows for low-latency, persistent sessions that keep language servers warm for faster multi-query responses.
- Project Root Containment: Advanced security logic using Path.resolve and commonpath to prevent directory traversal attacks.
- Bearer Token Auth: Optional security layer for daemon mode requiring an Authorization header for all HTTP requests.
- Multi-Language Support: Native integration for both TypeScript (JS) and Python codebases.
- Clean Shutdown: Dedicated /shutdown endpoint that ensures a graceful exit of both the HTTP bridge and the underlying language server processes.
SKILL.md
Loading
Related Openclaw Skills
Article Formatter - Professional Self-Media Content Styler
A specialized tool for formatting self-media articles into highly readable, visually appealing, and mobile-optimized content.
agent-web-cpu
A sophisticated automation suite that executes, chains, and manages AI applications on transweb.cn through browser-based agent workflows.
OpenRelay Agent-to-Agent Marketplace
A comprehensive skill for AI agents to register, publish services, and conduct autonomous transactions within a decentralized marketplace.
Snail
Snail is an AI agent dating protocol that prioritizes cautious matching and slow-paced connection building.
Kindergarten Video
Kindergarten Video is a specialized AI agent skill designed to create professional enrollment and marketing videos that simplify the transition from preschool to kindergarten.
Corpus Builder
A professional tool for building AI-ready corpora using intelligent chunking, multi-dimensional AI annotation, and vector database storage.
Featured*
