chmod +x Antigravity-Manager-*.AppImage
./Antigravity-Manager-*.AppImage

# Add local-anthropic provider
cat ~/.openclaw/openclaw.json | jq '.models.providers["local-anthropic"] = {
  "baseUrl": "http://127.0.0.1:8045",
  "apiKey": "你的User_Token",
  "auth": "api-key",
  "api": "anthropic-messages",
  "models": [
    {
      "id": "claude-sonnet-4-5-20250929",
      "name": "Local Claude Sonnet 4.5",
      "reasoning": false,
      "input": ["text"],
      "cost": {
        "input": 0,
        "output": 0,
        "cacheRead": 0,
        "cacheWrite": 0
      },
      "contextWindow": 200000,
      "maxTokens": 8192
    }
  ]
}' > /tmp/openclaw-temp.json && mv /tmp/openclaw-temp.json ~/.openclaw/openclaw.json

# Set as default model
openclaw config set agents.defaults.model.primary "local-anthropic/claude-sonnet-4-5-20250929"

cat ~/.openclaw/openclaw.json | jq '.models.providers["local-anthropic-opus"] = {
  "baseUrl": "http://127.0.0.1:8045",
  "apiKey": "你的User_Token",
  "auth": "api-key",
  "api": "anthropic-messages",
  "models": [
    {
      "id": "claude-opus-4-5-thinking",
      "name": "Local Claude Opus 4.5 Thinking",
      "reasoning": true,
      "input": ["text"],
      "cost": {
        "input": 0,
        "output": 0,
        "cacheRead": 0,
        "cacheWrite": 0
      },
      "contextWindow": 200000,
      "maxTokens": 8192
    }
  ]
}' > /tmp/openclaw-temp.json && mv /tmp/openclaw-temp.json ~/.openclaw/openclaw.json

cat ~/.openclaw/openclaw.json | jq '.models.providers["local-google"] = {
  "baseUrl": "http://127.0.0.1:8045/v1beta",
  "apiKey": "你的User_Token",
  "auth": "api-key",
  "api": "google-generative-ai",
  "models": [
    {
      "id": "gemini-3-pro-image",
      "name": "Local Gemini 3 Pro Image",
      "reasoning": false,
      "input": ["text", "image"],
      "cost": {
        "input": 0,
        "output": 0,
        "cacheRead": 0,
        "cacheWrite": 0
      },
      "contextWindow": 2000000,
      "maxTokens": 8192
    }
  ]
}' > /tmp/openclaw-temp.json && mv /tmp/openclaw-temp.json ~/.openclaw/openclaw.json

openclaw models list

Model                                      Input      Ctx      Local Auth  Tags
local-anthropic/claude-sonnet-4-5-20250929 text       195k     yes   yes   default
local-anthropic-opus/claude-opus-4-5-thinking text    195k     yes   yes   configured
local-google/gemini-3-pro-image            text,image 1953k    yes   yes   configured

openclaw gateway restart

openclaw message send "你好，介绍一下你自己"

openclaw message send "写1个Python脚本，打印Hello World"

openclaw config set agents.defaults.model.primary "local-anthropic-opus/claude-opus-4-5-thinking"
openclaw gateway restart

openclaw config set agents.defaults.model.primary "local-google/gemini-3-pro-image"
openclaw gateway restart

# Use Opus Thinking
openclaw agent --model "local-anthropic-opus/claude-opus-4-5-thinking" --message "解释量子计算的原理"

# Use Gemini Image
openclaw agent --model "local-google/gemini-3-pro-image" --message "分析这张图片" --image ./photo.jpg

openclaw config set agents.defaults.models."local-anthropic/claude-sonnet-4-5-20250929".alias "我的Claude"

cat ~/.openclaw/openclaw.json | jq '.models.providers["local-anthropic-2"] = {
  "baseUrl": "http://127.0.0.1:8045",
  "apiKey": "另1个User_Token",
  "auth": "api-key",
  "api": "anthropic-messages",
  "models": [...]
}' > /tmp/openclaw-temp.json && mv /tmp/openclaw-temp.json ~/.openclaw/openclaw.json

{
  "cost": {
    "input": 0.003,
    "output": 0.015,
    "cacheRead": 0.0003,
    "cacheWrite": 0.00375
  }
}

cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.backup

cp ~/.openclaw/openclaw.json.backup ~/.openclaw/openclaw.json
openclaw gateway restart

# View model list
openclaw models list

# View current default model
openclaw config get agents.defaults.model.primary

# Switch default model
openclaw config set agents.defaults.model.primary "模型ID"

# Restart Gateway
openclaw gateway restart

# View configuration file
cat ~/.openclaw/openclaw.json | jq '.models.providers'

# Send message
openclaw message send "你的消息"

# Temporarily use a specific model
openclaw agent --model "模型ID" --message "你的消息"

local-anthropic/claude-sonnet-4-5-20250929
local-anthropic-opus/claude-opus-4-5-thinking
local-google/gemini-3-pro-image

# Check configuration file
cat ~/.openclaw/openclaw.json | jq '.models.providers'

# If an error is returned, restore backup
cp ~/.openclaw/openclaw.json.backup ~/.openclaw/openclaw.json

# Check if API is normal
curl http://127.0.0.1:8045/v1/models

# Check port occupation (macOS/Linux)
lsof -i :8045

