---

name: mediawiki-login description: | MediaWiki login and connection testing skill for OpenClaw. Provides simple commands to test connectivity, authenticate, and verify user permissions on MediaWiki instances. metadata: { "openclaw": { "requires": { "bins": ["bash", "curl", "jq"] }, "install": [ { "id": "node", "kind": "node", "package": "mustache", "label": "Install Mustache template engine (optional, for future extensions)", "optional": true }, ], }, }

MediaWiki Login Skill

MediaWiki login and connection testing skill for OpenClaw. Provides simple commands to test connectivity, authenticate, and verify user permissions on MediaWiki instances.

Activation Triggers

Activate this skill when you need to:

1. Test MediaWiki connectivity - Check if a MediaWiki instance is accessible
2. Authenticate users - Log in to MediaWiki with username/password
3. Verify permissions - Check user rights and capabilities
4. Debug connection issues - Troubleshoot API access problems
5. Quick health checks - Validate wiki configuration before bulk operations

Core Features

1. Connection Testing

• test_connection(url) - Test basic API connectivity
• verify_api_path(url, path) - Verify correct API endpoint

2. Authentication

• login(username, password) - Authenticate and obtain session
• logout() - End session properly
• get_user_info() - Get current user details and permissions

3. Configuration Management

• load_config(file) - Load configuration from file
• validate_config() - Validate required configuration parameters
• export_config() - Export current configuration

4. Health Checks

• check_health() - Comprehensive health check (connectivity + auth)
• get_wiki_info() - Get wiki site information
• test_permissions() - Test specific user permissions

Prerequisites

1. Required System Tools

# Check if required tools are installed
command -v bash && command -v curl && command -v jq

2. Configuration

Skill requires the following configuration:

# Environment variables
export MEDIAWIKI_URL="https://your-wiki.com"      # Wiki URL
export MEDIAWIKI_USERNAME="your_username"         # Login username
export MEDIAWIKI_PASSWORD="your_password"         # Login password
export MEDIAWIKI_API_PATH="/api.php"              # API path (usually /w/api.php or /api.php)

3. Network Access

• Ensure network connectivity to the target wiki
• Firewall must allow HTTPS connections (port 443)
• DNS must resolve the wiki hostname correctly

Usage Instructions

Basic Usage Flow

1. Configure the skill

# Copy configuration template
cp config/mediawiki-config-template.sh config/mediawiki-config.sh

# Edit with your credentials
nano config/mediawiki-config.sh

# Load configuration
source config/mediawiki-config.sh

2. Test connection (without authentication)

./scripts/test_connection.sh
# Output: Connection successful or specific error

3. Login and verify

./scripts/login.sh
# Output: Login successful with user ID and name

4. Full health check

./scripts/health_check.sh
# Output: Comprehensive status report

Command Reference

test_connection.sh

# Test basic connectivity
./scripts/test_connection.sh

# Test with custom URL
MEDIAWIKI_URL="https://other-wiki.com" ./scripts/test_connection.sh

login.sh

# Login and save session
./scripts/login.sh

# Login with verbose output
DEBUG=true ./scripts/login.sh

get_user_info.sh

# Get current user information
./scripts/get_user_info.sh

health_check.sh

# Run comprehensive health check
./scripts/health_check.sh

Advanced Usage

Using in scripts

#!/bin/bash
# Example script using the skill

source config/mediawiki-config.sh

# Test connection
if ./scripts/test_connection.sh; then
    echo "Connection OK"
else
    echo "Connection failed"
    exit 1
fi

# Login
if ./scripts/login.sh; then
    USER_ID=$(cat /tmp/mediawiki-userid.txt 2>/dev/null)
    echo "Logged in as user ID: $USER_ID"
fi

Debugging mode

# Enable debug output
export DEBUG=true
./scripts/login.sh

# Trace API calls
export TRACE_API=true
./scripts/test_connection.sh

Configuration Files

Skill Structure

mediawiki-login/
├── SKILL.md                    # This file
├── package.json                # Package metadata
├── config/
│   ├── mediawiki-config-template.sh  # Configuration template
│   └── mediawiki-config.sh     # Actual configuration (in .gitignore)
├── scripts/
│   ├── test_connection.sh      # Connection testing
│   ├── login.sh                # Authentication
│   ├── logout.sh               # Session cleanup
│   ├── get_user_info.sh        # User information
│   └── health_check.sh         # Comprehensive health check
└── examples/
    └── example-usage.sh        # Usage examples

Configuration Template (config/mediawiki-config-template.sh)

#!/bin/bash

# MediaWiki Configuration Template
# Copy to config/mediawiki-config.sh and edit with your credentials

# MediaWiki instance URL
export MEDIAWIKI_URL="https://wiki.example.com"

# Authentication credentials
export MEDIAWIKI_USERNAME="your_username"
export MEDIAWIKI_PASSWORD="your_password"

# API path (default: /w/api.php, alternative: /api.php)
export MEDIAWIKI_API_PATH="/w/api.php"

# Timeout settings (seconds)
export MEDIAWIKI_TIMEOUT="30"

# Optional: Proxy settings
# export MEDIAWIKI_PROXY="http://proxy.example.com:8080"

# Optional: Debug mode
# export DEBUG="false"

# Optional: Cookie file location
# export MEDIAWIKI_COOKIE_FILE="/tmp/mediawiki-cookies.txt"

