Sign inSign up

okjodom/aiders

By okjodom

Updated 6 months ago

Image
0

2.4K

okjodom/aiders repository overview

AIDERS

A multi-tenant platform for deploying and managing OpenClaw AI agents on DigitalOcean, built with Next.js and Stack Auth. AIDERS enables teams to provision, monitor, and control OpenClaw instances from a unified dashboard.

Features

OpenClaw Agent Management
  • One-Click Deployment: Provision OpenClaw agents on DigitalOcean droplets with cloud-init automation
  • Lifecycle Controls: Start, stop, reboot, and destroy agents from the dashboard
  • Real-Time Monitoring: Track agent status, view action history, and inspect configuration
  • LLM Provider Support: Deploy agents with Anthropic (Claude) or OpenAI (GPT) — bring your own API key
Multi-Tenancy
  • Team Management: Create and manage multiple teams powered by Stack Auth
  • Role-Based Permissions: Team admins configure DigitalOcean credentials, all members can deploy and manage agents
  • Team Isolation: Each team's credentials, agents, and configuration are completely isolated
Tech Stack
  • Next.js 16 with App Router
  • TypeScript with strict mode
  • Tailwind CSS & Shadcn UI components
  • Stack Auth for authentication and team management
  • DigitalOcean API for droplet provisioning
  • OpenClaw as the deployed AI agent framework
  • Dark mode support

Getting Started

  1. Clone the repository

    git clone https://github.com/okjodom/aiders.git
    cd aiders
    
  2. Install dependencies

    npm install
    
  3. Register an account on Stack Auth, copy the keys from the dashboard, and paste them into .env.local. Then enable "client team creation" on the team settings tab.

    cp .env.local.example .env.local
    

    Required variables:

    • NEXT_PUBLIC_STACK_PROJECT_ID
    • NEXT_PUBLIC_STACK_PUBLISHABLE_CLIENT_KEY
    • STACK_SECRET_SERVER_KEY
  4. Start the development server and go to http://localhost:3030

    npm run dev
    
With Docker
npm run dcu

Usage

  1. Create a team in the dashboard
  2. Configure DigitalOcean — navigate to Settings, enter your DO API token, and test the connection
  3. Deploy an agent — go to Agents, click "Create Agent", choose a name, LLM provider, API key, region, and size
  4. Manage agents — start, stop, reboot, or destroy agents from the agent detail page
  5. Monitor — view status, IP address, action history, and configuration for each agent

Project Structure

app/
  (landing-page)/        # Public landing page
  dashboard/             # Protected dashboard pages
    [teamId]/
      agents/            # Agent list and detail pages
      settings/          # Team DO configuration
  api/team/[teamId]/
    agents/              # Agent CRUD and actions
    config/              # DO config, regions, sizes
components/              # UI components (agent cards, status, config)
lib/
  digitalocean/          # DO API client and cloud-init generator
  storage/               # Team metadata storage layer
  types/                 # TypeScript type definitions

API Endpoints

RouteMethodsAuthPurpose
/api/team/[teamId]/configGET, POSTadminDO configuration
/api/team/[teamId]/config/testPOSTadminTest DO token
/api/team/[teamId]/config/regionsGETmemberList DO regions
/api/team/[teamId]/config/sizesGETmemberList DO sizes
/api/team/[teamId]/agentsGET, POSTmemberList / create agents
/api/team/[teamId]/agents/[agentId]GET, DELETEmemberAgent detail / destroy
/api/team/[teamId]/agents/[agentId]/actionsPOSTmemberpower_on, power_off, reboot
/api/team/[teamId]/agents/[agentId]/logsGETmemberDroplet action history
  • OpenClaw — Open-source AI assistant gateway for messaging platforms
  • Stack Auth — Open-source authentication and team management
  • Shadcn UI — Re-usable component library
  • Next.js — React framework for production

License

MIT

Tag summary

Content type

Image

Digest

sha256:1e4be5022

Size

77.2 MB

Last updated

6 months ago

docker pull okjodom/aiders