Back to Details

openclaw-deployment-installer

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

OpenClaw Deployment & Installer

OpenClaw 部署与安装工具

Skill by ara.so — Hermes Skills collection.
OpenClawInstaller is a one-click deployment tool for OpenClaw (aka ClawdBot), a private AI assistant with persistent memory, proactive messaging, and multi-channel support. It supports Anthropic Claude, OpenAI GPT, Google Gemini, and local models via Ollama. Messaging integrations include Telegram, Discord, WhatsApp, Slack, WeChat, iMessage (macOS), and Feishu.
由ara.so提供的Skill — 属于Hermes Skills集合。
OpenClawInstaller是OpenClaw（又名ClawdBot）的一键部署工具，这是一款具备持久记忆、主动消息推送和多渠道支持的私有AI助手。它支持Anthropic Claude、OpenAI GPT、Google Gemini，以及通过Ollama部署的本地模型。消息集成渠道包括Telegram、Discord、WhatsApp、Slack、微信、iMessage（macOS）和飞书。

Installation

安装

One-Click Install (Recommended)

一键安装（推荐）

bash
curl -fsSL https://raw.githubusercontent.com/miaoxworld/OpenClawInstaller/main/install.sh | bash
This script:
  1. Detects system environment and installs dependencies
  2. Installs Node.js v22+ (if needed)
  3. Installs OpenClaw via npm
  4. Runs onboarding wizard for AI model and identity configuration
  5. Tests API connectivity
  6. Auto-starts the OpenClaw Gateway service
  7. Optionally opens configuration menu for channel setup
bash
curl -fsSL https://raw.githubusercontent.com/miaoxworld/OpenClawInstaller/main/install.sh | bash
该脚本会：
  1. 检测系统环境并安装依赖
  2. 安装Node.js v22+（如需要）
  3. 通过npm安装OpenClaw
  4. 运行引导向导进行AI模型和身份配置
  5. 测试API连通性
  6. 自动启动OpenClaw Gateway服务
  7. 可选打开配置菜单进行渠道设置

Manual Installation

手动安装

bash
undefined
bash
undefined

Clone repository

克隆仓库

git clone https://github.com/miaoxworld/OpenClawInstaller.git cd OpenClawInstaller
git clone https://github.com/miaoxworld/OpenClawInstaller.git cd OpenClawInstaller

Add execute permissions

添加执行权限

chmod +x install.sh config-menu.sh
chmod +x install.sh config-menu.sh

Run installer

运行安装器

./install.sh
./install.sh

If permission issues on macOS, install OpenClaw first

如果macOS出现权限问题，先安装OpenClaw

npm install -g openclaw
undefined
npm install -g openclaw
undefined

Desktop Manager (GUI Alternative)

桌面管理器（GUI替代方案）

For graphical interface, use OpenClaw Manager (Tauri 2.0 + React + Rust):
如需图形界面，可使用OpenClaw Manager（基于Tauri 2.0 + React + Rust）：

System Requirements

系统要求

  • OS: macOS 12+, Ubuntu 20.04+, Debian 11+, CentOS 8+
  • Node.js: v22 or higher
  • Memory: 2GB minimum, 4GB+ recommended
  • Disk: 1GB minimum
  • 操作系统：macOS 12+、Ubuntu 20.04+、Debian 11+、CentOS 8+
  • Node.js：v22或更高版本
  • 内存：最低2GB，推荐4GB+
  • 磁盘：最低1GB

Core Commands

核心命令

Service Management

服务管理

bash
undefined
bash
undefined

Start service (background daemon)

启动服务（后台守护进程）

openclaw gateway start
openclaw gateway start

Stop service

停止服务

openclaw gateway stop
openclaw gateway stop

Restart service

重启服务

openclaw gateway restart
openclaw gateway restart

Check service status

检查服务状态

openclaw gateway status
openclaw gateway status

Run in foreground (debugging)

前台运行（调试用）

openclaw gateway
openclaw gateway

View logs

查看日志

openclaw logs
openclaw logs

Follow logs in real-time

实时跟踪日志

openclaw logs --follow
undefined
openclaw logs --follow
undefined

Configuration Management

配置管理

bash
undefined
bash
undefined

Open configuration file

打开配置文件

openclaw config
openclaw config

Run onboarding wizard

运行引导向导

openclaw onboard
openclaw onboard

Diagnose configuration issues

诊断配置问题

