OpenClaw Chinese AI Assistant Skill

Skill by ara.so — Hermes Skills collection.

Overview

OpenClaw Chinese Translation is a fully localized (Simplified Chinese) distribution of OpenClaw, an open-source personal AI assistant platform with 195,000+ GitHub stars. It runs locally on your machine and provides AI assistance through popular chat platforms (WhatsApp, Telegram, Discord) with both CLI and web dashboard interfaces fully translated to Chinese.

Key Features:

Automatic hourly sync with upstream OpenClaw (< 1 hour delay)
Full Chinese localization for CLI and Dashboard
Multi-platform support: WhatsApp, Telegram, Discord
Multiple LLM providers: Claude, OpenAI, compatible APIs
Tool calling and skill extensions
Daemon/service mode for background operation
Web-based management dashboard

Installation

Prerequisites

Node.js >= 22 is required. Check version:

bash

node -v

If needed, download from https://nodejs.org/

Install OpenClaw Chinese

bash

npm install -g @qingchencloud/openclaw-zh@latest

Verify Installation

bash

openclaw --version

Initialization and Configuration

Initial Setup with Daemon

bash

openclaw onboard --install-daemon

This interactive wizard will guide you through:

Selecting an LLM provider (Claude, OpenAI, or compatible)
Configuring API credentials
Setting up chat channels (WhatsApp/Telegram/Discord)
Installing gateway as daemon service

Manual Configuration

View current config:

bash

openclaw config

