A high-availability bridge for the Agent Client Protocol (ACP) that ensures autonomous agent sessions remain functional after crashes and prevents workspace race conditions.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install firm-acp-bridge
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 firm-acp-bridge 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 Firm ACP Bridge?
Firm ACP Bridge is a technical utility designed to solve critical reliability gaps within the agent ecosystem. It provides a robust solution for managing autonomous agent sessions by implementing persistence for ACP mappings, ensuring that crashes or reboots do not lead to lost connections between IDE integrations like Cursor or VS Code and the agent backend. By adding this tool to your stack of Openclaw Skills, you ensure that your agents remain resilient and fully operational across restarts.
Beyond simple persistence, the skill addresses advanced infrastructure needs such as environment variable injection for spawned sessions and the execution of cron tasks outside of restricted sandboxes. It serves as a glue layer that makes complex, multi-agent workflows more predictable and secure by introducing advisory locking for shared workspace resources.
Firm ACP Bridge Use Cases
- Recovering active agent sessions automatically after an Orchestrator or Bridge crash to maintain IDE connectivity.
- Injecting provider API keys into autonomous sessions spawned via sessions_spawn to prevent LLM call failures.
- Scheduling deterministic cron jobs on the host session to bypass Docker sandbox denylists.
- Managing concurrent file access in shared workspaces to prevent data corruption during multi-agent collaboration.
How Firm ACP Bridge Works
- The bridge captures every ACP session creation event and immediately persists the run_id to gateway_session_key mapping using an atomic JSON write process.
- When a restart occurs, the restore tool scans the persistent store to re-establish session mappings and purge stale entries older than 24 hours.
- For autonomous spawning, the bridge intercepts the request to validate and inject required environment variables from an allowlist before the agent is initialized.
- It provides a specialized tool to schedule tasks on the main host session, allowing agents to run background scripts that would otherwise be blocked by container security policies.
- It implements an advisory locking protocol where agents check for resource availability before performing read/modify/write operations on shared files.
Firm ACP Bridge Setup
To integrate this bridge into your environment, ensure you have the core dependencies installed and the skill registered in your configuration.
# Install required SDKs and extensions
npm install @agentclientprotocol/sdk mcp-openclaw-extensions
# Add firm-acp-bridge to your agent capabilities
openclaw install firm-acp-bridge
Once installed, initialize the session restoration tool during your bridge startup sequence to recover any previous active sessions.
Firm ACP Bridge Data Schema & Taxonomy
The skill organizes its persistence and locking metadata using a zéro-dependency JSON storage strategy to ensure portability and speed.
| Metadata Component | Description | Format |
|---|---|---|
| Session Store | Maps run_id to gateway_session_key with IDE metadata | JSON (Atomic) |
| Workspace Locks | Tracks advisory locks, owners, and timestamps | JSON (Advisory) |
| Env Allowlist | Validates keys like ANTHROPIC_API_KEY and OPENCLAW_MODEL | String Array |
| Cron Registry | Stores schedules and commands for host-level execution | Crontab Format |
Firm ACP Bridge Advanced Features
- Automated health monitoring that detects bridge crashes and triggers recovery logs.
- Secure environment variable injection with internal masking to keep API keys out of logs.
- Advisory workspace locking with configurable timeouts to prevent orphan locks.
- Multi-agent environment synchronization that ensures all spawned sessions share the same provider context.
- Integration with external notification systems for monitoring the lifecycle of Openclaw Skills.
SKILL.md
Loading
Related Openclaw Skills
Firm A2A Bridge
A bridging skill that implements the A2A Protocol RC v1.0 to enable seamless communication and task management between OpenClaw agents.
Work Application Skill
A comprehensive career management tool for generating tailored CVs, scraping job listings, and tracking the entire application lifecycle.
Veille
A modular RSS aggregator for AI agents that fetches, deduplicates, and scores news articles using LLMs.
Nextcloud
A comprehensive Nextcloud integration for Openclaw Skills that enables AI agents to manage files, folders, and metadata via WebDAV and OCS APIs.
Firm Advanced Security Pack
A comprehensive security auditing toolkit designed to protect AI agent configurations from prototype pollution, secret leaks, and unauthorized execution plans.
Firm Agent Orchestration Pack
An advanced orchestration toolkit for managing multi-agent teams using Directed Acyclic Graph (DAG) task execution and real-time status monitoring.
Featured*