openclaw doctor
openclaw doctor

Health check

健康检查

openclaw health
openclaw health

Set configuration values

设置配置值

openclaw config set <key> <value>
openclaw config set <key> <value>

Set model

设置模型

openclaw models set <provider> <model>
undefined
openclaw models set <provider> <model>
undefined

Data Management

数据管理

bash
undefined
bash
undefined

Export conversation history

导出对话历史

openclaw export --format json
openclaw export --format json

Clear memory

清除记忆

openclaw memory clear
openclaw memory clear

Backup data

备份数据

openclaw backup
undefined
openclaw backup
undefined

Configuration Menu (Interactive)

交互式配置菜单

bash
undefined
bash
undefined

Run configuration menu from installation directory

从安装目录运行配置菜单

bash ~/.openclaw/config-menu.sh
bash ~/.openclaw/config-menu.sh

Or download and run directly

或直接下载并运行

curl -fsSL https://raw.githubusercontent.com/miaoxworld/OpenClawInstaller/main/config-menu.sh | bash
undefined
curl -fsSL https://raw.githubusercontent.com/miaoxworld/OpenClawInstaller/main/config-menu.sh | bash
undefined

AI Model Configuration

AI模型配置

Supported Providers

支持的服务商

  • Anthropic Claude: claude-sonnet-4-5, claude-opus-4-5, claude-haiku-4-5 (supports custom API base URL)
  • OpenAI GPT: gpt-4o, gpt-4o-mini, gpt-4-turbo (supports custom API base URL with 
    v1/responses
    support)
  • Google Gemini: gemini-2.0-flash, gemini-1.5-pro, gemini-1.5-flash
  • OpenRouter: Multi-model gateway (claude-sonnet-4, gpt-4o, gemini-pro-1.5)
  • Groq: llama-3.3-70b-versatile, llama-3.1-8b-instant, mixtral-8x7b
  • Mistral AI: mistral-large-latest, mistral-small-latest, codestral-latest
  • Ollama: Local deployment (llama3, mistral, etc.)
  • Anthropic Claude：claude-sonnet-4-5、claude-opus-4-5、claude-haiku-4-5（支持自定义API基础URL）
  • OpenAI GPT：gpt-4o、gpt-4o-mini、gpt-4-turbo（支持自定义API基础URL，需兼容
    v1/responses
    ）
  • Google Gemini：gemini-2.0-flash、gemini-1.5-pro、gemini-1.5-flash
  • OpenRouter：多模型网关（支持claude-sonnet-4、gpt-4o、gemini-pro-1.5）
  • Groq：llama-3.3-70b-versatile、llama-3.1-8b-instant、mixtral-8x7b
  • Mistral AI：mistral-large-latest、mistral-small-latest、codestral-latest
  • Ollama：本地部署（支持llama3、mistral等）

Anthropic Claude Setup

Anthropic Claude配置

bash
undefined
bash
undefined

Environment variables (stored in ~/.openclaw/env)

环境变量（存储在~/.openclaw/env）

export ANTHROPIC_API_KEY="your-api-key-here" export ANTHROPIC_BASE_URL="https://custom-api-endpoint.com" # Optional
export ANTHROPIC_API_KEY="your-api-key-here" export ANTHROPIC_BASE_URL="https://custom-api-endpoint.com" # 可选

Configure via CLI

通过CLI配置

openclaw models set anthropic claude-sonnet-4-5-20250929
undefined
openclaw models set anthropic claude-sonnet-4-5-20250929
undefined

OpenAI GPT Setup

OpenAI GPT配置

⚠️ Important: Custom OpenAI API endpoints must support Responses API (
v1/responses
), not just Chat Completions (
v1/chat/completions
).
bash
undefined
⚠️ 重要提示：自定义OpenAI API端点必须支持Responses API（
v1/responses
），而不仅仅是Chat Completions（
v1/chat/completions
）。
bash
undefined

Environment variables

环境变量

export OPENAI_API_KEY="your-api-key-here" export OPENAI_BASE_URL="https://custom-api-endpoint.com/v1" # Optional
export OPENAI_API_KEY="your-api-key-here" export OPENAI_BASE_URL="https://custom-api-endpoint.com/v1" # 可选

Configure via CLI

通过CLI配置

openclaw models set openai gpt-4o
undefined
openclaw models set openai gpt-4o
undefined

Custom Provider Configuration

