Corust Agent Skill

Install and configure corust-agent-acp, an ACP-compatible coding agent by Corust AI.

When to Use

✅ USE this skill when:

• User wants to install or update corust-agent-acp
• User wants to configure corust / corust-agent in OpenClaw
• User says "install corust", "configure corust-agent", "use corust-agent-acp", or similar
• User wants to run corust-agent via ACP on Discord or other channels

❌ DON'T use this skill when:

• User is asking about other ACP agents (claude, codex, gemini)
• User is troubleshooting general ACP/acpx issues unrelated to Corust

Setup Steps

Follow these steps in order to install and configure corust-agent-acp.

Step 1: Download and Install the Binary

1. Detect the current platform and architecture:

   • macOS ARM (Apple Silicon / M1+): darwin-arm64
   • macOS Intel: darwin-amd64
   • Linux x86_64: linux-amd64
   • Linux ARM64: linux-arm64

2. Ask the user where they want to install the binary. Default: $HOME/corust.

3. Download the latest release from GitHub:

   # Example for macOS Apple Silicon
   mkdir -p "$HOME/corust"
   curl -fSL "https://github.com/Corust-ai/corust-agent-release/releases/latest/download/agent-darwin-arm64.tar.gz" \
     -o /tmp/corust-agent.tar.gz
   tar -xzf /tmp/corust-agent.tar.gz -C "$HOME/corust"
   chmod +x "$HOME/corust/corust-agent-acp"
   rm /tmp/corust-agent.tar.gz
   

   Adjust the archive name based on detected platform:

   • agent-darwin-arm64.tar.gz — macOS Apple Silicon
   • agent-darwin-amd64.tar.gz — macOS Intel
   • agent-linux-amd64.tar.gz — Linux x86_64
   • agent-linux-arm64.tar.gz — Linux ARM64

4. Verify the binary works:

   "$HOME/corust/corust-agent-acp" --version
   

Step 2: Configure acpx

Write the following to ~/.acpx/config.json (create the file and directory if they don't exist). Replace $HOME with the actual resolved home directory path.

{
  "agents": {
    "corust-agent-acp": { "command": "$HOME/corust/corust-agent-acp" }
  }
}

Important: If ~/.acpx/config.json already exists and contains other agent entries, merge the corust-agent-acp entry into the existing agents object rather than overwriting the file.

mkdir -p ~/.acpx
# Read existing config, merge, and write back

Step 3: Configure OpenClaw

Add the following configuration to ~/.openclaw/openclaw.json. Use openclaw config set commands or edit the file directly. Merge into existing config — do not overwrite unrelated sections.

ACP configuration:

{
  "acp": {
    "enabled": true,
    "dispatch": {
      "enabled": true
    },
    "backend": "acpx",
    "defaultAgent": "corust-agent-acp",
    "allowedAgents": [
      "corust-agent-acp"
    ],
    "maxConcurrentSessions": 8,
    "stream": {
      "coalesceIdleMs": 300,
      "maxChunkChars": 1200
    },
    "runtime": {
      "ttlMinutes": 120
    }
  }
}

ACPX plugin configuration:

{
  "plugins": {
    "entries": {
      "acpx": {
        "enabled": true,
        "config": {
          "permissionMode": "approve-all",
          "nonInteractivePermissions": "deny"
        }
      }
    }
  }
}

Step 4: Tell the User How to Configure Discord

After completing the above steps, instruct the user on Discord setup. Do NOT run these commands automatically — only tell the user what to do.

Provide the following instructions:

Discord Configuration

1. Enable ACP thread spawning and open DM access:

   openclaw config set channels.discord.threadBindings.spawnAcpSessions true
   openclaw config set channels.discord.allowFrom '["*"]'
   

2. Enable thread creation permissions in Discord:

   Go to your Discord server → channel settings → Permissions, and ensure the bot role has:

   • Create Public Threads — enabled
   • Create Private Threads — enabled
   • Send Messages in Threads — enabled

3. Start using Corust Agent:

   In any text channel, mention the bot and say:

   @Bot run corust

   The bot will spawn a corust-agent-acp session in a new thread and begin working on your task.

Troubleshooting

• "acpx command not found": Ensure the ACPX plugin is enabled and the gateway has been restarted after configuration changes.
• Agent binary not found: Verify the path in ~/.acpx/config.json points to the correct binary location and the file is executable (chmod +x).
• Discord "Not authorized": Run openclaw config set channels.discord.allowFrom '["*"]' and restart the gateway.
• Network issues (proxy): If Discord connections fail, set openclaw config set channels.discord.proxy "http://127.0.0.1:\x3Cport>" with your local proxy port. Also consider enabling TUN mode on your proxy client for full coverage.