OpenClaw 中文教程

外观

OpenClaw 超级速查表

约 1452 字大约 5 分钟

2026-03-06

快速查找 OpenClaw 的常用命令、配置和技巧。

🚀 快速开始

安装命令

# Docker 安装（推荐）
docker pull openclaw/openclaw:latest
docker run -d -p 3000:3000 openclaw/openclaw

# npm 安装
npm install -g openclaw
openclaw start

# 源码安装
git clone https://github.com/openclaw/openclaw.git
cd openclaw
npm install
npm run build
npm start

基础配置

# 初始化配置
openclaw init

# 查看配置
openclaw config list

# 设置 API Key
openclaw config set OPENAI_API_KEY=sk-xxx
openclaw config set ANTHROPIC_API_KEY=sk-ant-xxx

🤖 模型配置

支持的模型提供商

提供商模型示例配置方式
OpenAIgpt-4, gpt-3.5-turboOPENAI_API_KEY
Anthropicclaude-3-opus, claude-3-sonnetANTHROPIC_API_KEY
Googlegemini-proGOOGLE_API_KEY
Azure OpenAIgpt-4AZURE_OPENAI_API_KEY
本地模型llama2, mistralOllama/LM Studio

模型配置示例

# config.yaml
models:
  - name: gpt-4
    provider: openai
    api_key: ${OPENAI_API_KEY}
    max_tokens: 4096
    temperature: 0.7
    
  - name: claude-3-opus
    provider: anthropic
    api_key: ${ANTHROPIC_API_KEY}
    max_tokens: 4096
    
  - name: local-llama
    provider: ollama
    base_url: http://localhost:11434
    model: llama2

📡 渠道接入

Discord 接入

# 1. 创建 Discord Bot
# 访问 https://discord.com/developers/applications

# 2. 配置 Bot Token
openclaw config set DISCORD_BOT_TOKEN=your_token

# 3. 启动 Discord 渠道
openclaw channel start discord

飞书接入

# 1. 配置飞书应用
openclaw config set FEISHU_APP_ID=cli_xxx
openclaw config set FEISHU_APP_SECRET=xxx

# 2. 启动飞书渠道
openclaw channel start feishu

# 3. 配置回调地址
# https://your-domain.com/api/feishu/webhook

Telegram 接入

# 1. 创建 Bot (@BotFather)
# 2. 配置 Token
openclaw config set TELEGRAM_BOT_TOKEN=your_token

# 3. 启动 Telegram 渠道
openclaw channel start telegram

微信接入

# 1. 安装 Wechaty
npm install wechaty wechaty-puppet-wechat

# 2. 配置微信
openclaw config set WECHAT_PUPPET=wechaty-puppet-wechat

# 3. 启动微信渠道
openclaw channel start wechat

🛠️ 技能管理

ClawHub 命令

# 搜索技能
openclaw skill search <keyword>

# 安装技能
openclaw skill install <skill-name>

# 列出已安装技能
openclaw skill list

# 更新技能
openclaw skill update <skill-name>

# 卸载技能
openclaw skill uninstall <skill-name>

# 启用/禁用技能
openclaw skill enable <skill-name>
openclaw skill disable <skill-name>

常用技能

技能名称功能描述安装命令
web-search网络搜索openclaw skill install web-search
code-interpreter代码执行openclaw skill install code-interpreter
image-generation图片生成openclaw skill install image-generation
file-operations文件操作openclaw skill install file-operations
database-query数据库查询openclaw skill install database-query

🌐 Gateway 配置

基础路由

# gateway.yaml
routes:
  - path: /api/chat
    model: gpt-4
    fallback: claude-3-opus
    
  - path: /api/completion
    model: gpt-3.5-turbo
    rate_limit: 100/minute
    
  - path: /api/embedding
    model: text-embedding-ada-002

负载均衡

# 轮询策略
load_balancing:
  strategy: round_robin
  models:
    - gpt-4
    - claude-3-opus
    - gemini-pro

# 权重策略
load_balancing:
  strategy: weighted
  models:
    - model: gpt-4
      weight: 50
    - model: claude-3-opus
      weight: 30
    - model: gemini-pro
      weight: 20

智能路由

# 基于内容路由
routing:
  - condition: "length > 2000"
    model: claude-3-opus
    
  - condition: "language == 'code'"
    model: gpt-4
    
  - condition: "type == 'creative'"
    model: claude-3-sonnet

🔧 高级配置

多 Agent 配置

# agents.yaml
agents:
  - name: researcher
    model: gpt-4
    system_prompt: "你是一个专业的研究助手"
    skills:
      - web-search
      - document-analysis
      
  - name: coder
    model: claude-3-opus
    system_prompt: "你是一个专业的编程助手"
    skills:
      - code-interpreter
      - github-integration
      
  - name: writer
    model: gemini-pro
    system_prompt: "你是一个专业的写作助手"
    skills:
      - grammar-check
      - style-improvement

