IronClaws Kit

Scaffold an IronClaws AI agent platform in under 5 minutes.

npx create-ironclaws my-workspace

The wizard walks you through Slack tokens, LiteLLM gateway, and your first agent's channel. It then starts OneCLI, registers credentials, builds the container image, and optionally starts IronClaws. Send @Forge hello and your guide agent responds.

What you get

Your first agent is Forge — a built-in guide that knows how IronClaws works and can help you build new agents directly from Slack. Ask it anything:

@Forge how do I add a new agent? @Forge explain how credentials work @Forge build me an agent that monitors Jira

Adding more agents

Via Forge (recommended)

Just describe what you want in Slack. Forge will draft the CLAUDE.md, show you the agents.yaml and .env entries, and tell you to restart.

Manually

1. Write the agent's identity — create groups/my-agent/CLAUDE.md:

# My Agent

What this agent does in one sentence.

## What you do
Responsibilities.

## How to respond
Tone, format, constraints.

2. Register it — add to agents.yaml:

  - folder: my-agent
    name: "My Agent"
    trigger: "@Argus"
    channel_env: MY_AGENT_CHANNEL_ID
    requires_trigger: false
    onecli_secrets: [litellm]
    onecli_id: <python3 -c "import uuid; print(uuid.uuid4())">

3. Set the channel — add to .env:

MY_AGENT_CHANNEL_ID=C...

4. Restart IronClaws — the agent auto-registers, its channel is added to the allowlist, and it's live.

Giving agents tools and credentials

Edit agent-credentials.yaml to control what each agent can access:

agents:
  my-agent:
    skills: []
    tools: [jira_tool.py]       # Python tools from container/tools/
    config:
      - JIRA_BASE_URL           # non-secret config from .env

For service credentials (Jira, Slack, etc.) add them to onecli_secrets in agents.yaml. OneCLI injects them as Authorization headers — agents never see the raw keys.

Requirements

• Node.js 18+
• Docker
• A Slack app with Socket Mode and a bot token
• A LiteLLM gateway (or Anthropic API access)

Manual setup (without the wizard)

git clone https://github.com/ardoq/ironclaws-kit my-workspace
cd my-workspace
cp .env.example .env          # fill in your values
docker compose up -d          # start OneCLI infrastructure
npm ci
cd container && ./build.sh && ./build-argus.sh && cd ..
npm run dev

Production note

Network enforcement (iptables) is Linux-only. On macOS/Windows dev machines, agents have unrestricted outbound access. Deploy on Linux for production.