Picoclaw for Cloudron

This package runs the upstream PicoClaw 0.3.1 launcher on Cloudron.

What This Package Does

• Exposes the upstream browser launcher as the main Cloudron app.
• Keeps PicoClaw data in /app/data/.picoclaw.
• Lets the launcher manage the picoclaw gateway subprocess the way upstream expects.
• Keeps terminal access available for picoclaw agent, picoclaw skills, and other CLI commands.

Runtime Layout

• Main config: /app/data/.picoclaw/config.json
• Sensitive values: /app/data/.picoclaw/.security.yml
• Launcher settings: /app/data/.picoclaw/launcher-config.json
• Workspace: /app/data/.picoclaw/workspace

First Run

1. Open the app in your browser.
2. Create the launcher password on /launcher-setup.
3. Configure at least one usable model.
4. Once the default model is valid, the launcher can start and manage the gateway.

Terminal Commands

The Cloudron web terminal remains useful for direct CLI access:

picoclaw agent -m "Summarize this repository"
picoclaw skills list
picoclaw skills install <skill>

Telegram Helper

simple_telegram_bot.py has been reworked into a PicoClaw 0.3.1 Telegram configuration helper. It updates the channel_list.telegram.settings structure used by current upstream releases.

Example:

python3 /app/code/simple_telegram_bot.py --token YOUR_BOT_TOKEN --allow-from YOUR_USER_ID

Use --help for the full option set.

Notes

• The Cloudron app serves the launcher on port 18800.
• The managed gateway continues to use its own internal port, following upstream defaults.
• Native picoclaw skills support is used directly; no legacy wrapper is kept.