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

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

1. Download the latest release from GitHub:

```bash

# 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

1. Verify the binary works:

```bash

"$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:

```bash

openclaw config set channels.discord.threadBindings.spawnAcpSessions true

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

```

1. 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

1. 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:" with your local proxy port. Also consider enabling TUN mode on your proxy client for full coverage.