sirtimbly/openclaw
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
master
openclaw/kids-instance/README.md

2.6 KiB
Raw Permalink Blame History

OpenClaw Kids Instance

A locked-down, sandboxed OpenClaw instance for your child.

🔒 Safety Features

  • Sandboxed tools — all execution happens in Docker containers
  • No file writes — read-only access to workspace
  • No shell access — can't run commands on the host
  • No browser control — can't drive a browser
  • No config changes — can't modify OpenClaw settings
  • DM pairing required — you approve all contacts
  • Group mention-only — won't respond unless @mentioned in groups

🚀 Setup

  1. Change the auth token in config/openclaw-kids.json:

    "token": "your-long-random-string-here"

  2. Start the instance:

    docker-compose -f docker-compose.kids.yml up -d

  3. Connect via Control UI:

  4. Set up messaging (optional):

    • WhatsApp: Scan QR code in Control UI
    • Telegram: Create bot via @BotFather, add token to config

  5. Customize:

    • Edit workspace-kids/IDENTITY.md — let your son name the bot!
    • Edit workspace-kids/SOUL.md — adjust personality as needed

🛡️ What's Allowed

  • ✅ Chatting and asking questions
  • ✅ Reading files in the workspace
  • ✅ Web search (with safe content filters)
  • ✅ Using messaging with approved contacts

🚫 What's Blocked

  • ❌ Running shell commands
  • ❌ Writing files
  • ❌ Browsing the web interactively
  • ❌ Creating scheduled tasks
  • ❌ Accessing your main OpenClaw instance
  • ❌ Modifying configuration

📁 Directory Structure

kids-instance/
├── docker-compose.kids.yml    # Docker setup
├── config/
│   └── openclaw-kids.json     # Main config
├── workspace-kids/            # Agent workspace
│   ├── SOUL.md                # Personality
│   ├── IDENTITY.md            # Name/emoji
│   └── ...                    # Other files
└── state/                     # Runtime state (created on first run)

🔄 Updating

docker-compose -f docker-compose.kids.yml pull
docker-compose -f docker-compose.kids.yml up -d

📝 Notes

  • Runs on port 18790 (different from default 18789)
  • Uses separate Docker network openclaw-kids
  • Completely isolated from your main OpenClaw instance
  • All activity is logged in state/ for review

🎨 Customization Ideas

  • Let your son design the bot's personality in SOUL.md
  • Add fun facts or daily challenges in HEARTBEAT.md
  • Create a todo.md for homework or chores
  • Set up a separate WhatsApp number just for the bot