agentCLAWHUBUnverified

KWDB Install Deploy

Triggered when the user wants to install or deploy KaiwuDB (kwdb, kaiwudb). Helps users complete script-based deployment of KaiwuDB clusters, including configuration file modification, installation command execution, cluster initialization, and status checks.

OpenClaw

Rank

62

Safety

84

Downloads

1.2k

Updated

Oct 11, 2026

Version

1.2.1

Source

CLAWHUB

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 1.2K downloads reported by the source. Last updated 10/11/2026.

Avoid when

  • Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Public facts

Every fact links back to the source it came from.

Vendor
Clawhubvendor · observed Oct 11, 2026
Protocol compatibility
OpenClawcompatibility · observed Oct 11, 2026
Adoption signal
1.2K downloadsadoption · observed Oct 11, 2026
Latest release
1.2.1release · observed Aug 28, 2026
Handshake status
UNKNOWNsecurity

Install and run

Setup complexity: medium.

clawhub skill install s17e2f9k2hwm2p7q50y9wz03fs8445dh:kwdb-install-deploy
  1. Install using `clawhub skill install s17e2f9k2hwm2p7q50y9wz03fs8445dh:kwdb-install-deploy` in an isolated environment before connecting it to live workloads.
  2. No published capability contract is available yet, so validate auth and request/response behavior manually.
  3. Review the upstream CLAWHUB listing at https://clawhub.ai/kwdb/kwdb-install-deploy before using production credentials.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-kwdb-kwdb-install-deploy/snapshot"

Documentation

CLAWHUB

86,295 characters of source documentation, loaded on request.

Extracted files

5 files captured from the source.

SKILL.md

---
name: kwdb-install-deploy
description: Triggered when the user wants to install or deploy KaiwuDB (kwdb, kaiwudb). Helps users complete script-based deployment of KaiwuDB clusters, including configuration file modification, installation command execution, cluster initialization, and status checks.
---

# KWDB Install

## Overview

This skill provides script-based deployment for KaiwuDB, suitable for bare-metal or container deployment in Linux environments. Supports single-replica and multi-replica cluster deployments with complete deployment workflow guidance.

## Mandatory Rules

**The following three rules must be strictly followed:**

### 1. Prohibit Guessing Installation Parameters

**Do not guess or assume any installation parameters and proceed with installation unless explicitly specified by the user.**

- All configuration parameters (ports, IPs, data directories, security modes, etc.) must be confirmed with the user one by one
- Even if the user says "use defaults", the default values must be explicitly listed and confirmed with the user
- The installation package path must be explicitly provided by the user and must not be guessed

### 2. Must Read Logs on Installation Failure

**When the installation command fails, you must read the log files in the `log/` directory under the same path as the installation script to obtain detailed failure information.**

Log file path: `/opt/kaiwudb/<package-name>/log/` or `kaiwudb_install/log/`

```bash
# After installation failure, first read the logs
ls -la log/
cat log/install.log  # or the latest generated log file
```

### 3. Exit After Reporting Failure, Prohibit Arbitrary Retries

**After installation failure, you must:**
1. Clearly display the error information obtained from the logs to the user
2. Explain possible causes
3. Exit the installation process, **do not retry on your own**
4. Wait for user instructions before deciding on the next step

**Exception**: Only when the user explicitly requests "retry", you may execute the installation command again.

## Prerequisites

### System Requirements

- **Hardware**:
  - Memory: At least 8 GB RAM (16 GB recommended)
  - CPU: At least 2 cores (4 cores recommended)
  - Disk: At least 50 GB available space (SSD recommended)
- **Operating System**:
  - CentOS 7/8
  - Ubuntu 18.04/20.04/22.04
- **Network**: All nodes must have network connectivity

### User Permissions

- SSH passwordless login configured between nodes
- User must be `root` or have `sudo` privileges
- For container deployment, non-root users must be in the `docker` group

