Keybindings Customizer for Openclaw

A specialized utility for safely managing, rebinding, and customizing keyboard shortcuts within the Claude Code environment.

wimi321
v1.0.0
Apr 2, 2026
0
602
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install keybindings-customizer

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install keybindings-customizer 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 Keybindings Customizer?

The Keybindings Customizer is a developer-centric utility designed to streamline how you interact with your AI coding assistant. By providing a safe interface for editing the configuration file located at ~/.claude/keybindings.json, this Openclaw Skills integration ensures that you can create complex key chords and rebind essential shortcuts without the risk of overwriting your entire configuration. It prioritizes the preservation of existing settings while maintaining full compatibility with the required JSON schema.

Using this skill allows developers to tailor their terminal-based coding experience to their specific ergonomic needs. Whether you are resolving conflicts with your terminal emulator or optimizing for speed, this tool provides the surgical precision needed to modify keymaps without clobbering unrelated data or breaking the configuration structure.

Keybindings Customizer Use Cases

  • Rebinding the external editor shortcut to match your local development environment.
  • Creating multi-key chords to toggle specific features like todo lists or AI search.
  • Unbinding default shortcuts that conflict with OS-level or terminal-level commands.
  • Consolidating custom keybinding sets while ensuring schema integrity.

How Keybindings Customizer Works

  1. Accesses and reads the existing keybindings configuration file to understand current mappings.
  2. Merges user-requested changes into the existing JSON structure rather than performing a destructive full replacement.
  3. Validates the new keybindings against a list of reserved and non-rebindable shortcuts to prevent terminal-level failures.
  4. Preserves all metadata, including schema references and documentation fields, within the configuration file.
  5. Reports any logical conflicts or OS-level limitations back to the user before finalizing the save operation.

Keybindings Customizer Setup

To utilize this skill within your Openclaw Skills environment, ensure your AI agent has the necessary permissions to read and write to your local configuration directory.

# Ensure the configuration directory exists
mkdir -p ~/.claude

# The skill will automatically target and manage:
# ~/.claude/keybindings.json

Keybindings Customizer Data Schema & Taxonomy

The skill interacts specifically with the Claude Code configuration format, ensuring that the JSON structure follows the official requirements for Openclaw Skills ecosystem components.

Field Description
key The specific key combination or chord (e.g., ctrl+k).
command The internal function or action triggered by the key combination.
schema Metadata defining the structure and validation rules for the file.
docs Internal documentation strings maintained within the JSON file.

Keybindings Customizer Advanced Features

  • Intelligent merging logic that prevents data loss during partial updates to the configuration.
  • Proactive conflict detection for OS-reserved shortcuts and terminal escape sequences.
  • Support for complex key chords to extend functionality without cluttering basic shortcuts.
  • Automatic preservation of schema definitions to ensure continued editor support and validation.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*