# Restart Antigravity Manager

openclaw gateway restart

### 10.1.5 Practical Cases

**Case 1: Configure Claude Sonnet**

**Case 2: Multi-Account Management**

---

## 11.2 Multi-Model Switching Strategy

### 11.2.1 Model Feature Comparison

| Model | Advantages | Disadvantages | Applicable Scenarios |
|------|------|------|----------|
| Claude Sonnet | Good balance | Medium price | Daily conversation |
| Claude Opus | Strongest capability | Most expensive | Complex tasks |
| GPT-5.2 | Rich features | Slower response | Creative work |
| Gemini 3 Pro | Large free tier | Average capability | Simple tasks |
| DeepSeek-V3 | High cost-effectiveness | Chinese optimized | Programming tasks |

### 11.2.2 Scenario-Based Selection Strategy

**Daily Conversation**:

**Complex Reasoning**:

**Image Recognition**:

**Programming Tasks**:

### 11.2.3 Model Disaster Recovery Mechanism (Fallback)

> 🛡️ **High Availability Guarantee**: Ensure uninterrupted service by configuring primary and fallback models.

#### What is Model Disaster Recovery?

When the primary model encounters the following situations, the system will automatically switch to fallback models:
- API call failure
- Request timeout
- Rate Limit
- Service unavailability

<img src="https://upload.maynor1024.live/file/1771085328347_service-disaster-recovery.png" alt="Service Disaster Recovery Configuration Example" />

#### Basic Disaster Recovery Configuration

**Configuration file path**: `~/.openclaw/openclaw.json`