## Deployment Steps

### Step 1: Confirm Deployment Mode

First, I need to confirm the deployment mode you need:

**Ask**:
"Please select the deployment mode: single-node deployment (single) or cluster deployment (cluster)?"

### Step 1.1: Confirm Cluster Replica Count - Cluster Mode Only

If cluster deployment is selected, I need to further confirm the number of replicas:

**Ask**:
"Please select the cluster dep

_meta.json

{
  "ownerId": "kn7fr8q8f22jd6gzb6f7prf9g183z64v",
  "slug": "kwdb-install-deploy",
  "version": "1.2.1",
  "publishedAt": 1787878034321
}

references/installation_guide.md

# KaiwuDB Script Deployment Guide

## Prerequisites

### System Requirements

- Hardware, operating system, and software dependencies of all nodes to be deployed must meet the installation and deployment requirements.
- **Network Settings**:
  - Network connectivity between all nodes.
  - Nodes are located within the same data center.
  - Network latency between physical machines is no higher than 50 ms.
  - Clock difference between nodes is no greater than 500 ms.
  - Required ports for KaiwuDB service have been reserved on each node.
- KaiwuDB bare-metal or container installation package for the corresponding system version has been obtained.

### User Permissions

- SSH passwordless login is configured between the current node and other nodes in the cluster.
- The installation user is the `root` user or a regular user with `sudo` privileges.
- When deploying with the container installation package, if the installation user is a non-`root` user, add the user to the `docker` group by running `sudo usermod -aG docker $USER`.

## Deployment Steps

### Step 1: Confirm Deployment Mode

First, confirm the deployment mode:

**Ask**:
"Please select the deployment mode: single-node deployment (single) or cluster deployment (cluster)?"

### Step 1.1: Confirm Cluster Replica Count - Cluster Mode Only

If cluster deployment is selected, further confirm the number of replicas:

**Ask**:
"Please select the cluster deployment type: single-replica cluster (single-replica) or multi-replica cluster (multi-replica)?"

### Step 2: Confirm Installation Package Location

Provide the full path of the installation package, including the filename, for example:
```
/path/to/KaiwuDB-1.0.0.tar.gz
```

### Step 3: Extract Installation Package

```bash
# Create installation directory
sudo mkdir -p /opt/kaiwudb

# Extract installation package
tar -xzf "$INSTALL_PACKAGE_PATH" -C /opt/kaiwudb

# Enter installation directory
cd /opt/kaiwudb/$(basename "$INSTALL_PACKAGE_PATH" .tar.gz)
```

### Step 4: Configure deploy.cfg File

I will ask you about each configuration item step by step according to the deployment mode you selected, and then modify the `deploy.cfg` configuration file based on your answers.

#### Global Configuration (global) - Common to All Modes

1. **Security Mode (secure_mode)**:
   - Select the security mode: insecure (non-secure mode), tls (TLS secure mode, default), tlcp (TLCP secure mode)

2. **Management User (management_user)**:
   - Enter the KaiwuDB management username (default: kaiwudb)

3. **RESTful Port (rest_port)**:
   - Enter the KaiwuDB Web service port (default: 8080)

4. **KaiwuDB Service Port (kaiwudb_port)**:
   - Enter the KaiwuDB service port (default: 26257)

5. **BRPC Port (brpc_port)**:
   - Enter the KaiwuDB time-series engine communication port (default: 27257)

6. **Data Directory (data_root)**:
   - Enter the KaiwuDB data storage directory (default: /var/lib/kaiwudb)

7. **CPU Resource Usage (cpu)**:
   - Enter the proportion of CPU 

references/troubleshooting.md

# KaiwuDB Common Issues and Solutions

## Installation Issues

### 1. Environment Check Failure

**Problem**: Script prompts environment check failure

**Solution**:
- Check if system requirements are met (memory, disk space)
- Ensure the user running the script has sufficient permissions
- Check if network connection is normal

