crabwalk
Real-time companion monitor for OpenClaw agents
Why use this skill?
Crabwalk provides real-time monitoring and visualization for OpenClaw agents. Track agent tasks, debug workflows, and browse files via a simple, interactive web dashboard.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/luccast/publicWhat This Skill Does
Crabwalk acts as the eyes and ears for your OpenClaw agents, providing a robust, real-time companion monitoring interface. By deploying this skill, you bridge the gap between autonomous agent operations and human oversight. It visualizes agent behavior through interactive graphs using ReactFlow, offers a comprehensive file browser, and handles secure gateway authentication automatically. Whether you are observing live decision-making flows or inspecting the workspace state, Crabwalk turns cryptic agent logs into an intuitive, observable environment.
Installation
Installation is streamlined for speed and compatibility. First, ensure you have Node.js 20+ installed on your machine. Execute the following in your terminal to fetch the latest binary:
VERSION=$(curl -s https://api.github.com/repos/luccast/crabwalk/releases/latest | grep '"tag_name"' | cut -d'"' -f4) && mkdir -p ~/.crabwalk ~/.local/bin && curl -sL "https://github.com/luccast/crabwalk/releases/download/${VERSION}/crabwalk-${VERSION}.tar.gz" | tar -xz -C ~/.crabwalk && cp ~/.crabwalk/bin/crabwalk ~/.local/bin/ && chmod +x ~/.local/bin/crabwalk
Ensure ~/.local/bin is in your PATH. If you wish to use QR code features for easier access, ensure qrencode is installed on your system via your package manager (e.g., sudo apt install qrencode). Once installed, verify via crabwalk --version and initialize the server with crabwalk.
Use Cases
Crabwalk is ideal for developers debugging multi-step agent reasoning chains. Because it visualizes the execution graph in real-time, it allows users to pinpoint where an agent loop might be stalling or branching unexpectedly. It is also an essential tool for collaborative development, allowing team members to monitor a shared agent instance simultaneously. The /workspace feature makes it a portable dashboard for reviewing markdown documentation generated during an agent's workflow.
Example Prompts
- "OpenClaw, start the Crabwalk monitor and give me the network link so I can track your current task status on my tablet."
- "Can you check if the Crabwalk server is currently running in the background and tell me which port it is bound to?"
- "OpenClaw, restart the monitoring dashboard on port 8080 and let me know when the node graph is live."
Tips & Limitations
Always prioritize network security. When sharing the access link, remember that any local network participant can view your agent's activity. If you are working on a sensitive project, ensure your network firewall is configured properly. While the tool is excellent for visualization, it does not currently support direct input control from the monitor interface—it remains a read-only observability tool. If the graph becomes cluttered, consider restarting the service to flush the local cache. For long-running tasks, use the --daemon flag to ensure your monitor persists after you close your primary terminal session.
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-luccast-public": {
"enabled": true,
"auto_update": true
}
}
}Tags(AI)
Flags: network-access, file-read