```json
{
  "agents": {
    "defaults": {
      "model": {
        "primary": "anthropic/claude-opus-4-6",
        "fallbacks": [
          "openai-codex/gpt-5.3-codex",
          "google-antigravity/claude-opus-4-6-thinking"
        ]
      }
    },
    "list": [
      {
        "id": "main",
        "default": true,
        "model": {
          "primary": "anthropic/claude-opus-4-6",
          "fallbacks": [
            "openai-codex/gpt-5.3-codex",
            "google-antigravity/claude-opus-4-6-thinking"
          ]
        }
      }
    ]
  }
}

1. Attempt to use primary model: anthropic/claude-opus-4-6
   ↓ Failure
2. Switch to fallback model 1: openai-codex/gpt-5.3-codex
   ↓ Failure
3. Switch to fallback model 2: google-antigravity/claude-opus-4-6-thinking
   ↓ Failure
4. Return error message

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "deepseek/deepseek-chat",
        "fallbacks": [
          "anthropic/claude-sonnet-4-5",
          "anthropic/claude-opus-4-6"
        ]
      }
    }
  }
}

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "anthropic/claude-opus-4-6",
        "fallbacks": [
          "anthropic/claude-sonnet-4-5",
          "deepseek/deepseek-chat"
        ]
      }
    }
  }
}

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "anthropic/claude-sonnet-4-5",
        "fallbacks": [
          "openai/gpt-4o",
          "google/gemini-2.0-flash-exp",
          "deepseek/deepseek-chat"
        ]
      }
    }
  }
}

# Set primary model
openclaw config set agents.defaults.model.primary "anthropic/claude-opus-4-6"

# Set fallback models (requires manual JSON editing)
# Or use jq command
cat ~/.openclaw/openclaw.json | jq '.agents.defaults.model.fallbacks = [
  "openai-codex/gpt-5.3-codex",
  "google-antigravity/claude-opus-4-6-thinking"
]' > /tmp/openclaw-temp.json && mv /tmp/openclaw-temp.json ~/.openclaw/openclaw.json

# Restart Gateway for configuration to take effect
openclaw gateway restart

# View current configuration
openclaw config get agents.defaults.model

# Output example:
{
  "primary": "anthropic/claude-opus-4-6",
  "fallbacks": [
    "openai-codex/gpt-5.3-codex",
    "google-antigravity/claude-opus-4-6-thinking"
  ]
}

✅ Recommended: Anthropic → OpenAI → Google
❌ Not recommended: Claude Opus → Claude Sonnet (same provider)

✅ Recommended: High capability → Medium capability → Low capability
❌ Not recommended: Low capability → High capability (wastes resources)

✅ Recommended: Cheap → Medium → Expensive (cost optimization)
✅ Recommended: Expensive → Medium → Cheap (quality priority)

✅ Recommended: 2-3 fallback models
❌ Not recommended: 5+ fallback models (overly complex)

{
  "auth": {
    "profiles": {
      "openai-codex:default": {
        "provider": "openai-codex",
        "mode": "oauth"
      },
      "anthropic:default": {
        "provider": "anthropic",
        "mode": "token"
      },
      "anthropic:manual": {
        "provider": "anthropic",
        "mode": "token"
      },
      "google-antigravity:mail1@gmail.com": {
        "provider": "google-antigravity",
        "mode": "oauth",
        "email": "mail1@gmail.com"
      },
      "google-antigravity:mail2@gmail.com": {
        "provider": "google-antigravity",
        "mode": "oauth"
      }
    },
    "order": {
      "anthropic": [
        "anthropic:default",
        "anthropic:manual"
      ],
      "google-antigravity": [
        "google-antigravity:mail1@gmail.com",
        "google-antigravity:mail2@gmail.com"
      ]
    }
  }
}

{
  "auth": {
    "profiles": {
      "anthropic:account1": {
        "provider": "anthropic",
        "mode": "token"
      },
      "anthropic:account2": {
        "provider": "anthropic",
        "mode": "token"
      }
    },
    "order": {
      "anthropic": [
        "anthropic:account1",
        "anthropic:account2"
      ]
    }
  }
}

# Configure two API Keys separately in Antigravity Manager
# Or add in OpenClaw configuration:
{
  "models": {
    "providers": {
      "anthropic": {
        "apiKey": "sk-ant-api-key-1",
        ...
      },
      "anthropic-2": {
        "apiKey": "sk-ant-api-key-2",
        ...
      }
    }
  }
}

1. Use account1 to send request
2. account1 reaches rate limit → automatically switches to account2
3. account2 reaches rate limit → waits for account1 to recover
4. Repeats

{
  "auth": {
    "profiles": {
      "google-antigravity:work@gmail.com": {
        "provider": "google-antigravity",
        "mode": "oauth",
        "email": "work@gmail.com"
      },
      "google-antigravity:personal@gmail.com": {
        "provider": "google-antigravity",
        "mode": "oauth",
        "email": "personal@gmail.com"
      },
      "google-antigravity:backup@gmail.com": {
        "provider": "google-antigravity",
        "mode": "oauth",
        "email": "backup@gmail.com"
      }
    },
    "order": {
      "google-antigravity": [
        "google-antigravity:work@gmail.com",
        "google-antigravity:personal@gmail.com",
        "google-antigravity:backup@gmail.com"
      ]
    }
  }
}

{
  "auth": {
    "profiles": {
      "anthropic:oauth-account": {
        "provider": "anthropic",
        "mode": "oauth"
      },
      "anthropic:token-account": {
        "provider": "anthropic",
        "mode": "token"
      }
    },
    "order": {
      "anthropic": [
        "anthropic:oauth-account",
        "anthropic:token-account"
      ]
    }
  }
}

✅ Recommended: 2-3 accounts
❌ Not recommended: 5+ accounts (complex to manage)

OAuth: More secure, suitable for personal accounts
Token: More stable, suitable for API keys

✅ Sort by usage frequency (high frequency → low frequency)
✅ Sort by account level (paid → free)

# View currently used authentication configuration
openclaw config get auth.profiles

# Test if authentication is valid
openclaw test api

{
  "rules": [
    {
      "condition": "task.type === 'code'",
      "model": "deepseek-v3"
    },
    {
      "condition": "task.type === 'image'",
      "model": "gemini-3-pro"
    },
    {
      "condition": "task.complexity === 'high'",
      "model": "claude-opus-4.6"
    },
    {
      "condition": "default",
      "model": "claude-sonnet-4.5"
    }
  ]
}

{
  "rules": [
    {
      "condition": "cost.daily < 10",
      "model": "claude-opus-4.6"
    },
    {
      "condition": "cost.daily >= 10",
      "model": "claude-sonnet-4.5"
    }
  ]
}

{
  "agents": {
    "defaults": {
      "memorySearch": {
        "sources": ["memory", "sessions"],
        "experimental": {
          "sessionMemory": true
        },
        "provider": "gemini",
        "remote": {
          "apiKey": "AIzaSy**************************"
        },
        "fallback": "gemini",
        "model": "gemini-embedding-001",
        "query": {
          "hybrid": {
            "enabled": true,
            "vectorWeight": 0.7,
            "textWeight": 0.3
          }
        }
      }
    }
  }
}

{
  "sources": ["memory", "sessions"]
}

// Use only long-term memory
"sources": ["memory"]

// Use both long-term memory and session records
"sources": ["memory", "sessions"]

{
  "experimental": {
    "sessionMemory": true
  }
}

{
  "provider": "gemini"
}

{
  "remote": {
    "apiKey": "AIzaSy**************************"
  }
}

{
  "fallback": "gemini"
}

{
  "model": "gemini-embedding-001"
}

{
  "query": {
    "hybrid": {
      "enabled": true,
      "vectorWeight": 0.7,
      "textWeight": 0.3
    }
  }
}

Semantic search priority: vectorWeight: 0.7, textWeight: 0.3
Keyword search priority: vectorWeight: 0.3, textWeight: 0.7
Balanced mode: vectorWeight: 0.5, textWeight: 0.5

{
  "agents": {
    "defaults": {
      "memorySearch": {
        "sources": ["memory", "sessions"],
        "experimental": {
          "sessionMemory": true
        },
        "provider": "gemini",
        "remote": {
          "apiKey": "你的Gemini_API_Key"
        },
        "model": "gemini-embedding-001",
        "query": {
          "hybrid": {
            "enabled": true,
            "vectorWeight": 0.7,
            "textWeight": 0.3
          }
        }
      }
    }
  }
}

{
  "agents": {
    "defaults": {
      "memorySearch": {
        "sources": ["memory", "sessions"],
        "experimental": {
          "sessionMemory": true
        },
        "provider": "openai",
        "remote": {
          "apiKey": "sk-your-openai-api-key"
        },
        "fallback": "gemini",
        "model": "text-embedding-3-large",
        "query": {
          "hybrid": {
            "enabled": true,
            "vectorWeight": 0.8,
            "textWeight": 0.2
          }
        }
      }
    }
  }
}

{
  "agents": {
    "defaults": {
      "memorySearch": {
        "sources": ["memory", "sessions"],
        "experimental": {
          "sessionMemory": true
        },
        "provider": "local",
        "model": "all-MiniLM-L6-v2",
        "query": {
          "hybrid": {
            "enabled": true,
            "vectorWeight": 0.6,
            "textWeight": 0.4
          }
        }
      }
    }
  }
}

# Enable Memory Search
openclaw config set agents.defaults.memorySearch.experimental.sessionMemory true

# Set provider
openclaw config set agents.defaults.memorySearch.provider "gemini"

# Set API Key (requires manual JSON editing)
# Or use jq command
cat ~/.openclaw/openclaw.json | jq '.agents.defaults.memorySearch.remote.apiKey = "你的API_Key"' > /tmp/openclaw-temp.json && mv /tmp/openclaw-temp.json ~/.openclaw/openclaw.json

# Restart Gateway
openclaw gateway restart

# View current configuration
openclaw config get agents.defaults.memorySearch

# Test memory search
openclaw message send "记住：我喜欢喝咖啡"
openclaw message send "我喜欢喝什么？"

# Should return: According to my memory, you like to drink coffee.

You: Remember my birthday is January 1, 1990
OpenClaw: Okay, remembered.

(A few days later)
You: When is my birthday?
OpenClaw: According to my memory, your birthday is January 1, 1990.

You: Project A's deadline is March 1, 2026
OpenClaw: Noted.

(A week later)
You: When is Project A due?
OpenClaw: Project A's deadline is March 1, 2026.

You: DeepSeek API price is $0.001/thousand tokens
OpenClaw: Remembered.

(Next conversation)
You: Which model is the cheapest?
OpenClaw: According to my memory, DeepSeek is the cheapest, priced at $0.001/thousand tokens.
### 11.3.10 Best Practices

**1. Choose the Right Provider**:

**2. Adjust Hybrid Retrieval Weight**:

**3. Regularly Clean Memory**:
```bash
# 清理过期记忆
openclaw memory clean --older-than 30d