自定义服务商配置

For custom API endpoints (e.g., OneAPI, NewAPI), the installer creates a custom provider in 
~/.openclaw/openclaw.json
:
json
{
  "models": {
    "providers": {
      "anthropic-custom": {
        "baseUrl": "https://your-api-proxy.com",
        "apiKey": "${ANTHROPIC_API_KEY}",
        "models": [
          {
            "id": "claude-sonnet-4-5-20250929",
            "name": "claude-sonnet-4-5-20250929",
            "api": "anthropic-messages",
            "input": ["text"],
            "contextWindow": 200000,
            "maxTokens": 8192
          }
        ]
      }
    }
  }
}
对于自定义API端点（如OneAPI、NewAPI），安装器会在
~/.openclaw/openclaw.json
中创建自定义服务商配置：
json
{
  "models": {
    "providers": {
      "anthropic-custom": {
        "baseUrl": "https://your-api-proxy.com",
        "apiKey": "${ANTHROPIC_API_KEY}",
        "models": [
          {
            "id": "claude-sonnet-4-5-20250929",
            "name": "claude-sonnet-4-5-20250929",
            "api": "anthropic-messages",
            "input": ["text"],
            "contextWindow": 200000,
            "maxTokens": 8192
          }
        ]
      }
    }
  }
}

Ollama (Local Model) Setup

Ollama（本地模型）配置

bash
undefined
bash
undefined

Install Ollama first: https://ollama.ai

先安装Ollama：https://ollama.ai

ollama pull llama3
ollama pull llama3

Configure OpenClaw

配置OpenClaw

openclaw models set ollama llama3
undefined
openclaw models set ollama llama3
undefined

Messaging Channel Configuration

消息渠道配置

Telegram Bot

Telegram机器人

  1. Create bot with BotFather:
undefined
  1. 通过BotFather创建机器人：
undefined

In Telegram, message @BotFather

在Telegram中给@BotFather发消息

/newbot
/newbot

Follow prompts, get Bot Token

按照提示操作，获取机器人令牌


2. Get your User ID:

2. 获取你的用户ID：

Message @userinfobot

给@userinfobot发消息

Copy your User ID

复制你的用户ID


3. Configure via menu or manually edit `~/.openclaw/openclaw.json`:
```json
{
  "telegram": {
    "token": "123456789:ABCdefGHIjklMNOpqrsTUVwxyz",
    "userId": "987654321"
  }
}

3. 通过菜单配置或手动编辑`~/.openclaw/openclaw.json`：
```json
{
  "telegram": {
    "token": "123456789:ABCdefGHIjklMNOpqrsTUVwxyz",
    "userId": "987654321"
  }
}

Discord Bot

Discord机器人

  1. Create application at Discord Developer Portal
  2. Go to Bot section → Reset Token → Copy token
  3. Enable "Message Content Intent" (critical!)
  4. Invite bot via OAuth2 URL Generator (scopes: 
    bot
    , permissions: View Channels, Send Messages, Read Message History)
  5. Get Channel ID: Enable Developer Mode → Right-click channel → Copy Channel ID
Configure:
json
{
  "discord": {
    "token": "your-bot-token",
    "channelId": "1234567890123456789"
  }
}
  1. 在Discord开发者平台创建应用
  2. 进入Bot页面 → 重置令牌 → 复制令牌
  3. 启用"Message Content Intent"（非常重要！）
  4. 通过OAuth2 URL生成器邀请机器人（权限范围：
    bot
    ，权限：查看频道、发送消息、读取消息历史）
  5. 获取频道ID：启用开发者模式 → 右键点击频道 → 复制频道ID
配置：
json
{
  "discord": {
    "token": "your-bot-token",
    "channelId": "1234567890123456789"
  }
}

Feishu (Lark) Bot

飞书（Lark）机器人

No public server required — uses WebSocket long-connection mode.
  1. Create app at Feishu Open Platform
  2. Add "Bot" capability
  3. Get App ID and App Secret
  4. Add permissions: 
    im:message
    , 
    im:message:send_as_bot
    , 
    im:chat:readonly
  5. Publish app
  6. Configure event subscription:
    • Use long-connection mode (no webhook URL needed)
    • Add event: 
      im.message.receive_v1
    • ⚠️ OpenClaw service must be running to save settings