Edit config file directly (located at

~/.openclaw/config.yml

yaml

llm:
  provider: openai
  api_key: ${OPENAI_API_KEY}
  model: gpt-4
  base_url: https://api.openai.com/v1  # For compatible providers

gateway:
  port: 3000
  host: 0.0.0.0

channels:
  - type: telegram
    token: ${TELEGRAM_BOT_TOKEN}
  - type: discord
    token: ${DISCORD_BOT_TOKEN}

Configure LLM Provider

For OpenAI-compatible providers (like the free gpt.qt.cool):

bash

openclaw config set llm.provider openai-compatible
openclaw config set llm.base_url https://gpt.qt.cool/v1
openclaw config set llm.api_key ${YOUR_API_KEY}
openclaw config set llm.model gpt-4

For Claude:

bash

openclaw config set llm.provider anthropic
openclaw config set llm.api_key ${ANTHROPIC_API_KEY}
openclaw config set llm.model claude-3-5-sonnet-20241022

Core Commands

Gateway Management

bash

# Start gateway (foreground, for debugging)
openclaw gateway run

# Start as daemon (background, recommended)
openclaw gateway start

# Stop daemon
openclaw gateway stop

# Restart gateway
openclaw gateway restart

# Check status
openclaw gateway status

# Install as system service (auto-start on boot)
openclaw gateway install

# Uninstall system service
openclaw gateway uninstall

Dashboard

bash

# Open web dashboard (auto-opens browser)
openclaw dashboard

# Open on specific port
openclaw dashboard --port 8080

# Access remotely with token
openclaw dashboard --host 0.0.0.0 --token ${DASHBOARD_TOKEN}

Dashboard URL: http://localhost:3000 (default)

Language Setting: After opening dashboard, go to Overview page → scroll to bottom → set Language to 简体中文 (Simplified Chinese) → refresh.

Skills Management

bash

# List available skills
openclaw skills list

# Install a skill
openclaw skills install 1password

# Remove a skill
openclaw skills remove 1password

# Update all skills
openclaw skills update

Maintenance

bash

# Update OpenClaw CLI
openclaw update

# Diagnose issues (auto-fix)
openclaw doctor

# View logs
openclaw logs

# Clear cache
openclaw cache clear

Real-World Usage Examples

Example 1: Deploy with Custom LLM Provider

bash

#!/bin/bash

# Set environment variables
export OPENAI_API_KEY="sk-your-key-here"
export TELEGRAM_BOT_TOKEN="123456:ABC-DEF-your-token"

# Install
npm install -g @qingchencloud/openclaw-zh@latest

# Configure programmatically
openclaw config set llm.provider openai-compatible
openclaw config set llm.base_url https://gpt.qt.cool/v1
openclaw config set llm.api_key "${OPENAI_API_KEY}"
openclaw config set llm.model gpt-4

# Add Telegram channel
openclaw config set channels.0.type telegram
openclaw config set channels.0.token "${TELEGRAM_BOT_TOKEN}"

# Start daemon
openclaw gateway start

# Verify running
openclaw gateway status

Example 2: Docker Deployment

Create

docker-compose.yml

yaml

version: '3.8'

services:
  openclaw:
    image: ghcr.io/1186258278/openclaw-chinese:latest
    container_name: openclaw-zh
    restart: unless-stopped
    ports:
      - "3000:3000"
    environment:
      - OPENAI_API_KEY=${OPENAI_API_KEY}
      - ANTHROPIC_API_KEY=${ANTHROPIC_API_KEY}
      - TELEGRAM_BOT_TOKEN=${TELEGRAM_BOT_TOKEN}
      - DASHBOARD_TOKEN=${DASHBOARD_TOKEN}
    volumes:
      - ./data:/root/.openclaw
      - ./logs:/var/log/openclaw

Run:

bash

docker-compose up -d

Example 3: Remote Access with Nginx

Nginx config for HTTPS dashboard access:

nginx

server {
    listen 443 ssl;
    server_name openclaw.example.com;

    ssl_certificate /path/to/cert.pem;
    ssl_certificate_key /path/to/key.pem;

    location / {
        proxy_pass http://127.0.0.1:3000;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection 'upgrade';
        proxy_set_header Host $host;
        proxy_cache_bypass $http_upgrade;
        
        # WebSocket support
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

Example 4: Programmatic Agent Creation (JavaScript)

javascript

// Create custom agent configuration
const fs = require('fs');
const path = require('path');
const yaml = require('js-yaml');

const configPath = path.join(process.env.HOME, '.openclaw', 'config.yml');
const config = yaml.load(fs.readFileSync(configPath, 'utf8'));

// Add new agent
config.agents = config.agents || [];
config.agents.push({
  name: 'research-assistant',
  model: 'gpt-4',
  system_prompt: '你是一个专业的研究助手，帮助用户查找和总结信息。',
  skills: ['web-search', 'summarize', 'markdown'],
  max_tokens: 4000,
  temperature: 0.7
});

// Save config
fs.writeFileSync(configPath, yaml.dump(config), 'utf8');
console.log('Agent created successfully');

Example 5: Monitoring Gateway Status

bash

#!/bin/bash

# Check if gateway is running
if openclaw gateway status | grep -q "running"; then
    echo "Gateway is healthy"
    exit 0
else
    echo "Gateway is down, restarting..."
    openclaw gateway restart
    sleep 5
    if openclaw gateway status | grep -q "running"; then
        echo "Gateway restarted successfully"
        exit 0
    else
        echo "Failed to restart gateway"
        exit 1
    fi
fi

Common Patterns

Pattern 1: Multi-Model Setup

Configure different models for different tasks:

yaml

agents:
  - name: fast-assistant
    model: gpt-3.5-turbo
    use_case: quick_questions
  
  - name: deep-thinker
    model: claude-3-opus-20240229
    use_case: complex_reasoning
  
  - name: code-helper
    model: gpt-4
    skills: ['code-interpreter', 'github']

Pattern 2: Environment-Based Config

Use environment variables for secrets:

bash

# .env file
OPENAI_API_KEY=sk-proj-...
ANTHROPIC_API_KEY=sk-ant-...
TELEGRAM_BOT_TOKEN=123456:ABC...
WHATSAPP_PHONE_NUMBER=+1234567890
DASHBOARD_TOKEN=secure-random-token-here

# Load in config.yml
llm:
  api_key: ${OPENAI_API_KEY}

channels:
  - type: telegram
    token: ${TELEGRAM_BOT_TOKEN}
  - type: whatsapp
    phone: ${WHATSAPP_PHONE_NUMBER}

Pattern 3: Skill Chains

Combine multiple skills for complex workflows:

javascript

// Example: Research and summarize workflow
const workflow = {
  steps: [
    { skill: 'web-search', query: '${user_query}' },
    { skill: 'summarize', input: '${search_results}' },
    { skill: 'markdown', format: 'report', input: '${summary}' }
  ]
};

Troubleshooting

Gateway Won't Start

bash

# Check if port 3000 is already in use
lsof -i :3000  # macOS/Linux
netstat -ano | findstr :3000  # Windows

# Run diagnostics
openclaw doctor

# Check logs
openclaw logs --tail 100

# Try alternative port
openclaw gateway run --port 3001

Dashboard Connection Issues

Cannot access dashboard remotely:

bash

# Start with external access
openclaw dashboard --host 0.0.0.0 --token your-secure-token

# Or edit config
openclaw config set gateway.host 0.0.0.0
openclaw config set gateway.dashboard_token your-secure-token
openclaw gateway restart

CORS errors:

yaml

# config.yml
gateway:
  cors:
    enabled: true
    origins:
      - https://yourdomain.com
      - http://localhost:*

LLM Provider Errors

bash

# Test API connection
curl https://gpt.qt.cool/v1/models \
  -H "Authorization: Bearer ${OPENAI_API_KEY}"

# Verify config
openclaw config get llm

# Switch provider
openclaw config set llm.provider openai-compatible
openclaw config set llm.base_url https://api.openai.com/v1

Daemon Service Issues (Windows)

gateway install

fails on Windows:

bash

# Use daemon start instead (doesn't require schtasks)
openclaw gateway start

# Or use Docker
docker run -d -p 3000:3000 \
  -v ~/.openclaw:/root/.openclaw \
  ghcr.io/1186258278/openclaw-chinese:latest

Memory/Performance Issues

bash

# Check resource usage
openclaw gateway status --verbose

# Limit memory (Node.js)
export NODE_OPTIONS="--max-old-space-size=4096"
openclaw gateway restart

# Clear cache
openclaw cache clear

Update Issues

bash

# Force reinstall
npm uninstall -g @qingchencloud/openclaw-zh
npm install -g @qingchencloud/openclaw-zh@latest

# Clear npm cache if needed
npm cache clean --force

Uninstallation

bash

# Stop services
openclaw gateway stop
openclaw gateway uninstall  # If installed as service

# Uninstall package
npm uninstall -g @qingchencloud/openclaw-zh

# Remove config (optional)
rm -rf ~/.openclaw

Additional Resources

Official Chinese Documentation: https://openclaw.qt.cool
GitHub Repository: https://github.com/1186258278/OpenClawChineseTranslation
Free AI API Platform: https://gpt.qt.cool
ClawPanel (GUI Manager): https://github.com/qingchencloud/clawpanel
ClawApp (Mobile Client): https://github.com/qingchencloud/clawapp
Detailed Install Guide: docs/INSTALL_GUIDE.md
Docker Guide: docs/DOCKER_GUIDE.md
FAQ: docs/FAQ.md

openclaw-chinese-ai-assistant

NPX Install

Tags

SKILL.md Content

OpenClaw Chinese AI Assistant Skill

Overview

Installation

Prerequisites

Install OpenClaw Chinese

Verify Installation

Initialization and Configuration

Initial Setup with Daemon

Manual Configuration

Configure LLM Provider

Core Commands

Gateway Management

Dashboard

Skills Management

Maintenance

Real-World Usage Examples

Example 1: Deploy with Custom LLM Provider

Example 2: Docker Deployment

Example 3: Remote Access with Nginx

Example 4: Programmatic Agent Creation (JavaScript)

Example 5: Monitoring Gateway Status

Common Patterns

Pattern 1: Multi-Model Setup

Pattern 2: Environment-Based Config

Pattern 3: Skill Chains

Troubleshooting

Gateway Won't Start

Dashboard Connection Issues

LLM Provider Errors

Daemon Service Issues (Windows)

Memory/Performance Issues

Update Issues

Uninstallation

Additional Resources