# 查看记忆使用情况
openclaw memory stats

# Clean expired memory
openclaw memory clean --older-than 30d

# View memory usage
openclaw memory stats

# 导出记忆
openclaw memory export --output memory-backup.json

# 导入记忆
openclaw memory import memory-backup.json

# Export memory
openclaw memory export --output memory-backup.json

# Import memory
openclaw memory import memory-backup.json

# 检查配置
openclaw config get agents.defaults.memorySearch

# 测试 API Key
curl -H "Content-Type: application/json" \
  -d '{"contents":[{"parts":[{"text":"test"}]}]}' \
  "https://generativelanguage.googleapis.com/v1beta/models/gemini-embedding-001:embedContent?key=你的API_Key"

# Check configuration
openclaw config get agents.defaults.memorySearch

# Test API Key
curl -H "Content-Type: application/json" \
  -d '{"contents":[{"parts":[{"text":"test"}]}]}' \
  "https://generativelanguage.googleapis.com/v1beta/models/gemini-embedding-001:embedContent?key=你的API_Key"

// 调整权重
{
  "query": {
    "hybrid": {
      "vectorWeight": 0.8,  // 提高语义搜索权重
      "textWeight": 0.2
    }
  }
}

// Adjust weights
{
  "query": {
    "hybrid": {
      "vectorWeight": 0.8,  // Increase semantic search weight
      "textWeight": 0.2
    }
  }
}

# 查看记忆大小
openclaw memory stats

# 清理旧记忆
openclaw memory clean --older-than 60d

# 压缩记忆数据库
openclaw memory compact

# View memory size
openclaw memory stats

# Clean old memory
openclaw memory clean --older-than 60d

# Compact memory database
openclaw memory compact

# 查看今日消耗
openclaw stats today

# 输出示例：
今日Token消耗：
- Claude Sonnet：150K tokens ($0.75)
- Gemini Pro：50K tokens ($0.00)
- 总计：200K tokens ($0.75)

任务分布：
- 文件搜索：30%
- 日程管理：20%
- 知识管理：25%
- 其他：25%

# View today's consumption
openclaw stats today

# Output example:
Today's Token Consumption:
- Claude Sonnet：150K tokens ($0.75)
- Gemini Pro：50K tokens ($0.00)
- Total：200K tokens ($0.75)

Task Distribution:
- File Search：30%
- Schedule Management：20%
- Knowledge Management：25%
- Other：25%

⚠️ 高消耗任务：
- 文件搜索：每次10K tokens
- 建议：优化搜索范围

✅ 优化方案：
- 使用缓存
- 减少上下文
- 优化提示词

⚠️ High Consumption Tasks:
- File Search: 10K tokens per search
- Suggestion: Optimize search scope

✅ Optimization Solutions:
- Use caching
- Reduce context
- Optimize prompts

# 启用响应缓存
openclaw config set cache.enabled true

# 设置缓存时间（小时）
openclaw config set cache.ttl 24

# 设置缓存大小（MB）
openclaw config set cache.maxSize 1000

# Enable response caching
openclaw config set cache.enabled true

# Set cache time (hours)
openclaw config set cache.ttl 24

# Set cache size (MB)
openclaw config set cache.maxSize 1000

未启用缓存：
- 相同问题每次都调用API
- Token消耗：10K/次
- 成本：$0.05/次