Configure:
json
{
  "feishu": {
    "appId": "cli_xxxxxxxxx",
    "appSecret": "your-app-secret"
  }
}
无需公共服务器 — 使用WebSocket长连接模式。
  1. 在飞书开放平台创建应用
  2. 添加"机器人"能力
  3. 获取应用ID和应用密钥
  4. 添加权限：
    im:message
    、
    im:message:send_as_bot
    、
    im:chat:readonly
  5. 发布应用
  6. 配置事件订阅：
    • 使用长连接模式（无需Webhook URL）
    • 添加事件：
      im.message.receive_v1
    • ⚠️ 保存设置时必须保证OpenClaw服务处于运行状态
配置：
json
{
  "feishu": {
    "appId": "cli_xxxxxxxxx",
    "appSecret": "your-app-secret"
  }
}

WhatsApp

WhatsApp

No Business API needed — uses personal account via QR code.
bash
undefined
无需商业API — 通过二维码使用个人账号。
bash
undefined

Run configuration menu → WhatsApp option

运行配置菜单 → 选择WhatsApp选项

Scan QR code displayed in terminal

扫描终端显示的二维码

Restart gateway after login

登录后重启网关

openclaw gateway restart

⚠️ **Note**: WhatsApp Web can only be active on one device. Configuring here will log out existing WhatsApp Web sessions.
openclaw gateway restart

⚠️ **注意**：WhatsApp Web只能在一个设备上活跃。在此配置会登出现有的WhatsApp Web会话。

Configuration Files

配置文件

Directory Structure

目录结构

~/.openclaw/
├── openclaw.json        # Core configuration (models, channels, skills)
├── env                  # Environment variables (API keys, base URLs)
├── backups/             # Configuration backups
└── logs/                # Log files (managed by OpenClaw)
~/.openclaw/
├── openclaw.json        # 核心配置（模型、渠道、Skill）
├── env                  # 环境变量（API密钥、基础URL）
├── backups/             # 配置备份
└── logs/                # 日志文件（由OpenClaw管理）

Environment Variables (
~/.openclaw/env
)

环境变量（
~/.openclaw/env
）

bash
undefined
bash
undefined

Anthropic Claude

Anthropic Claude

export ANTHROPIC_API_KEY="sk-ant-xxxxx" export ANTHROPIC_BASE_URL="https://custom-endpoint.com" # Optional
export ANTHROPIC_API_KEY="sk-ant-xxxxx" export ANTHROPIC_BASE_URL="https://custom-endpoint.com" # 可选

OpenAI GPT

OpenAI GPT

export OPENAI_API_KEY="sk-xxxxx" export OPENAI_BASE_URL="https://custom-endpoint.com/v1" # Optional
export OPENAI_API_KEY="sk-xxxxx" export OPENAI_BASE_URL="https://custom-endpoint.com/v1" # 可选

Google Gemini

Google Gemini

export GEMINI_API_KEY="your-gemini-key"
export GEMINI_API_KEY="your-gemini-key"

OpenRouter

OpenRouter

export OPENROUTER_API_KEY="sk-or-xxxxx"
export OPENROUTER_API_KEY="sk-or-xxxxx"

Groq

Groq

export GROQ_API_KEY="gsk_xxxxx"
export GROQ_API_KEY="gsk_xxxxx"

Mistral AI

Mistral AI

export MISTRAL_API_KEY="your-mistral-key"
undefined
export MISTRAL_API_KEY="your-mistral-key"
undefined

Core Configuration (
~/.openclaw/openclaw.json
)

核心配置（
~/.openclaw/openclaw.json
）

json
{
  "models": {
    "default": "claude-sonnet-4-5-20250929",
    "providers": {
      "anthropic": {
        "apiKey": "${ANTHROPIC_API_KEY}",
        "models": ["claude-sonnet-4-5-20250929"]
      }
    }
  },
  "telegram": {
    "token": "${TELEGRAM_BOT_TOKEN}",
    "userId": "123456789"
  },
  "discord": {
    "token": "${DISCORD_BOT_TOKEN}",
    "channelId": "987654321"
  },
  "memory": {
    "enabled": true,
    "maxMessages": 1000
  },
  "skills": {
    "enabled": true,
    "directory": "~/.openclaw/skills"
  }
}
json
{
  "models": {
    "default": "claude-sonnet-4-5-20250929",
    "providers": {
      "anthropic": {
        "apiKey": "${ANTHROPIC_API_KEY}",
        "models": ["claude-sonnet-4-5-20250929"]
      }
    }
  },
  "telegram": {
    "token": "${TELEGRAM_BOT_TOKEN}",
    "userId": "123456789"
  },
  "discord": {
    "token": "${DISCORD_BOT_TOKEN}",
    "channelId": "987654321"
  },
  "memory": {
    "enabled": true,
    "maxMessages": 1000
  },
  "skills": {
    "enabled": true,
    "directory": "~/.openclaw/skills"
  }
}

