OpenClaw命令速查手册20+(核心命令 + 实战示例)

  发布时间:2026-03-09 12:11:34   作者:佚名   我要评论
本文为你整理了 20+ 最常用的 OpenClaw 命令,按功能分类,并提供实战示例,让你的日常工作效率提升 5 倍

OpenClaw 是一个强大的 AI 助手框架,但有 40+ 核心命令,记不住怎么办?

别担心!本文为你整理了 20+ 最常用的 OpenClaw 命令,按功能分类,并提供实战示例,让你的日常工作效率提升 5 倍!

无论是配置管理、消息发送、技能部署,还是 Gateway 控制,都能在这里找到快速答案。

一、快速入门

1.1 查看帮助信息

# 查看所有命令
openclaw --help
# 查看版本号
openclaw --version
# 查看特定命令的帮助
openclaw <command> --help
# 示例:查看 config 命令帮助
openclaw config --help

1.2 初始化配置

# 首次安装后初始化配置
openclaw setup
# 交互式引导配置(推荐新手)
openclaw onboard
#配置 + 安装系统后台服务(开机自启)
openclaw onboard --install-daemon
# 打开控制面板
openclaw dashboard

二、配置管理命令

2.1 查看配置

# 查看完整配置
openclaw config get
# 查看特定配置项
openclaw config get models.default
openclaw config get providers.mistral.apiKey
# 查看特定部分配置
openclaw config get --section models
openclaw config get --section providers

示例输出:

{
  "models": {
    "default": "mistral:mixtral-8x7b"
  },
  "providers": {
    "mistral": {
      "apiKey": "***REDACTED***"
    }
  }
}

2.2 设置配置

# 设置默认模型
openclaw config set models.default mistral:mixtral-8x7b
# 设置快速模型
openclaw config set models.fast mistral:mistral-7b
# 配置 Mistral API Key
openclaw config set providers.mistral.apiKey YOUR_API_KEY_HERE
# 启用缓存
openclaw config set cache.enabled true
openclaw config set cache.maxSize 5000

2.3 删除配置

# 删除特定配置项
openclaw config unset models.fast
# 重置某个节点
openclaw config unset models

2.4 配置向导

# 打开完整配置向导
openclaw configure
# 打开特定部分配置向导
openclaw configure --section models
openclaw configure --section providers
openclaw configure --section channels

三、Gateway 控制命令

3.1 启动/停止 Gateway

# 启动 Gateway(默认端口 18789)
openclaw gateway start
# 自定义端口启动
openclaw gateway start --port 19000
# 强制启动(杀死占用进程)
openclaw gateway start --force
# 停止 Gateway
openclaw gateway stop
# 重启 Gateway
openclaw gateway restart
# 查看运行状态
openclaw gateway status

3.2 运行时 Gateway

# 前台运行 Gateway(调试用)
openclaw gateway
# 开发模式运行(隔离状态)
openclaw --dev gateway
# 查看健康状态
openclaw health

3.3 查看日志

# 查看实时日志
openclaw logs
# 查看最近 50 行日志
openclaw logs --lines 50
# 查看错误日志
openclaw logs --filter error
# 持续监控日志
openclaw logs --follow

3.4 系统服务管理

# 使用 systemd 管理(推荐生产环境)
sudo systemctl start openclaw-gateway
sudo systemctl stop openclaw-gateway
sudo systemctl restart openclaw-gateway
sudo systemctl status openclaw-gateway
# 开机自启动
sudo systemctl enable openclaw-gateway

四、消息发送命令

4.1 发送消息

# 发送消息到当前会话
openclaw message send --message "Hello"
# 发送到特定目标(Telegram)
openclaw message send \
  --channel telegram \
  --target @mychat \
  --message "Hello from OpenClaw"
# 发送到特定目标(WhatsApp)
openclaw message send \
  --channel whatsapp \
  --target +8613800138000 \
  --message "您好"
# 发送到 Slack 频道
openclaw message send \
  --channel slack \
  --target C1234567890 \
  --message "@channel 重要通知"

4.2 发送媒体文件

# 发送图片
openclaw message send \
  --channel telegram \
  --target @mychat \
  --media /tmp/photo.jpg \
  --caption "这是一张图片"
# 发送音频
openclaw message send \
  --channel whatsapp \
  --target +8613800138000 \
  --media /tmp/voice.mp3