启用缓存后：
- 相同问题直接返回缓存
- Token消耗：0
- 成本：$0
- 节省：100%

Without caching:
- Same question calls API every time
- Token consumption: 10K/call
- Cost: $0.05/call

With caching enabled:
- Same question returns cached response directly
- Token consumption: 0
- Cost: $0
- Savings: 100%

1. 简单任务用便宜模型
2. 复杂任务用贵模型
3. 失败后降级重试

1. Use cheaper models for simple tasks
2. Use more expensive models for complex tasks
3. Downgrade and retry after failure

{
  "fallback": [
    "claude-opus-4.6",    // 首选
    "claude-sonnet-4.5",  // 降级1
    "gemini-3-pro"        // 降级2
  ]
}

{
  "fallback": [
    "claude-opus-4.6",    // Primary
    "claude-sonnet-4.5",  // Fallback 1
    "gemini-3-pro"        // Fallback 2
  ]
}

原方案：
- 全部使用Claude Opus
- 日均消耗：$20

优化方案：
- 简单任务用Sonnet
- 复杂任务用Opus
- 启用缓存

优化后：
- 日均消耗：$10
- 节省：50%

Original plan:
- All tasks use Claude Opus
- Daily consumption: $20

Optimized plan:
- Simple tasks use Sonnet
- Complex tasks use Opus
- Enable caching

After optimization:
- Daily consumption: $10
- Savings: 50%

策略：
1. 优先使用Gemini（免费额度大）
2. 超额后切换到DeepSeek（便宜）
3. 重要任务用Claude

效果：
- 月成本：$5
- 节省：90%

Strategy:
1. Prioritize Gemini (large free quota)
2. Switch to DeepSeek after exceeding quota (cheaper)
3. Use Claude for important tasks

Effect:
- Monthly cost: $5
- Savings: 90%

平均响应时间：5秒
用户体验：一般

Average response time: 5 seconds
User experience: Average

1. 启用缓存
2. 减少上下文
3. 使用流式输出
4. 并发处理

1. Enable caching
2. Reduce context
3. Use streaming output
4. Concurrent processing

平均响应时间：2秒
用户体验：优秀
提升：60%

Average response time: 2 seconds
User experience: Excellent
Improvement: 60%

# 设置最大并发数
openclaw config set concurrency.max 5

# 设置队列大小
openclaw config set concurrency.queueSize 100

# Set maximum concurrency
openclaw config set concurrency.max 5

# Set queue size
openclaw config set concurrency.queueSize 100

# 查看内存使用
openclaw stats memory

# 输出示例：
内存使用情况：
- 当前：512MB
- 峰值：800MB
- 平均：600MB

# View memory usage
openclaw stats memory

# Output example:
Memory Usage:
- Current: 512MB
- Peak: 800MB
- Average: 600MB

⚠️ 内存占用高：
- 清理缓存
- 减少并发
- 重启服务

⚠️ High memory usage:
- Clear cache
- Reduce concurrency
- Restart service

openclaw onboard

◇  初始化模式
│  快速开始

◇  Initialization Mode
│  Quick Start

◆  模型/认证提供商
│  ○ OpenAI (Codex OAuth + API key)
│  ○ Anthropic
│  ○ MiniMax
│  ○ Moonshot AI
│  ○ Google
│  ○ OpenRouter
│  ○ Qwen
│  ○ Z.AI (GLM 4.7)
│  ○ Copilot
│  ○ Vercel AI Gateway
│  ○ OpenCode Zen
│  ○ Xiaomi
│  ○ Synthetic
│  ○ Venice AI
│  ○ Skip for now

# 查看已配置的模型
openclaw models list

# 测试模型连接
openclaw message send "你好，测试一下"

# View configured models
openclaw models list

# Test model connection
openclaw message send "Hello, test it out"

openclaw onboard

{
  "models": {
    "mode": "merge",
    "providers": {
      "openai": {
        "baseUrl": "https://api.openai.com/v1",
        "apiKey": "sk-your-api-key",
        "auth": "api-key",
        "api": "openai-chat",
        "models": [
          {
            "id": "gpt-4o",
            "name": "GPT-4o",
            "contextWindow": 128000,
            "maxTokens": 16384
          },
          {
            "id": "gpt-4o-mini",
            "name": "GPT-4o Mini",
            "contextWindow": 128000,
            "maxTokens": 16384
          }
        ]
      }
    }
  }
}

{
  "models": {
    "mode": "merge",
    "providers": {
      "anthropic": {
        "baseUrl": "https://api.anthropic.com",
        "apiKey": "sk-ant-your-api-key",
        "auth": "api-key",
        "api": "anthropic",
        "models": [
          {
            "id": "claude-3-5-sonnet-20241022",
            "name": "Claude 3.5 Sonnet",
            "contextWindow": 200000,
            "maxTokens": 8192
          },
          {
            "id": "claude-3-opus-20240229",
            "name": "Claude 3 Opus",
            "contextWindow": 200000,
            "maxTokens": 4096
          }
        ]
      }
    }
  }
}

