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

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

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

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

一、快速入门

1.1 查看帮助信息

# 查看所有命令openclaw --help# 查看版本号openclaw --version# 查看特定命令的帮助openclaw  --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.defaultopenclaw config get providers.mistral.apiKey# 查看特定部分配置openclaw config get --section modelsopenclaw 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 Keyopenclaw config set providers.mistral.apiKey YOUR_API_KEY_HERE# 启用缓存openclaw config set cache.enabled trueopenclaw config set cache.maxSize 5000

2.3 删除配置

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

2.4 配置向导

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

三、Gateway 控制命令

3.1 启动/停止 Gateway

# 启动 Gateway（默认端口 18789）openclaw gateway start# 自定义端口启动openclaw gateway start --port 19000# 强制启动（杀死占用进程）openclaw gateway start --force# 停止 Gatewayopenclaw gateway stop# 重启 Gatewayopenclaw 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-gatewaysudo systemctl stop openclaw-gatewaysudo systemctl restart openclaw-gatewaysudo 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 [email protected]# 卸载技能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# 更新频道 Tokenopenclaw channels update   --channel telegram   --token NEW_TOKEN# 启用/禁用频道openclaw channels enable telegramopenclaw channels disable telegram

八、会话管理命令

8.1 查看会话

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

8.2 查看会话历史

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

8.3 会话操作

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

九、节点管理命令（智能家居控制）

9.1 查看节点

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

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 # 拒绝配对openclaw nodes reject --node 

十、记忆管理命令

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 # 查看调度器状态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 # 更新任务openclaw cron update  --schedule "0 6 * * *"# 删除任务openclaw cron remove # 发送唤醒事件openclaw cron wake --text "检查新消息"

十二、系统命令

12.1 健康检查

# 运行健康检查openclaw doctor# 快速修复常见问题openclaw doctor --fix# 检查特定组件openclaw doctor --check gatewayopenclaw 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 # 检查插件状态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 chromeopenclaw 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" >> ~/.bashrcsource ~/.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 Keyopenclaw 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-skillopenclaw 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"# 然后启动 Gatewayopenclaw gateway start

18.2 配置文件权限

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

18.3 日志管理

# 配置日志轮转sudo tee /etc/logrotate.d/openclaw <
18.4 监控与告警
# 检查 Gateway 状态（Cron 脚本）*/5 * * * * openclaw health ||   openclaw message send --target @admin --message "Gateway 宕机！"
十九、快捷别名配置
19.1 创建常用别名
# 添加到 ~/.bashrc 或 ~/.zshrcalias 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  # Bashsource ~/.zshrc   # Zsh
19.2 使用别名
# 启动 Gatewayocg start# 查看实时日志ocgl# 发送消息ocm --target @mychat --message "Hello"# 查看会话ocs
二十、命令速查表
总结