# 发送文档
openclaw message send \
  --channel telegram \
  --target @mychat \
  --media /tmp/report.pdf

4.3 高级消息功能

# 发送 JSON 格式(脚本自动化)
openclaw message send \
  --target @mychat \
  --message "Hello" \
  --json
# 回复消息
openclaw message send \
  --target @mychat \
  --message "收到" \
  --replyTo 12345
# 指定频道
openclaw message send \
  --channel discord \
  --target channel:1234567890 \
  --message "Hello"

4.4 频道动作(投票、反应等)

# 创建投票(Telegram)
openclaw message send \
  --channel telegram \
  --target @mychat \
  --pollQuestion "OpenClaw 好用吗?" \
  --pollOption 非常好用 \
  --pollOption 一般 \
  --pollOption 还需要改进 \
  --pollDurationHours 24
# 发送反应(Discord)
openclaw message send \
  --channel discord \
  --messageId 1234567890 \
  --emoji 👍 \
  --action react

五、技能管理命令

5.1 查看技能列表

# 查看所有已安装技能
openclaw skills list
# 搜索技能
openclaw skills search weather
# 查看技能详情
openclaw skills show weather

5.2 安装/卸载技能

# 安装技能
openclaw skills install weather
# 从指定来源安装
openclaw skills install weather --source github
# 指定版本安装
openclaw skills install weather@1.2.0
# 卸载技能
openclaw skills uninstall weather

5.3 更新技能

# 更新所有技能
openclaw skills update
# 更新特定技能
openclaw skills update weather
# 同步技能
openclaw skills sync

5.4 技能开发

# 创建新技能
openclaw skills create my-skill
# 验证技能
openclaw skills validate my-skill
# 打包技能
openclaw skills pack my-skill

六、模型配置命令

6.1 查看模型

# 查看所有配置的模型
openclaw models list
# 查看默认模型
openclaw models default
# 查看模型详情
openclaw models show mistral:mixtral-8x7b

6.2 配置模型

# 设置默认模型
openclaw models set-default mistral:mixtral-8x7b
# 添加新模型
openclaw models add \
  --name my-model \
  --provider mistral \
  --id mistral-medium \
  --maxTokens 8192
# 测试模型
openclaw models test \
  --model mistral:mixtral-8x7b \
  --prompt "Hello, OpenClaw!"

6.3 模型切换

# 临时指定模型
openclaw agent \
  --model mistral:mistral-7b \
  --message "快速响应"
# 使用内置模型别名
openclaw agent --model fast --message "这个用fast模型"
openclaw agent --model premium --message "这个用premium模型"

七、频道管理命令

7.1 查看频道

# 查看所有配置的频道
openclaw channels list
# 查看频道状态
openclaw channels status
# 查看特定频道详情
openclaw channels show telegram

7.2 登录频道

# Telegram 登录
openclaw channels login --channel telegram
# WhatsApp 登录(会显示 QR 码)
openclaw channels login --channel whatsapp --verbose
# Slack 登录
openclaw channels login --channel slack
# Discord 登录
openclaw channels login --channel discord

7.3 频道测试

# 测试频道连接
openclaw channels test --channel telegram
# 发送测试消息
openclaw channels test \
  --channel telegram \
  --target @mychat \
  --message "测试消息"

7.4 频道配置

# 配置频道
openclaw channels configure --channel telegram
# 更新频道 Token
openclaw channels update \
  --channel telegram \
  --token NEW_TOKEN
# 启用/禁用频道
openclaw channels enable telegram
openclaw channels disable telegram

八、会话管理命令

8.1 查看会话

# 列出所有会话
openclaw sessions
# 列出活跃会话
openclaw sessions --active
# 列出特定频道的会话
openclaw sessions --channel telegram
# 显示最近 10 个会话
openclaw sessions --limit 10

8.2 查看会话历史

# 查看特定会话的历史
openclaw sessions history <session-key>
# 查看最近的消息
openclaw sessions history <session-key> --limit 20
# 导出会话历史
openclaw sessions history <session-key> --export > history.json

8.3 会话操作

# 发送消息到会话
openclaw sessions send \
  --session <session-key> \
  --message "你好"
# 重置会话
openclaw sessions reset <session-key>
# 删除会话
openclaw sessions delete <session-key>

九、节点管理命令(智能家居控制)

9.1 查看节点

