setup-automatik

使用 Setup Automatik 引擎（由 Orion Design 提供支持）促进 VPS 解决方案的安装和管理。当用户想要在 Linux VPS 上安装、配置或管理 Traefik、Portainer、Chatwoot、N8N 和其他开源应用程序等工具时使用。

# Setup Automatik

## Credits & Acknowledgements
Special thanks to **Orion Design** for providing the original `SetupOrion.sh` script.

**Developers:**
- **Alltomatos**
- **Rafa Martins**
- **Robot 🤖** (Seu mentor assistente)

This skill is part of the **Mundo Automatik** ecosystem.

- **Website:** [mundoautomatik.com](https://mundoautomatik.com/)
- **Community (WhatsApp):** [links.mundoautomatik.com/automatik-brasil](https://links.mundoautomatik.com/automatik-brasil)
- **Telegram:** [t.me/mundoautomatik](https://t.me/mundoautomatik)
- **YouTube:** [@mundoautomatik](https://www.youtube.com/@mundoautomatik)

## Overview
The `setup-automatik` skill is designed to assist in deploying various open-source solutions on a VPS (Virtual Private Server). It leverages the `assets/SetupOrion.sh` script to automate the installation of containers, databases, and application stacks.

## Available Tools
A wide range of tools are available for installation, categorized by their purpose:
- **Infrastructure**: Traefik, Portainer, PostgreSQL, MongoDB, RabbitMQ, etc.
- **Automation & AI**: N8N, Flowise, Typebot, Dify AI, Ollama, Langflow, etc.
- **Communication**: Chatwoot, Evolution API, Uno API, Mautic, Mattermost, etc.
- **Business & Utilities**: Wordpress, Baserow, Metabase, Odoo, NextCloud, etc.

For a full list of supported tools, refer to [tools.md](references/tools.md).

## Prerequisites

### 🔐 Granting Agent Access
For the agent to perform installations on your VPS, you must provide access. There are two ways to do this:

#### Option 1: OpenClaw Node Pairing (Recommended)
This is the most secure and native way. It allows the agent to execute commands directly on your VPS terminal.
1. Run the installer on your VPS: `curl -fsSL https://get.openclaw.ai | sh`
2. Start the pairing process: `openclaw node pair`
3. Paste the resulting pairing code or command here in the chat.

#### Option 2: SSH Access
Provide the agent with your VPS connection details:
- Public IP Address
- Username (usually `root`)
- SSH Password OR Private Key

## Workflow

### 0. Access Setup
Before starting, ensure the agent has access using one of the methods in the [Prerequisites](#prerequisites) section.

### 1. Preparation
Ensure the VPS is running a compatible Linux distribution (preferably Ubuntu/Debian) and has Docker installed.

### 2. Information Gathering
Before installation, gather necessary information:
- Domain names (for SSL/Traefik).
- Database credentials.
- SMTP details for email notifications.

### 3. Installation
To install a tool, the agent uses the `assets/SetupOrion.sh` script. The skill can extract specific installation blocks or execute the script directly in non-interactive mode when possible.

### 4. Verification
After installation, verify that the services are running:
- Check `docker ps`.
- Access the web interface of the installed tool.
- Check logs if any issues arise.

## Common Tasks

### Install Traefik & Portainer
This is usually the first step to manage other stacks.
1. Run the script and select option `01`.
2. Follow prompts for domain and email.

### Deploy a Stack (e.g., N8N)
1. Ensure Traefik is running.
2. Select the tool from the menu.
3. Provide the required subdomains.

## References
- [tools.md](references/tools.md): Comprehensive list of available tools.
- [SetupOrion.sh](assets/SetupOrion.sh): The main installation script.

---

## 中文说明

# Setup Automatik

## 致谢与鸣谢
特别感谢 **Orion Design** 提供原始的 `SetupOrion.sh` 脚本。

**开发者：**
- **Alltomatos**
- **Rafa Martins**
- **Robot 🤖** (Seu mentor assistente)

此技能是 **Mundo Automatik** 生态系统的一部分。

- **网站：** [mundoautomatik.com](https://mundoautomatik.com/)
- **社区（WhatsApp）：** [links.mundoautomatik.com/automatik-brasil](https://links.mundoautomatik.com/automatik-brasil)
- **Telegram：** [t.me/mundoautomatik](https://t.me/mundoautomatik)
- **YouTube：** [@mundoautomatik](https://www.youtube.com/@mundoautomatik)

## 概述
`setup-automatik` 技能旨在协助在 VPS（虚拟专用服务器）上部署各种开源解决方案。它利用 `assets/SetupOrion.sh` 脚本来自动安装容器、数据库和应用栈。

## 可用工具
提供了一系列工具用于安装，按用途分类：
- **基础设施**：Traefik、Portainer、PostgreSQL、MongoDB、RabbitMQ 等。
- **自动化与 AI**：N8N、Flowise、Typebot、Dify AI、Ollama、Langflow 等。
- **通信**：Chatwoot、Evolution API、Uno API、Mautic、Mattermost 等。
- **业务与实用工具**：Wordpress、Baserow、Metabase、Odoo、NextCloud 等。

完整的受支持工具列表，请参阅 [tools.md](references/tools.md)。

## 前置条件

### 🔐 授予代理访问权限
为了让代理在你的 VPS 上执行安装，你必须提供访问权限。有两种方式：

#### 方式 1：OpenClaw 节点配对（推荐）
这是最安全、最原生的方式。它允许代理直接在你的 VPS 终端上执行命令。
1. 在你的 VPS 上运行安装程序：`curl -fsSL https://get.openclaw.ai | sh`
2. 启动配对流程：`openclaw node pair`
3. 将生成的配对代码或命令粘贴到此处的聊天中。

#### 方式 2：SSH 访问
向代理提供你的 VPS 连接详情：
- 公网 IP 地址
- 用户名（通常为 `root`）
- SSH 密码或私钥

## 工作流程

### 0. 访问设置
开始之前，请确保代理已使用[前置条件](#prerequisites)部分中的某种方法获得访问权限。

### 1. 准备
确保 VPS 运行兼容的 Linux 发行版（最好是 Ubuntu/Debian）并已安装 Docker。

### 2. 信息收集
安装前，收集必要的信息：
- 域名（用于 SSL/Traefik）。
- 数据库凭据。
- 用于电子邮件通知的 SMTP 详情。

### 3. 安装
要安装某个工具，代理会使用 `assets/SetupOrion.sh` 脚本。该技能可以提取特定的安装块，或在可能时以非交互模式直接执行脚本。

### 4. 验证
安装后，验证服务是否正在运行：
- 检查 `docker ps`。
- 访问已安装工具的 Web 界面。
- 如出现任何问题，检查日志。

## 常见任务

### 安装 Traefik 和 Portainer
这通常是管理其他栈的第一步。
1. 运行脚本并选择选项 `01`。
2. 按提示输入域名和电子邮件。

### 部署一个栈（例如 N8N）
1. 确保 Traefik 正在运行。
2. 从菜单中选择工具。
3. 提供所需的子域名。

## 参考资料
- [tools.md](references/tools.md)：可用工具的完整列表。
- [SetupOrion.sh](assets/SetupOrion.sh)：主安装脚本。