### 2. Dependency Installation Failure

**Problem**: Error occurs during dependency installation

**Solution**:
- Check if system package manager is working normally (yum/apt)
- Try manually updating package manager:
  - CentOS: `sudo yum update -y`
  - Ubuntu: `sudo apt-get update -y`
- If network is slow, consider using domestic mirror sources

### 3. Installation Package Download Failure

**Problem**: Unable to download KaiwuDB installation package

**Solution**:
- Check network connection
- Try manually downloading the installation package and placing it in the scripts/ directory
- Contact technical support to obtain download link

## Runtime Issues

### 1. Database Cannot Start

**Problem**: No response after executing start command

**Solution**:
- Check data directory permissions: `ls -ld /var/lib/kwdb`
- Check log files: `cat /var/log/kwdb/kwdb.log`
- Check if configuration file is correct

### 2. Unable to Connect to Database

**Problem**: Cannot connect to database using psql command

**Solution**:
- Check if kwdb process is running: `ps aux | grep kwdb`
- Check if firewall allows port 5432 access
- Check if listen_addresses configuration is set to '*'
- Check if pg_hba.conf file allows connections

### 3. Database Running Slowly

**Problem**: Long query response time

**Solution**:
- Check system resource usage: `top`
- Check slow query log: `/var/log/kwdb/slow_query.log`
- Optimize query statements
- Adjust configuration file parameters

## Performance Issues

### 1. High Memory Usage

**Problem**: Database process occupies too much memory

**Solution**:
- Adjust shared_buffers parameter
- Check for memory leaks
- Increase system memory

### 2. High Disk I/O

**Problem**: Slow disk write speed

**Solution**:
- Check if disk space is sufficient
- Consider using SSD disk
- Adjust checkpoint-related parameters
- Optimize queries to reduce disk I/O

## Backup and Recovery

### 1. Backup Database

```bash
/opt/kwdb/current/bin/pg_dump -h localhost -p 5432 -U $USER -d kwdb_db > backup.sql
```

### 2. Restore Database

```bash
/opt/kwdb/current/bin/psql -h localhost -p 5432 -U $USER -d kwdb_db < backup.sql
```

## Contact Support

If you encounter issues that cannot be resolved, please contact technical support:
- Email: [email protected]
- Phone: 400-xxx-xxxx

skill-card.md

## Description:

Triggered when the user wants to install or deploy KaiwuDB (kwdb, kaiwudb). Helps users complete script-based deployment of KaiwuDB clusters, including configuration file modification, installation command execution, cluster initialization, and status checks.

This skill is ready for commercial/non-commercial use.

## Publisher:

[kwdb](https://clawhub.ai/user/kwdb)

### License/Terms of Use:

MIT-0

## Use Case:

Developers and database operators use this skill to prepare, configure, install, initialize, and check KaiwuDB deployments on Linux hosts or clusters.

### Deployment Geography for Use:

Global

## Known Risks and Mitigations:

Risk: A user-supplied KaiwuDB archive may execute installer code with administrative access.

Mitigation: Verify the archive with an official signature or checksum and inspect or stage extracted files before allowing the agent to run installation commands.

Risk: The deployment workflow can use sudo, docker group access, passwordless SSH, and service auto-start across cluster nodes.

Mitigation: Use a dedicated least-privilege deployment account where possible, confirm each node and setting with the operator, and require approval before install, cluster initialization, or auto-start commands.

## Reference(s):

- [KaiwuDB Script Deployment Guide](references/installation_guide.md)
- [KaiwuDB Common Issues and Solutions](references/troubleshooting.md)
- [KWDB Install Deploy on ClawHub](https://clawhub.ai/kwdb/skills/kwdb-install-deploy)

## Skill Output:

**Output Type(s):** [text, markdown, shell commands, configuration, guidance]

**Output Format:** [Markdown with inline shell commands and configuration guidance]

**Output Parameters:** [1D]

**Other Properties Related to Output:** [Requires user confirmation of installation package path, deployment mode, node addresses, ports, security mode, and other deployment settings before execution.]

## Skill Version(s):

1.2.1 (source: server release evidence)

## Ethical Considerations:

Users should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.
Github ReposUpdated 1d agoRank 70

AionUi

Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!

MCPOPENCLAW
Github ReposUpdated 6mo agoRank 70

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

OPENCLAW
Github ReposUpdated 6mo agoRank 70

cherry-studio

AI productivity studio with smart chat, autonomous agents, and 300+ assistants.

MCPOPENCLAW
Github ReposUpdated 7mo agoRank 70

CopilotKit

The Frontend for Agents & Generative UI. React + Angular

OPENCLAW

Machine-readable data

The same record, as JSON, for agents and crawlers.

{
  "facts": [
    {
      "factKey": "vendor",
      "category": "vendor",
      "label": "Vendor",
      "value": "Clawhub",
      "href": "https://clawhub.ai/kwdb/skills/kwdb-install-deploy",
      "sourceUrl": "https://clawhub.ai/kwdb/skills/kwdb-install-deploy",
      "sourceType": "profile",
      "confidence": "medium",
      "observedAt": "2026-10-11T03:12:51.905Z",
      "isPublic": true
    },
    {
      "factKey": "protocols",
      "category": "compatibility",
      "label": "Protocol compatibility",
      "value": "OpenClaw",
      "href": "https://www.xpersona.co/api/v1/agents/clawhub-kwdb-kwdb-install-deploy/contract",
      "sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-kwdb-kwdb-install-deploy/contract",
      "sourceType": "contract",
      "confidence": "medium",
      "observedAt": "2026-10-11T03:12:51.905Z",
      "isPublic": true
    },
    {
      "factKey": "traction",
      "category": "adoption",
      "label": "Adoption signal",
      "value": "1.2K downloads",
      "href": "https://clawhub.ai/kwdb/kwdb-install-deploy",
      "sourceUrl": "https://clawhub.ai/kwdb/kwdb-install-deploy",
      "sourceType": "profile",
      "confidence": "medium",
      "observedAt": "2026-10-11T03:12:51.905Z",
      "isPublic": true
    },
    {
      "factKey": "latest_release",
      "category": "release",
      "label": "Latest release",
      "value": "1.2.1",
      "href": "https://clawhub.ai/kwdb/kwdb-install-deploy",
      "sourceUrl": "https://clawhub.ai/kwdb/kwdb-install-deploy",
      "sourceType": "release",
      "confidence": "medium",
      "observedAt": "2026-08-28T00:47:14.321Z",
      "isPublic": true
    },
    {
      "factKey": "handshake_status",
      "category": "security",
      "label": "Handshake status",
      "value": "UNKNOWN",
      "href": "https://www.xpersona.co/api/v1/agents/clawhub-kwdb-kwdb-install-deploy/trust",
      "sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-kwdb-kwdb-install-deploy/trust",
      "sourceType": "trust",
      "confidence": "medium",
      "observedAt": null,
      "isPublic": true
    }
  ],
  "events": [
    {
      "eventType": "release",
      "title": "Release 1.2.1",
      "description": "## kwdb-install-deploy 1.2.1 - Documentation file `skill-card.md` has been removed from the project. - No changes to functionality or installation workflow.",
      "href": "https://clawhub.ai/kwdb/kwdb-install-deploy",
      "sourceUrl": "https://clawhub.ai/kwdb/kwdb-install-deploy",
      "sourceType": "release",
      "confidence": "medium",
      "observedAt": "2026-08-28T00:47:14.321Z",
      "isPublic": true
    }
  ]
}

Record generated Oct 11, 2026.

Sponsored

Ads related to KWDB Install Deploy and adjacent AI workflows.