A professional CLI toolset for connecting to remote Agent Client Protocol (ACP) servers to execute commands and manage agent sessions via WebSockets.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install acp-remote
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 acp-remote 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 ACP Remote?
ACP Remote is a specialized integration designed to bridge local development environments with remote Agent Client Protocol servers. By utilizing the imclaw-cli, this skill enables developers to send prompts, execute shell commands, and manage stateful agent sessions across network boundaries. It is an essential component for users of Openclaw Skills who need to leverage distributed AI agents or manage infrastructure remotely through a standardized protocol.
The skill provides a robust interface for interacting with various agent models, such as Claude or Codex, hosted on remote servers. It supports secure communication via authentication tokens and can be easily tunneled through SSH for added security, making it a flexible solution for both local testing and production-grade agent orchestration.
ACP Remote Use Cases
- Running diagnostic shell commands like df -h or top on remote production servers.
- Conducting remote codebase analysis and code improvement suggestions without local cloning.
- Automating routine server maintenance tasks through an AI agent interface.
- Integrating remote agent capabilities into local automated workflows and CI/CD pipelines.
How ACP Remote Works
- The user establishes a WebSocket connection to a remote ACP server using the imclaw-cli and providing necessary authentication tokens.
- Commands or prompts are dispatched from the local terminal to the remote agent server.
- The remote agent processes the request, utilizing defined tools like Bash or file system access based on configured permissions.
- The server streams the agent's response and tool outputs back to the local client in real-time.
- For multi-turn interactions, the skill manages session IDs to maintain context across multiple command executions.
ACP Remote Setup
# Install acpx for ACP protocol support
if ! command -v acpx &> /dev/null; then
npm install -g acpx@latest
fi
# Install imclaw-cli via official script
if ! command -v imclaw-cli &> /dev/null; then
curl -fsSL https://raw.githubusercontent.com/smallnest/imclaw/main/scripts/install.sh | bash
fi
# Set environment variables for convenience
export IMCLAW_SERVER="ws://your-server:8080/ws"
export IMCLAW_TOKEN="your-secret-token"
# Verify the installation
imclaw-cli --help
ACP Remote Data Schema & Taxonomy
The skill manages interaction data through specific CLI flags and environment variables to ensure consistent communication with the ACP server.
| Parameter | Description | Default |
|---|---|---|
--server |
The WebSocket URL of the remote ACP server | ws://localhost:8080/ws |
--token |
Authentication token for secure server access | "" |
--session |
Unique ID to continue a specific agent conversation | N/A |
--agent |
The type of agent to invoke (e.g., claude, codex) | claude |
--format |
Output style: text, json, or quiet | text |
--cwd |
The working directory for the agent on the remote host | N/A |
ACP Remote Advanced Features
- Session Persistence: Reuse session IDs to maintain long-running conversations with remote agents.
- Granular Permissions: Control agent actions using flags like --approve-reads, --approve-all, or --deny-all.
- Tool Restricting: Limit the agent's capabilities to specific functions using the --allowed-tools parameter.
- Output Parsing: Utilize --format json for seamless integration with other CLI tools and automated scripts.
- Secure Tunneling: Compatible with SSH tunnels for accessing remote servers behind restrictive firewalls.
SKILL.md
Loading
Related Openclaw Skills
Welding Basics
A specialized AI agent skill designed to bridge the gap between digital planning and physical metal fabrication, turning you into a proficient welder in 14 days.
Mapbox MCP Runtime Patterns
A technical implementation guide for connecting AI agents to Mapbox geospatial tools using the Model Context Protocol.
RAIGO × OWASP LLM Top 10
A comprehensive security enforcement skill that applies official OWASP LLM Top 10 (2025) rules to AI agents for proactive risk mitigation.
Kubernetes YAML Connect
A powerful automation bridge that enables AI agents to apply, validate, and manage Kubernetes resources via YAML configuration files.
Competitive Intelligence Skill
A sophisticated market research tool for AI agents that utilizes live web scraping to provide real-time competitive insights and strategic signals.
PRD Development
A strategic requirement engineering skill that converts raw product concepts into structured, developer-ready documentation.
Featured*
