作者

dev-book

发布时间

2026/3/6

OpenClaw 进阶命令合集

整理了 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 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 提供了丰富的命令行工具，掌握这些命令可以大幅提升工作效率。

建议收藏本文，随时查阅！

下一步：

从你最常用的功能开始练习
创建命令别名，提高效率
配置环境变量，保护敏感信息
启用 Shell 自动补全，减少输入

有问题？

查看官方文档：https://docs.openclaw.ai
加入社区：https://discord.com/invite/clawd
运行 help 命令：openclaw <command>