{
  "models": {
    "mode": "merge",
    "providers": {
      "google": {
        "baseUrl": "https://generativelanguage.googleapis.com/v1beta",
        "apiKey": "your-google-api-key",
        "auth": "api-key",
        "api": "google-ai",
        "models": [
          {
            "id": "gemini-2.0-flash-exp",
            "name": "Gemini 2.0 Flash",
            "contextWindow": 1000000,
            "maxTokens": 8192
          },
          {
            "id": "gemini-1.5-pro",
            "name": "Gemini 1.5 Pro",
            "contextWindow": 2000000,
            "maxTokens": 8192
          }
        ]
      }
    }
  }
}

{
  "models": {
    "mode": "merge",
    "providers": {
      "deepseek": {
        "baseUrl": "https://api.deepseek.com",
        "apiKey": "sk-your-api-key",
        "auth": "api-key",
        "api": "openai-chat",
        "models": [
          {
            "id": "deepseek-chat",
            "name": "DeepSeek Chat",
            "contextWindow": 64000,
            "maxTokens": 4096
          },
          {
            "id": "deepseek-coder",
            "name": "DeepSeek Coder",
            "contextWindow": 64000,
            "maxTokens": 4096
          }
        ]
      }
    }
  }
}

{
  "models": {
    "mode": "merge",
    "providers": {
      "moonshot": {
        "baseUrl": "https://api.moonshot.cn/v1",
        "apiKey": "sk-your-api-key",
        "auth": "api-key",
        "api": "openai-chat",
        "models": [
          {
            "id": "moonshot-v1-8k",
            "name": "Kimi k2.5 8K",
            "contextWindow": 8000,
            "maxTokens": 4096
          },
          {
            "id": "moonshot-v1-32k",
            "name": "Kimi k2.5 32K",
            "contextWindow": 32000,
            "maxTokens": 4096
          },
          {
            "id": "moonshot-v1-128k",
            "name": "Kimi k2.5 128K",
            "contextWindow": 128000,
            "maxTokens": 4096
          }
        ]
      }
    }
  }
}

{
  "models": {
    "mode": "merge",
    "providers": {
      "ollama": {
        "baseUrl": "http://localhost:11434",
        "auth": "none",
        "api": "ollama",
        "models": [
          {
            "id": "llama3.1:8b",
            "name": "Llama 3.1 8B",
            "contextWindow": 128000,
            "maxTokens": 4096
          },
          {
            "id": "qwen2.5:7b",
            "name": "Qwen 2.5 7B",
            "contextWindow": 32000,
            "maxTokens": 4096
          }
        ]
      }
    }
  }
}