Common Patterns

常用操作

Testing API Connection

测试API连接

bash
undefined
bash
undefined

After configuring AI model

配置AI模型后

openclaw doctor
openclaw doctor

Test specific model

测试特定模型

openclaw models test anthropic claude-sonnet-4-5-20250929
undefined
openclaw models test anthropic claude-sonnet-4-5-20250929
undefined

Adding Custom Skills

添加自定义Skill

bash
undefined
bash
undefined

Skills are Markdown files in ~/.openclaw/skills/

Skill是存储在~/.openclaw/skills/中的Markdown文件

mkdir -p ~/.openclaw/skills
cat > ~/.openclaw/skills/weather.md << 'EOF'
mkdir -p ~/.openclaw/skills
cat > ~/.openclaw/skills/weather.md << 'EOF'

Weather Information

天气信息

You can fetch weather information for any city.
你可以获取任意城市的天气信息。

Usage

使用方法

When user asks about weather:
  1. Extract city name
  2. Use curl to fetch from weather API
  3. Format and present results EOF
当用户询问天气时：
  1. 提取城市名称
  2. 使用curl从天气API获取数据
  3. 格式化并展示结果 EOF

Restart gateway to load skills

重启网关加载Skill

openclaw gateway restart
undefined
openclaw gateway restart
undefined

Monitoring Service Status

监控服务状态

bash
undefined
bash
undefined

Check if gateway is running

检查网关是否运行

openclaw gateway status
openclaw gateway status

View recent logs

查看最近日志

openclaw logs --tail 50
openclaw logs --tail 50

Watch logs in real-time

实时监控日志

openclaw logs --follow
openclaw logs --follow

Health check with detailed output

详细健康检查

openclaw health --verbose
undefined
openclaw health --verbose
undefined

Switching AI Models

切换AI模型

bash
undefined
bash
undefined

Change to different model

切换到其他模型

openclaw models set anthropic claude-opus-4-5
openclaw models set anthropic claude-opus-4-5

Change to different provider

切换到其他服务商

openclaw models set openai gpt-4o
openclaw models set openai gpt-4o

Verify current model

验证当前模型

openclaw config get models.default
undefined
openclaw config get models.default
undefined

Backup and Restore

备份与恢复

bash
undefined
bash
undefined

Backup all configuration and data

备份所有配置和数据

openclaw backup --output ~/openclaw-backup-$(date +%Y%m%d).tar.gz
openclaw backup --output ~/openclaw-backup-$(date +%Y%m%d).tar.gz

Restore from backup

从备份恢复

openclaw restore ~/openclaw-backup-20260517.tar.gz
openclaw restore ~/openclaw-backup-20260517.tar.gz

Export conversations only

仅导出对话

openclaw export --format json --output ~/conversations.json
undefined
openclaw export --format json --output ~/conversations.json
undefined

Troubleshooting

故障排查

Service Won't Start

服务无法启动

bash
undefined
bash
undefined

Check for errors

检查错误

openclaw doctor
openclaw doctor

View detailed logs

查看详细日志

openclaw logs --level debug
openclaw logs --level debug

Verify Node.js version

验证Node.js版本

node --version # Should be v22+
node --version # 应为v22+

Check environment variables

检查环境变量

source ~/.openclaw/env echo $ANTHROPIC_API_KEY
undefined
source ~/.openclaw/env echo $ANTHROPIC_API_KEY
undefined

API Key Not Working

API密钥无效

bash
undefined
bash
undefined

Test API key manually

手动测试API密钥

curl https://api.anthropic.com/v1/messages
-H "x-api-key: $ANTHROPIC_API_KEY"
-H "anthropic-version: 2023-06-01"
-H "content-type: application/json"
-d '{"model":"claude-sonnet-4-5-20250929","max_tokens":10,"messages":[{"role":"user","content":"Hi"}]}'
curl https://api.anthropic.com/v1/messages
-H "x-api-key: $ANTHROPIC_API_KEY"
-H "anthropic-version: 2023-06-01"
-H "content-type: application/json"
-d '{"model":"claude-sonnet-4-5-20250929","max_tokens":10,"messages":[{"role":"user","content":"Hi"}]}'

