A specialized skill for diagnosing acpx connection timeouts, fixing ACP protocol errors, and correctly configuring multiple Feishu bot accounts.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install acpx-bridge-troubleshooting-guide
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 acpx-bridge-troubleshooting-guide 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 acpx Bridge Troubleshooting & Feishu Multi-Account Config?
The acpx Bridge Troubleshooting guide is an essential resource within the Openclaw Skills ecosystem designed to solve complex connectivity issues between the acpx bridge and the OpenClaw Gateway. It specifically targets common pain points such as initialization hangups, WebSocket 1005 errors, and ACP protocol parsing failures that occur when connecting AI agents like Claude Code to different backends.
Beyond troubleshooting, this skill provides a standardized framework for managing multiple Feishu accounts. By utilizing a structured approach to account management rather than creating redundant channels, developers can ensure cleaner routing and more stable bot deployments. It emphasizes using native CLI tools over manual JSON manipulation to maintain configuration integrity.
acpx Bridge Troubleshooting & Feishu Multi-Account Config Use Cases
- Resolving acpx connection timeouts during the initialize phase of the Gateway handshake.
- Configuring multiple Feishu robots to connect to different AI backends simultaneously.
- Debugging WebSocket 1005 errors and ACP protocol parsing failures in persistent mode.
- Safely updating OpenClaw configurations without risking JSON formatting errors caused by manual edits.
How acpx Bridge Troubleshooting & Feishu Multi-Account Config Works
- Token Validation: Verifies the existence of the gateway.token file in the ~/.openclaw directory to ensure successful authentication.
- Configuration Alignment: Updates the ~/.acpx/config.json to point to the correct openclaw acp client entry points without redundant parameters.
- Version Synchronization: Ensures acpx is updated to the latest version (0.4.0+) to leverage recent bug fixes in the ACP protocol handler.
- Structured Multi-Accounting: Implements additional Feishu accounts under the existing channels.feishu.accounts schema for proper routing.
- Validation & Restart: Runs the openclaw doctor diagnostic and restarts the Gateway to apply all changes globally.
acpx Bridge Troubleshooting & Feishu Multi-Account Config Setup
First, ensure your environment meets the prerequisites (Node.js installed, Gateway running on port 18789). Then, follow these steps:
# 1. Update acpx to the latest version
npm install -g acpx@latest
# 2. Create the gateway token file if missing
echo "your_gateway_token" > ~/.openclaw/gateway.token
# 3. Configure a secondary Feishu account safely
openclaw config set 'channels.feishu.accounts.claude' '{"appId":"cli_xxx","appSecret":"xxx","domain":"feishu","connectionMode":"websocket"}'
# 4. Validate and restart
openclaw config validate
openclaw gateway restart
acpx Bridge Troubleshooting & Feishu Multi-Account Config Data Schema & Taxonomy
The skill manages configuration across three primary file locations to maintain system state:
| File Path | Description | Key Components |
|---|---|---|
~/.openclaw/gateway.token |
Authentication | Plaintext API token for Gateway access |
~/.openclaw/openclaw.json |
Main Config | Feishu accounts, agent bindings, and ACP settings |
~/.acpx/config.json |
Bridge Config | Agent definitions, command arguments, and timeout settings |
It utilizes a hierarchical accounts structure within the Feishu channel to prevent routing conflicts.
acpx Bridge Troubleshooting & Feishu Multi-Account Config Advanced Features
- Automated Diagnostics: Includes scripts like
diagnose_acpx.shto quickly identify protocol mismatches. - CLI-First Configuration: Leverages
openclaw config setto prevent the common pitfalls of direct JSON manipulation with jq. - Persistent ACP Mode: Supports persistent connection modes for AI agents to reduce handshake overhead.
- Multi-Agent Routing: Provides templates for binding specific agent IDs to unique account IDs within the Feishu ecosystem.
SKILL.md
Loading
Related Openclaw Skills
ClawHub Domestic Mirror Configurator
Accelerate your Openclaw Skills installation by switching ClawHub to high-speed domestic mirror registries.
Novel Director
A professional-grade AI novel director tool designed for high-context, multi-chapter storytelling and interactive plot management.
Global Tax Guide
A comprehensive compliance mapping tool for ecommerce sellers to navigate global VAT, GST, and sales tax obligations across multiple jurisdictions.
InfoSeek Deep Web Search & Archival
A professional-grade information gathering skill that automates deep web searches across multiple engines, deduplicates results via SQLite, and archives content with rich metadata.
ACPX Bridge Troubleshooting
A technical diagnostic toolkit for fixing connection, timeout, and authentication issues between acpx and the OpenClaw Gateway.
ClawHub Mirror & Multi Search Engine Setup
A specialized utility for configuring high-speed domestic mirrors to install Openclaw Skills and deploying a comprehensive 17-engine search tool.
Featured*