# 查看所有配对的节点
openclaw nodes list
# 查看节点状态
openclaw nodes status
# 描述节点详情
openclaw nodes describe <node-id>

9.2 节点操作

# 发送通知到节点
openclaw nodes notify \
  --node my-phone \
  --title "提醒" \
  --body "该吃饭了"
# 设置推送优先级
openclaw nodes notify \
  --node my-phone \
  --priority timeSensitive \
  --title "紧急通知" \
  --body "快递到了"
# 查看相册(手机)
openclaw nodes camera-list --node my-phone
# 拍照
openclaw nodes camera-snap \
  --node my-phone \
  --facing back \
  --output /tmp/photo.jpg

9.3 节点配对

# 启动配对
openclaw node pairing start
# 查看待配对节点
openclaw nodes pending
# 批准配对
openclaw nodes approve --node <node-id>
# 拒绝配对
openclaw nodes reject --node <node-id>

十、记忆管理命令

10.1 搜索记忆

# 搜索记忆
openclaw memory search "OpenClaw 配置"
# 搜索并显示多行上下文
openclaw memory search "配置" --lines 5
# 搜索特定路径的记忆
openclaw memory search "配置" --path MEMORY.md
# 限制结果数量
openclaw memory search "配置" --maxResults 10

10.2 记忆操作

# 查看记忆统计
openclaw memory stats
# 清理过期记忆
openclaw memory clean
# 备份记忆
openclaw memory backup --output /tmp/memory-backup.json

十一、Cron 定时任务命令

11.1 查看 Cron 任务

# 列出所有任务
openclaw cron list
# 查看任务运行历史
openclaw cron runs <job-id>
# 查看调度器状态
openclaw cron status

11.2 创建 Cron 任务

# 创建定时任务(每天凌晨触发)
openclaw cron add \
  --name "daily-report" \
  --schedule "0 0 * * *" \
  --text "生成每日报告"
# 创建重复任务(每 30 分钟)
openclaw cron add \
  --name "check-notifications" \
  --schedule "*/30 * * * *" \
  --text "检查通知"
# 创建单次任务(特定时间)
openclaw cron add \
  --name "special-task" \
  --schedule "at" \
  --at "2026-03-01T10:00:00" \
  --text "执行特殊任务"

11.3 Cron 任务操作

# 立即运行任务
openclaw cron run <job-id>
# 更新任务
openclaw cron update <job-id> --schedule "0 6 * * *"
# 删除任务
openclaw cron remove <job-id>
# 发送唤醒事件
openclaw cron wake --text "检查新消息"

十二、系统命令

12.1 健康检查

# 运行健康检查
openclaw doctor
# 快速修复常见问题
openclaw doctor --fix
# 检查特定组件
openclaw doctor --check gateway
openclaw doctor --check channels

12.2 系统状态

# 查看频道健康状态
openclaw status
# 查看系统事件
openclaw system events
# 查看心跳状态
openclaw system heartbeat

12.3 安全检查

# 运行安全检查
openclaw security audit
# 检查权限配置
openclaw security check-permissions
# 检查 API Key 有效性
openclaw security verify-keys

十三、插件管理命令

13.1 查看插件

# 查看已安装插件
openclaw plugins list
# 查看插件详情
openclaw plugins show <plugin-name>
# 检查插件状态
openclaw plugins status

13.2 插件操作

# 启用插件
openclaw plugins enable feishu
# 禁用插件
openclaw plugins disable feishu
# 重启插件
openclaw plugins restart feishu
# 更新插件
openclaw plugins update

十四、浏览器控制命令

14.1 启动/停止浏览器

# 启动浏览器
openclaw browser start
# 停止浏览器
openclaw browser stop
# 切换配置
openclaw browser start --profile chrome
openclaw browser start --profile openclaw

14.2 浏览器操作

# 打开网页
openclaw browser open https://example.com
# 截图
openclaw browser screenshot --output /tmp/screenshot.png
# 获取快照
openclaw browser snapshot --target main
# 查看标签页
openclaw browser tabs

十五、更新与维护命令

15.1 更新 OpenClaw

# 查看更新
openclaw update --dry-run
# 执行更新
openclaw update
# 更新到特定版本
openclaw update --tag 2026.2.22
# 更新到 Beta 版
openclaw update --channel beta

15.2 配置文件管理

# 备份配置
cp ~/.openclaw/config.json ~/.openclaw/config.json.backup
# 重置配置(保留 CLI)
openclaw reset
# 完全卸载(包括数据)
openclaw uninstall