Error Handling

Common Errors and Solutions

| Error | Possible Cause | Solution | |-------|---------------|----------| | Connection refused | Wrong URL, network issues | Verify URL, check network connectivity | | API not found | Wrong API path | Try /w/api.php or /api.php | | Login failed | Wrong credentials | Verify username/password | | Permission denied | User lacks rights | Check user permissions in wiki | | Timeout | Network latency, server slow | Increase timeout setting |

Debug Mode

# Enable detailed error messages
export DEBUG=true
./scripts/login.sh

# Output will include:
# - API requests and responses
# - Error details
# - Step-by-step execution

Log Files

• API logs: /tmp/mediawiki-api-*.log
• Session files: /tmp/mediawiki-session-*.txt
• Error logs: /tmp/mediawiki-error-*.log

Security Best Practices

1. Credential Management

# ✅ DO: Use environment variables
export MEDIAWIKI_PASSWORD="your_password"

# ❌ DON'T: Hardcode passwords in scripts
# PASSWORD="secret"  # Bad practice

# Recommended: Use secrets manager or encrypted files

2. Configuration Files

# Add configuration to .gitignore
echo "config/mediawiki-config.sh" >> .gitignore

# Use template for sharing
cp config/mediawiki-config-template.sh config/mediawiki-config.sh

3. Session Management

# Clean up session files after use
trap 'rm -f /tmp/mediawiki-*.tmp' EXIT

# Use secure cookie storage
export MEDIAWIKI_COOKIE_FILE="$(mktemp /tmp/mediawiki-cookies-XXXXXX)"

4. Network Security

# Verify SSL certificates (default)
export CURL_OPTIONS="--fail --silent --show-error"

# For testing with self-signed certificates
# export CURL_OPTIONS="-k"  # Insecure, use only in test environments

Performance Tips

1. Connection Pooling

# Reuse cookie files for multiple requests
SESSION_FILE="$(mktemp /tmp/mediawiki-session-XXXXXX)"
./scripts/login.sh --cookie-file "$SESSION_FILE"
./scripts/get_user_info.sh --cookie-file "$SESSION_FILE"

2. Caching

# Cache wiki info for repeated checks
if [ ! -f /tmp/wiki-info.json ] || [ $(find /tmp/wiki-info.json -mmin +60) ]; then
    ./scripts/get_wiki_info.sh > /tmp/wiki-info.json
fi

3. Parallel Testing

# Test multiple wikis in parallel
for wiki in wiki1 wiki2 wiki3; do
    MEDIAWIKI_URL="https://$wiki.com" ./scripts/test_connection.sh &
done
wait

Integration Examples

With mediawiki-editor Skill

# Use login skill to verify connection before editor operations
source ./config/mediawiki-config.sh

if ./scripts/health_check.sh; then
    echo "Wiki is ready for editing"
    # Proceed with mediawiki-editor operations
    ./../mediawiki-editor/scripts/upload_medical_case.sh ...
else
    echo "Wiki connection failed"
    exit 1
fi

In CI/CD Pipeline

# GitHub Actions example
jobs:
  test-wiki-connection:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - name: Test MediaWiki connection
        run: |
          source mediawiki-login/config/mediawiki-config.sh
          ./mediawiki-login/scripts/health_check.sh
        env:
          MEDIAWIKI_URL: ${{ secrets.MEDIAWIKI_URL }}
          MEDIAWIKI_USERNAME: ${{ secrets.MEDIAWIKI_USERNAME }}
          MEDIAWIKI_PASSWORD: ${{ secrets.MEDIAWIKI_PASSWORD }}

With Docker

# Dockerfile example
FROM alpine:latest
RUN apk add --no-cache bash curl jq
COPY mediawiki-login /app/mediawiki-login
WORKDIR /app/mediawiki-login
ENTRYPOINT ["./scripts/health_check.sh"]

Development

Adding New Features

1. New Script Template

#!/bin/bash
# scripts/new_feature.sh

set -e

# Load configuration
CONFIG_FILE="${MEDIAWIKI_CONFIG:-./config/mediawiki-config.sh}"
[ -f "$CONFIG_FILE" ] && source "$CONFIG_FILE"

# Set defaults
: ${MEDIAWIKI_URL:?Please set MEDIAWIKI_URL}
: ${MEDIAWIKI_API_PATH:=/w/api.php}

# Logging function
log() {
    if [ "${DEBUG:-false}" = "true" ]; then
        echo "[$(date '+%Y-%m-%d %H:%M:%S')] $*" >&2
    fi
}

# Main function
main() {
    log "Starting new feature"
    # Implementation here
}

# Execute
main "$@"

2. Testing

# Run tests
./scripts/test_connection.sh
./scripts/login.sh
./scripts/health_check.sh

Contributing

1. Fork the repository
2. Create a feature branch
3. Add tests for new functionality
4. Submit a pull request

Support

Getting Help

• Documentation: This SKILL.md file
• Examples: Check examples/ directory
• Debugging: Use DEBUG=true environment variable

Reporting Issues

1. Check error messages carefully
2. Enable debug mode: DEBUG=true
3. Capture logs from /tmp/mediawiki-*.log
4. Open an issue with details

Feature Requests

Suggest new features via GitHub issues or community forums.

---

Version: 1.0.0
Last Updated: 2026-02-09
Maintainer: OpenClaw Skills Team
License: MIT