For custom base URL

对于自定义基础URL

curl https://your-custom-endpoint.com/v1/messages
-H "x-api-key: $ANTHROPIC_API_KEY"
-H "anthropic-version: 2023-06-01"
-H "content-type: application/json"
-d '{"model":"claude-sonnet-4-5-20250929","max_tokens":10,"messages":[{"role":"user","content":"Hi"}]}'
undefined
curl https://your-custom-endpoint.com/v1/messages
-H "x-api-key: $ANTHROPIC_API_KEY"
-H "anthropic-version: 2023-06-01"
-H "content-type: application/json"
-d '{"model":"claude-sonnet-4-5-20250929","max_tokens":10,"messages":[{"role":"user","content":"Hi"}]}'
undefined

Telegram Bot Not Responding

Telegram机器人无响应

bash
undefined
bash
undefined

Verify bot token and user ID

验证机器人令牌和用户ID

cat ~/.openclaw/openclaw.json | grep -A 3 telegram
cat ~/.openclaw/openclaw.json | grep -A 3 telegram

Check logs for errors

检查日志中的错误

openclaw logs | grep telegram
openclaw logs | grep telegram

Test bot manually

手动测试机器人

curl https://api.telegram.org/bot${TELEGRAM_BOT_TOKEN}/getMe
undefined
curl https://api.telegram.org/bot${TELEGRAM_BOT_TOKEN}/getMe
undefined

Discord Bot Not Responding

Discord机器人无响应

  1. Verify Message Content Intent is enabled in Discord Developer Portal
  2. Check bot has permissions in target channel
  3. Verify channel ID is correct:
bash
undefined
  1. 确认Discord开发者平台中已启用Message Content Intent
  2. 检查机器人在目标频道是否有相应权限
  3. 验证频道ID是否正确：
bash
undefined

Check configuration

查看配置

openclaw config get discord.channelId
openclaw config get discord.channelId

View logs

查看日志

openclaw logs | grep discord
undefined
openclaw logs | grep discord
undefined

Feishu Bot Not Receiving Messages

飞书机器人无法接收消息

  1. Ensure OpenClaw gateway is running when saving event subscription settings
  2. Verify long-connection mode is selected (not webhook)
  3. Check permissions are granted and app is published
  4. View logs:
bash
openclaw logs | grep feishu
  1. 保存事件订阅设置时确保OpenClaw网关处于运行状态
  2. 确认选择了长连接模式（而非Webhook）
  3. 检查权限已授予且应用已发布
  4. 查看日志：
bash
openclaw logs | grep feishu

WhatsApp Connection Lost

WhatsApp连接断开

bash
undefined
bash
undefined

Re-authenticate by reconfiguring

重新配置进行身份验证

bash ~/.openclaw/config-menu.sh
bash ~/.openclaw/config-menu.sh

Select WhatsApp → Scan new QR code

选择WhatsApp → 扫描新的二维码

Restart gateway

重启网关

openclaw gateway restart
undefined
openclaw gateway restart
undefined

Memory/Performance Issues

内存/性能问题

bash
undefined
bash
undefined

Clear old memory

清除旧记忆

openclaw memory clear --before 2026-01-01
openclaw memory clear --before 2026-01-01

Reduce context window in config

在配置中减少上下文窗口

openclaw config set memory.maxMessages 500
openclaw config set memory.maxMessages 500

Monitor resource usage

监控资源使用情况

openclaw health --verbose
undefined
openclaw health --verbose
undefined

Custom API Endpoint Not Working

自定义API端点无效

For Anthropic:
bash
undefined
对于Anthropic：
bash
undefined

Verify baseUrl format (no /v1 suffix)

验证baseUrl格式（无/v1后缀）

echo $ANTHROPIC_BASE_URL # Should be: https://api.example.com
echo $ANTHROPIC_BASE_URL # 应为：https://api.example.com

Test endpoint

测试端点

curl $ANTHROPIC_BASE_URL/v1/messages -H "x-api-key: $ANTHROPIC_API_KEY" -H "anthropic-version: 2023-06-01" -d '{"model":"claude-sonnet-4-5-20250929","max_tokens":10,"messages":[{"role":"user","content":"test"}]}'