工作流配置

# workflow.yaml
workflows:
  - name: research-and-write
    steps:
      - agent: researcher
        task: "研究主题"
        
      - agent: writer
        task: "撰写文章"
        input: "${researcher.output}"
        
      - agent: reviewer
        task: "审核内容"
        input: "${writer.output}"

记忆配置

# memory.yaml
memory:
  type: redis
  host: localhost
  port: 6379
  ttl: 3600
  
  # 或使用向量数据库
  vector_store:
    type: pinecone
    api_key: ${PINECONE_API_KEY}
    index_name: openclaw-memory

📊 监控与日志

日志命令

# 查看实时日志
openclaw logs -f

# 查看特定渠道日志
openclaw logs --channel discord

# 查看错误日志
openclaw logs --level error

# 导出日志
openclaw logs --export logs.txt

监控指标

# 查看系统状态
openclaw status

# 查看性能指标
openclaw metrics

# 查看 API 使用情况
openclaw usage

# 查看成本统计
openclaw cost

🔐 安全配置

访问控制

# security.yaml
access_control:
  # IP 白名单
  ip_whitelist:
    - 192.168.1.0/24
    - 10.0.0.0/8
    
  # 用户权限
  users:
    - username: admin
      role: admin
      permissions: ["*"]
      
    - username: user1
      role: user
      permissions: ["chat", "search"]

API 密钥管理

# 生成 API Key
openclaw apikey create --name "my-app"

# 列出 API Keys
openclaw apikey list

# 撤销 API Key
openclaw apikey revoke <key-id>

# 设置 API Key 权限
openclaw apikey set-permissions <key-id> --permissions "chat,search"

🐛 故障排查

常见问题

# 检查配置
openclaw doctor

# 测试连接
openclaw test connection

# 重置配置
openclaw config reset

# 清除缓存
openclaw cache clear

# 修复权限
openclaw fix permissions

调试模式

# 启用调试模式
openclaw start --debug

# 详细日志
openclaw start --verbose

# 性能分析
openclaw start --profile

📦 备份与恢复

备份命令

# 备份配置
openclaw backup config --output config-backup.zip

# 备份数据
openclaw backup data --output data-backup.zip

# 完整备份
openclaw backup all --output full-backup.zip

恢复命令

# 恢复配置
openclaw restore config --input config-backup.zip

# 恢复数据
openclaw restore data --input data-backup.zip

# 完整恢复
openclaw restore all --input full-backup.zip

🔄 更新与维护

更新命令

# 检查更新
openclaw update check

# 更新到最新版本
openclaw update

# 更新到指定版本
openclaw update --version 1.2.3

# 回滚版本
openclaw rollback --version 1.2.2

维护命令

# 清理日志
openclaw cleanup logs --days 7

# 清理缓存
openclaw cleanup cache

# 优化数据库
openclaw optimize database

# 健康检查
openclaw health check

🌍 环境变量

核心环境变量

# API Keys
export OPENAI_API_KEY=sk-xxx
export ANTHROPIC_API_KEY=sk-ant-xxx
export GOOGLE_API_KEY=xxx

# 服务配置
export OPENCLAW_PORT=3000
export OPENCLAW_HOST=0.0.0.0
export OPENCLAW_ENV=production

# 数据库
export DATABASE_URL=postgresql://user:pass@localhost:5432/openclaw
export REDIS_URL=redis://localhost:6379

# 日志
export LOG_LEVEL=info
export LOG_FORMAT=json

📱 快捷命令

一键命令

# 快速启动
openclaw quick-start

# 快速配置
openclaw quick-config

# 快速测试
openclaw quick-test

# 快速部署
openclaw quick-deploy

别名设置

# 添加到 ~/.bashrc 或 ~/.zshrc
alias oc='openclaw'
alias ocs='openclaw start'
alias occ='openclaw config'
alias ocl='openclaw logs'
alias oct='openclaw test'

🎯 最佳实践

性能优化

# 启用缓存
cache:
  enabled: true
  ttl: 3600
  max_size: 1000

# 连接池
connection_pool:
  min_size: 5
  max_size: 20
  timeout: 30

# 请求限流
rate_limit:
  enabled: true
  requests_per_minute: 60

成本控制

# 成本限制
cost_control:
  daily_limit: 100
  monthly_limit: 2000
  alert_threshold: 80
  
# 模型选择策略
model_selection:
  default: gpt-3.5-turbo
  fallback: claude-3-haiku
  cost_aware: true

📚 相关资源

💡 提示

  • 使用 openclaw help <command> 查看命令详细帮助
  • 使用 openclaw --version 查看当前版本
  • 使用 openclaw doctor 诊断系统问题
  • 定期备份配置和数据
  • 关注 GitHub 获取最新更新

最后更新: 2026年3月6日