{
  "models": {
    "mode": "merge",
    "providers": {
      "deepseek": {
        "baseUrl": "https://api.deepseek.com",
        "apiKey": "sk-deepseek-key",
        "auth": "api-key",
        "api": "openai-chat",
        "models": [
          {
            "id": "deepseek-chat",
            "name": "DeepSeek Chat",
            "contextWindow": 64000,
            "maxTokens": 4096
          }
        ]
      },
      "anthropic": {
        "baseUrl": "https://api.anthropic.com",
        "apiKey": "sk-ant-key",
        "auth": "api-key",
        "api": "anthropic",
        "models": [
          {
            "id": "claude-3-5-sonnet-20241022",
            "name": "Claude 3.5 Sonnet",
            "contextWindow": 200000,
            "maxTokens": 8192
          }
        ]
      },
      "ollama": {
        "baseUrl": "http://localhost:11434",
        "auth": "none",
        "api": "ollama",
        "models": [
          {
            "id": "llama3.1:8b",
            "name": "Llama 3.1 8B",
            "contextWindow": 128000,
            "maxTokens": 4096
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "deepseek/deepseek-chat",
        "fallback": [
          "anthropic/claude-3-5-sonnet-20241022",
          "ollama/llama3.1:8b"
        ]
      }
    }
  }
}

// 编程任务
"deepseek/deepseek-coder"

// 长文档处理
"moonshot/moonshot-v1-128k"

// 复杂推理
"anthropic/claude-3-opus-20240229"

// 日常对话
"deepseek/deepseek-chat"

// 多模态（图片）
"google/gemini-2.0-flash-exp"

// 本地隐私
"ollama/llama3.1:8b"

// Programming tasks
"deepseek/deepseek-coder"

// Long document processing
"moonshot/moonshot-v1-128k"

// Complex reasoning
"anthropic/claude-3-opus-20240229"

// Daily conversation
"deepseek/deepseek-chat"

// Multimodal (images)
"google/gemini-2.0-flash-exp"

// Local privacy
"ollama/llama3.1:8b"

极低成本：DeepSeek ($0.001/千tokens)
低成本：Kimi, GLM-4 ($0.01/千tokens)
中等成本：Gemini, Mistral ($0.05/千tokens)
高成本：Claude, GPT-4 ($0.15/千tokens)
免费：Ollama（本地）

Very Low Cost: DeepSeek ($0.001/thousand tokens)
Low Cost: Kimi, GLM-4 ($0.01/thousand tokens)
Medium Cost: Gemini, Mistral ($0.05/thousand tokens)
High Cost: Claude, GPT-4 ($0.15/thousand tokens)
Free: Ollama (local)

openclaw tools list

openclaw tools enable read_file write_file

openclaw tools disable execute_command

{
  "tools": {
    "enabled": [
      "read_file",
      "write_file",
      "list_directory",
      "web_search"
    ],
    "disabled": [
      "execute_command",
      "delete_file"
    ]
  }
}

{
  "tools": {
    "permissions": {
      "read_file": {
        "allowedPaths": [
          "~/Documents",
          "~/Downloads"
        ],
        "deniedPaths": [
          "~/.ssh",
          "~/.openclaw"
        ]
      },
      "execute_command": {
        "allowedCommands": [
          "ls",
          "cat",
          "grep"
        ],
        "deniedCommands": [
          "rm",
          "sudo"
        ]
      }
    }
  }
}

// ~/.openclaw/tools/my-tool.js
export default {
  name: "my_custom_tool",
  description: "我的自定义工具",
  parameters: {
    type: "object",
    properties: {
      input: {
        type: "string",
        description: "输入参数"
      }
    },
    required: ["input"]
  },
  async execute({ input }) {
    // 工具逻辑
    return {
      success: true,
      result: `处理结果: ${input}`
    };
  }
};

// ~/.openclaw/tools/my-tool.js
export default {
  name: "my_custom_tool",
  description: "My custom tool",
  parameters: {
    type: "object",
    properties: {
      input: {
        type: "string",
        description: "Input parameter"
      }
    },
    required: ["input"]
  },
  async execute({ input }) {
    // Tool logic
    return {
      success: true,
      result: `Processing result: ${input}`
    };
  }
};

openclaw tools register ~/.openclaw/tools/my-tool.js

你：帮我找到所有包含"发票"的 PDF 文件

OpenClaw 使用工具：
1. search_files(pattern="*.pdf", content="发票")
2. 返回结果：找到 3 个文件
   - 发票_2024_01.pdf
   - 报销发票.pdf
   - 采购发票_Q1.pdf

You: Help me find all PDF files containing "invoice"

OpenClaw uses tool:
1. search_files(pattern="*.pdf", content="invoice")
2. Returns result: Found 3 files
   - Invoice_2024_01.pdf
   - Expense_Invoice.pdf
   - Procurement_Invoice_Q1.pdf

你：Claude 3.5 Sonnet 最新价格是多少？

OpenClaw 使用工具：
1. web_search(query="Claude 3.5 Sonnet pricing")
2. fetch_url(url="https://www.anthropic.com/pricing")
3. 返回结果：
   - 输入：$3/百万 tokens
   - 输出：$15/百万 tokens

You: What is the latest price for Claude 3.5 Sonnet?

OpenClaw uses tool:
1. web_search(query="Claude 3.5 Sonnet pricing")
2. fetch_url(url="https://www.anthropic.com/pricing")
3. Returns result:
   - Input: $3/million tokens
   - Output: $15/million tokens

你：分析这个 CSV 文件的销售数据

OpenClaw 使用工具：
1. read_file(path="sales.csv")
2. parse_csv(content=...)
3. 分析数据并生成报告

You: Analyze the sales data in this CSV file

OpenClaw uses tool:
1. read_file(path="sales.csv")
2. parse_csv(content=...)
3. Analyze data and generate report

任务：下载网页并保存为 Markdown

工具链：
1. fetch_url(url) → 获取网页内容
2. extract_text(html) → 提取文本
3. convert_to_markdown(text) → 转换格式
4. write_file(path, content) → 保存文件

Task: Download webpage and save as Markdown

Toolchain:
1. fetch_url(url) → Get webpage content
2. extract_text(html) → Extract text
3. convert_to_markdown(text) → Convert format
4. write_file(path, content) → Save file

{
  "tools": {
    "enabled": [
      "read_file",  // 只启用必要的工具
      "web_search"
    ]
  }
}

{
  "tools": {
    "enabled": [
      "read_file",  // Only enable necessary tools
      "web_search"
    ]
  }
}

{
  "tools": {
    "permissions": {
      "read_file": {
        "allowedPaths": ["~/Documents"]  // 限制访问范围
      }
    }
  }
}

{
  "tools": {
    "permissions": {
      "read_file": {
        "allowedPaths": ["~/Documents"]  // Restrict access scope
      }
    }
  }
}

{
  "tools": {
    "permissions": {
      "execute_command": {
        "allowedCommands": ["ls", "cat"]  // 只允许安全命令
      }
    }
  }
}

{
  "tools": {
    "permissions": {
      "execute_command": {
        "allowedCommands": ["ls", "cat"]  // Only allow safe commands
      }
    }
  }
}

# 查看版本
openclaw --version
openclaw -v

# 查看帮助
openclaw --help
openclaw -h

# 查看子命令帮助
openclaw gateway --help

# View version
openclaw --version
openclaw -v

# View help
openclaw --help
openclaw -h

# View subcommand help
openclaw gateway --help

# 运行配置向导
openclaw onboard

# 快速开始向导
openclaw setup

# 查看配置
openclaw config list

# 获取配置项
openclaw config get models.providers

# 设置配置项
openclaw config set gateway.port 18790

# 删除配置项
openclaw config delete models.providers.test

# Run configuration wizard
openclaw onboard

# Quick start wizard
openclaw setup

# View configuration
openclaw config list

# Get configuration item
openclaw config get models.providers

# Set configuration item
openclaw config set gateway.port 18790

# Delete configuration item
openclaw config delete models.providers.test

# 安装/启动 Gateway
openclaw gateway install

# 查看状态
openclaw gateway status

# 停止 Gateway
openclaw gateway stop

# 重启 Gateway
openclaw gateway restart

# 查看日志
openclaw logs
openclaw logs --follow
openclaw logs --tail 100

# 清理日志
openclaw logs clear

# Install/Start Gateway
openclaw gateway install

# View status
openclaw gateway status

# Stop Gateway
openclaw gateway stop

# Restart Gateway
openclaw gateway restart

# View logs
openclaw logs
openclaw logs --follow
openclaw logs --tail 100

# Clear logs
openclaw logs clear

# 列出所有渠道
openclaw channels list

# 查看渠道状态
openclaw channels status

# 添加渠道
openclaw channels add

# 删除渠道
openclaw channels remove feishu

# 测试渠道
openclaw channels test feishu

# List all channels
openclaw channels list

# View channel status
openclaw channels status

# Add channel
openclaw channels add

# Delete channel
openclaw channels remove feishu

# Test channel
openclaw channels test feishu

# 列出配对请求
openclaw pairing list
openclaw pairing list feishu

# 批准配对
openclaw pairing approve feishu <CODE>

# 拒绝配对
openclaw pairing reject feishu <CODE>

# 清理过期配对
openclaw pairing cleanup

# List pairing requests
openclaw pairing list
openclaw pairing list feishu

# Approve pairing
openclaw pairing approve feishu <CODE>

# Reject pairing
openclaw pairing reject feishu <CODE>

# Clean up expired pairings
openclaw pairing cleanup

# 列出已安装插件
openclaw plugins list

# 搜索插件
openclaw plugins search feishu

# 安装插件
openclaw plugins install @openclaw/feishu

# 卸载插件
openclaw plugins uninstall @openclaw/feishu

# 更新插件
openclaw plugins update @openclaw/feishu

# 更新所有插件
openclaw plugins update --all

# List installed plugins
openclaw plugins list

# Search plugins
openclaw plugins search feishu

# Install plugin
openclaw plugins install @openclaw/feishu

# Uninstall plugin
openclaw plugins uninstall @openclaw/feishu

# Update plugin
openclaw plugins update @openclaw/feishu

# Update all plugins
openclaw plugins update --all

# 列出所有工具
openclaw tools list

# 启用工具
openclaw tools enable read_file write_file

# 禁用工具
openclaw tools disable execute_command

# 注册自定义工具
openclaw tools register ~/my-tool.js

# 测试工具
openclaw tools test read_file

# List all tools
openclaw tools list

# Enable tools
openclaw tools enable read_file write_file

# Disable tools
openclaw tools disable execute_command

# Register custom tool
openclaw tools register ~/my-tool.js

# Test tool
openclaw tools test read_file

# 列出 Agents
openclaw agents list

# 创建 Agent
openclaw agents create my-agent

# 删除 Agent
openclaw agents delete my-agent

# 切换 Agent
openclaw agents switch my-agent

# 查看 Agent 配置
openclaw agents config my-agent

# List Agents
openclaw agents list

# Create Agent
openclaw agents create my-agent

# Delete Agent
openclaw agents delete my-agent

# Switch Agent
openclaw agents switch my-agent

# View Agent configuration
openclaw agents config my-agent

# 列出会话
openclaw sessions list

# 查看会话详情
openclaw sessions show `<session-id>`

# 删除会话
openclaw sessions delete `<session-id>`

# 清理所有会话
openclaw sessions clear

# 导出会话
openclaw sessions export `<session-id>` --output session.json

# 导入会话
openclaw sessions import session.json

# List sessions
openclaw sessions list

# View session details
openclaw sessions show `<session-id>`

# Delete session
openclaw sessions delete `<session-id>`

# Clear all sessions
openclaw sessions clear

# Export session
openclaw sessions export `<session-id>` --output session.json

# Import session
openclaw sessions import session.json

# 查看统计信息
openclaw stats

# 查看今日统计
openclaw stats today

# 查看本周统计
openclaw stats week

# 查看 API 消耗
openclaw stats api

# 查看内存使用
openclaw stats memory

# 查看性能指标
openclaw stats performance

# View statistics
openclaw stats

# View today's statistics
openclaw stats today

# View this week's statistics
openclaw stats week

# View API consumption
openclaw stats api

# View memory usage
openclaw stats memory

# View performance metrics
openclaw stats performance

# 测试 API 连接
openclaw test api

# 测试渠道
openclaw test channel feishu

# 测试工具
openclaw test tool read_file

# 运行诊断
openclaw diagnose

# 检查配置
openclaw validate config

# 检查健康状态
openclaw health check

# Test API connection
openclaw test api

# Test channel
openclaw test channel feishu

# Test tool
openclaw test tool read_file

# Run diagnostics
openclaw diagnose

# Check configuration
openclaw validate config

# Check health status
openclaw health check

# 备份数据
openclaw backup create

# 列出备份
openclaw backup list

# 恢复备份
openclaw backup restore `<backup-id>`

# 清理缓存
openclaw cache clear

# 清理临时文件
openclaw cleanup temp

# 导出数据
openclaw export --output data.json

# 导入数据
openclaw import data.json

# Create backup
openclaw backup create

# List backups
openclaw backup list

# Restore backup
openclaw backup restore `<backup-id>`

# Clear cache
openclaw cache clear

# Clean up temporary files
openclaw cleanup temp

# Export data
openclaw export --output data.json

# Import data
openclaw import data.json