For OpenAI (must support `v1/responses`):
```bash
curl $ANTHROPIC_BASE_URL/v1/messages -H "x-api-key: $ANTHROPIC_API_KEY" -H "anthropic-version: 2023-06-01" -d '{"model":"claude-sonnet-4-5-20250929","max_tokens":10,"messages":[{"role":"user","content":"test"}]}'

对于OpenAI（必须支持`v1/responses`）：
```bash

Verify endpoint supports Responses API

验证端点是否支持Responses API

curl $OPENAI_BASE_URL/responses
-H "Authorization: Bearer $OPENAI_API_KEY"
-H "Content-Type: application/json"
-d '{"model":"gpt-4o","input":[{"role":"user","content":"test"}],"max_tokens":10}'
curl $OPENAI_BASE_URL/responses
-H "Authorization: Bearer $OPENAI_API_KEY"
-H "Content-Type: application/json"
-d '{"model":"gpt-4o","input":[{"role":"user","content":"test"}],"max_tokens":10}'

If 404, your endpoint doesn't support Responses API

如果返回404，说明你的端点不支持Responses API

undefined
undefined

Clean Reinstall

彻底重新安装

bash
undefined
bash
undefined

Stop service

停止服务

openclaw gateway stop
openclaw gateway stop

Backup data

备份数据

openclaw backup
openclaw backup

Uninstall

卸载

npm uninstall -g openclaw rm -rf ~/.openclaw
npm uninstall -g openclaw rm -rf ~/.openclaw

Reinstall

重新安装

curl -fsSL https://raw.githubusercontent.com/miaoxworld/OpenClawInstaller/main/install.sh | bash
undefined
curl -fsSL https://raw.githubusercontent.com/miaoxworld/OpenClawInstaller/main/install.sh | bash
undefined

Advanced Configuration

高级配置

Multiple AI Models (Fallback)

多AI模型（故障转移）

Edit 
~/.openclaw/openclaw.json
:
json
{
  "models": {
    "default": "claude-sonnet-4-5-20250929",
    "fallback": ["gpt-4o", "gemini-2.0-flash"],
    "providers": {
      "anthropic": { "apiKey": "${ANTHROPIC_API_KEY}" },
      "openai": { "apiKey": "${OPENAI_API_KEY}" },
      "google": { "apiKey": "${GEMINI_API_KEY}" }
    }
  }
}
编辑
~/.openclaw/openclaw.json
：
json
{
  "models": {
    "default": "claude-sonnet-4-5-20250929",
    "fallback": ["gpt-4o", "gemini-2.0-flash"],
    "providers": {
      "anthropic": { "apiKey": "${ANTHROPIC_API_KEY}" },
      "openai": { "apiKey": "${OPENAI_API_KEY}" },
      "google": { "apiKey": "${GEMINI_API_KEY}" }
    }
  }
}

Scheduled Proactive Messages

定时主动消息

bash
undefined
bash
undefined

Create skill for morning briefing

创建早报Skill

cat > ~/.openclaw/skills/morning-briefing.md << 'EOF'
cat > ~/.openclaw/skills/morning-briefing.md << 'EOF'

Morning Briefing

早报

Every day at 8 AM, send a summary of:
  • Today's calendar events
  • Weather forecast
  • Important reminders
每天早上8点发送以下内容的摘要：
  • 今日日历事件
  • 天气预报
  • 重要提醒

Schedule

调度

  • Time: 08:00
  • Timezone: UTC EOF
openclaw gateway restart
undefined
  • 时间：08:00
  • 时区：UTC EOF
openclaw gateway restart
undefined

Custom System Prompt

自定义系统提示词

Edit 
~/.openclaw/openclaw.json
:
json
{
  "system": {
    "prompt": "You are a helpful AI assistant named OpenClaw. You have persistent memory across conversations and can proactively send messages. Be concise and friendly."
  }
}
This skill covers the essential deployment, configuration, service management, and troubleshooting workflows for OpenClaw using the installer tools.
编辑
~/.openclaw/openclaw.json
：
json
{
  "system": {
    "prompt": "你是名为OpenClaw的友好AI助手，具备跨对话的持久记忆，能够主动发送消息。请保持回复简洁友好。"
  }
}
该Skill涵盖了使用安装工具进行OpenClaw部署、配置、服务管理及故障排查的核心流程。