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🤖 模型配置
支持的模型提供商
| 提供商 | 模型示例 | 配置方式 |
|---|---|---|
| OpenAI | gpt-4, gpt-3.5-turbo | OPENAI_API_KEY |
| Anthropic | claude-3-opus, claude-3-sonnet | ANTHROPIC_API_KEY |
| gemini-pro | GOOGLE_API_KEY | |
| Azure OpenAI | gpt-4 | AZURE_OPENAI_API_KEY |
| 本地模型 | llama2, mistral | Ollama/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/webhookTelegram 接入
# 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日