15.3 Shell 自动补全

# 生成 Bash 补全脚本
openclaw completion bash > ~/.openclaw-completion
# 生成 Zsh 补全脚本
openclaw completion zsh > ~/.zsh-completion
# 应用补全(Bash)
echo "source ~/.openclaw-completion" >> ~/.bashrc
source ~/.bashrc

十六、常用组合命令

16.1 快速部署新技能

# 一键创建、开发、测试技能
openclaw skills create my-new-skill \
  && cd ~/.openclaw/workspace/skills/my-new-skill \
  && vim SKILL.md

16.2 批量发送通知

# 发送到多个目标
openclaw message send --target @user1 --message "通知内容"
openclaw message send --target @user2 --message "通知内容"
openclaw message send --target @user3 --message "通知内容"
# 使用循环批量发送(需要脚本配合)
for target in user1 user2 user3; do
  openclaw message send --target @$target --message "通知内容"
done

16.3 Gateway 重启 + 验证

# 重启并验证
openclaw gateway restart \
  && sleep 5 \
  && openclaw gateway status \
  && openclaw health

16.4 配置备份 + 更新

# 安全更新流程
cp ~/.openclaw/config.json ~/.openclaw/config.json.backup \
  && openclaw update --dry-run \
  && openclaw update \
  && openclaw gateway restart

16.5 每日报告生成

# 生成每日报告(Cron 脚本)
0 9 * * * openclaw cron add \
  --name daily-report \
  --schedule "0 9 * * *" \
  --text "生成昨日数据分析报告"

十七、故障排除命令

17.1 Gateway 无法启动

# 检查端口占用
sudo lsof -i :18789
# 强制重启
openclaw gateway start --force
# 查看错误日志
openclaw logs --filter error
# 运行健康检查
openclaw doctor

17.2 消息发送失败

# 检查频道状态
openclaw channels status
# 测试频道
openclaw channels test --channel telegram
# 重新登录频道
openclaw channels login --channel telegram
# 查看详细日志
openclaw message send --target @mychat --message "Test" --verbose

17.3 模型调用失败

# 检查 API Key
openclaw config get providers.openai.apiKey
# 测试模型
openclaw models test --model mistral:mixtral-8x7b --prompt "test"
# 检查网络连接
ping api.openai.com
# 运行诊断
openclaw doctor --check models

17.4 技能加载失败

# 检查技能列表
openclaw skills list
# 验证技能
openclaw skills validate my-skill
# 重新安装技能
openclaw skills uninstall my-skill
openclaw skills install my-skill
# 查看错误日志
openclaw logs --filter skill

十八、生产环境最佳实践

18.1 使用环境变量

# 推荐方式:使用环境变量存储敏感信息
export OPENAI_API_KEY="sk-xxx"
export MISTRAL_API_KEY="xxx"
export TELEGRAM_BOT_TOKEN="xxx"
# 然后启动 Gateway
openclaw gateway start

18.2 配置文件权限

# 限制配置文件权限
chmod 600 ~/.openclaw/config.json
# 检查权限
ls -la ~/.openclaw/config.json

18.3 日志管理

# 配置日志轮转
sudo tee /etc/logrotate.d/openclaw <<EOF
~/.openclaw/logs/*.log {
    daily
    rotate 7
    compress
    missingok
    notifempty
}
EOF

18.4 监控与告警

# 检查 Gateway 状态(Cron 脚本)
*/5 * * * * openclaw health || \
  openclaw message send --target @admin --message "Gateway 宕机!"

十九、快捷别名配置

19.1 创建常用别名

# 添加到 ~/.bashrc 或 ~/.zshrc
alias oc='openclaw'
alias ocg='openclaw gateway'
alias ocgl='openclaw logs --follow'
alias ocs='openclaw sessions'
alias ocm='openclaw message send'
alias occ='openclaw channels'
# 应用别名
source ~/.bashrc  # Bash
source ~/.zshrc   # Zsh

19.2 使用别名

# 启动 Gateway
ocg start
# 查看实时日志
ocgl
# 发送消息
ocm --target @mychat --message "Hello"
# 查看会话
ocs

二十、命令速查表

总结

OpenClaw 提供了丰富的命令行工具,掌握这些命令可以大幅提升工作效率。

相关文章

最新评论