OpenClaw 指令大全

作者：范桂飓
目录

文章目录

目录一、快速入门二、初始化与配置管理三、运维指令四、Gateway 管理五、Channel 管理六、Model 管理七、Multi-Agent 管理八、Session 管理九、Node 管理十、Cron 管理十一、Heartbeat 管理十二、Memory 管理十三、Message 管理十四、浏览器管理十五、安全管理十六、Skills 管理十七、Plugins 管理十八、Hooks 管理十九、Sandbox 管理二十、其他命令

Approvals 管理docs 搜索TUI 界面二维码ClawHub

二十一、斜杠命令

一、快速入门

1. # 查看系统状态
2. openclaw status
4. # 诊断问题
5. openclaw doctor
7. # 查看日志
8. openclaw logs --follow# 打开 Web 控制面板
9. openclaw dashboard
11. # 启动/重启 Gateway
12. openclaw gateway restart
14. # 更新版本
15. openclaw update

复制代码

二、初始化与配置管理

首次使用时的配置向导。

1. # 基础初始化
2. openclaw setup
3. # 运行向导
4. openclaw setup --wizard# 引导式配置
5. openclaw onboard
7. # 配置向导
8. openclaw configure
9. # 配置特定部分
10. openclaw configure --section models
11. openclaw configure --section channels
12. openclaw configure --section web
15. # 查看配置文件路径
16. openclaw config file# 获取配置值
17. openclaw config get gateway.port
18. openclaw config get agents.defaults.model.primary
20. # 设置配置值
21. openclaw config set gateway.port 19001
22. openclaw config set agents.defaults.model.primary "anthropic/claude-opus-4-6"# 删除配置值
23. openclaw config unset tools.web.search.apiKey
25. # 验证配置
26. openclaw config validate
27. openclaw config validate --json

复制代码

路径语法：

1. # 点号语法
2. openclaw config get agents.defaults.workspace
4. # 数组索引
5. openclaw config get agents.list[0].id
6. openclaw config set agents.list[1].tools.exec.node "node-1"

复制代码

三、运维指令

1. # 快速状态概览
2. openclaw status
4. # 完整诊断（包括深度检查）
5. openclaw status --all--verbose# 深度检测（探测所有渠道）
6. openclaw status --deep# 显示用量信息
7. openclaw status --usage# JSON 输出
8. openclaw status --json# 基础健康检查
9. openclaw health
11. # JSON 格式
12. openclaw health --json# 指定超时
13. openclaw health --timeout5000# 基础检查
14. openclaw doctor
16. # 自动修复
17. openclaw doctor --fix
18. openclaw doctor --repair# 深度检查
19. openclaw doctor --deep# 非交互模式
20. openclaw doctor --non-interactive
22. # 实时查看日志
23. openclaw logs --follow# 查看最近 200 行
24. openclaw logs --limit200# JSON 格式输出
25. openclaw logs --json# 禁用颜色
26. openclaw logs --plain# 创建备份
27. openclaw backup create
29. # 验证备份
30. openclaw backup verify
32. # 重置配置
33. openclaw reset --scope config
35. # 重置配置和凭证
36. openclaw reset --scope config+creds+sessions
38. # 完全重置
39. openclaw reset --scope full
41. # 非交互模式
42. openclaw reset --scope config --yes --non-interactive
45. # 卸载服务
46. openclaw uninstall --service# 卸载状态数据
47. openclaw uninstall --state# 卸载工作空间
48. openclaw uninstall --workspace# 完全卸载
49. openclaw uninstall --all# 非交互模式
50. openclaw uninstall --all--yes --non-interactive

复制代码

四、Gateway 管理

1. # 启动 Gateway（前台）
2. openclaw gateway
4. # 查看状态
5. openclaw gateway status
7. # 网关状态（含 RPC 探测）
8. openclaw gateway status --probe# 网关健康检查
9. openclaw gateway health
11. # 安装为系统服务
12. openclaw gateway install# 启动服务
13. openclaw gateway start
15. # 停止服务
16. openclaw gateway stop
18. # 重启服务
19. openclaw gateway restart
21. # 卸载服务
22. openclaw gateway uninstall

复制代码

启动参数：

参数	说明
--port <port>	WebSocket 端口
--bind <loopback|lan|tailnet|auto>	网络绑定模式
--token <token>	访问令牌
--password <password>	访问密码
--tailscale <off|serve|funnel>	Tailscale 暴露模式
--dev	开发模式
--verbose	详细日志
--force	强制启动（关闭占用端口的进程）

示例：

1. # 指定端口和令牌启动
2. openclaw gateway --port19001--token my-secret-token
4. # 绑定到局域网
5. openclaw gateway --bind lan
7. # 通过 Tailscale 暴露
8. openclaw gateway --tailscale serve

复制代码

五、Channel 管理

1. # 查看已配置的渠道
2. openclaw channels list
4. # 查看渠道状态
5. openclaw channels status
7. # 健康检查（探测渠道）
8. openclaw channels status --probe# 探测渠道能力
9. openclaw channels capabilities
11. # 添加渠道账号
12. openclaw channels add--channel telegram --token<bot-token>
13. openclaw channels add--channel discord --token<bot-token>
14. openclaw channels add--channel feishu --app-id <id> --app-secret <secret># 删除渠道账号
15. openclaw channels remove --channel telegram --delete# 查看渠道日志
16. openclaw channels logs --channel all
17. openclaw channels logs --channel telegram --lines50# 登录/登出（WhatsApp）
18. openclaw channels login --channel whatsapp
19. openclaw channels logout--channel whatsapp

复制代码

支持的渠道：

渠道	说明
feishu	飞书 / Lark
telegram	Telegram
discord	Discord
whatsapp	WhatsApp
slack	Slack
signal	Signal
imessage	iMessage
msteams	Microsoft Teams
googlechat	Google Chat

管理 DM（私聊）配对请求：

1. # 查看待配对请求
2. openclaw pairing list feishu
4. # 批准配对
5. openclaw pairing approve feishu <CODE># 批准并通知
6. openclaw pairing approve feishu <CODE>--notify

复制代码

六、Model 管理

1. # 查看模型状态
2. openclaw models status
4. # 测试模型认证
5. openclaw models status --probe# 列出可用模型
6. openclaw models list
7. openclaw models list --all# 设置默认模型
8. openclaw models set anthropic/claude-opus-4-6
10. # 设置图像模型
11. openclaw models set-image openai/gpt-4.1
13. # 扫描可用模型
14. openclaw models scan
16. # 列出别名
17. openclaw models aliases list
19. # 添加别名
20. openclaw models aliases add opus anthropic/claude-opus-4-6
22. # 删除别名
23. openclaw models aliases remove opus
25. # 列出 fallback
26. openclaw models fallbacks list
28. # 添加 fallback
29. openclaw models fallbacks add openai/gpt-4.1
31. # 删除 fallback
32. openclaw models fallbacks remove openai/gpt-4.1
34. # 清空 fallback
35. openclaw models fallbacks clear# 添加认证
36. openclaw models auth add# Setup-token
37. openclaw models auth setup-token --provider anthropic
39. # 粘贴 token
40. openclaw models auth paste-token --provider anthropic

复制代码

七、Multi-Agent 管理

1. # 列出所有 Agent
2. openclaw agents list
3. openclaw agents list --bindings# 同时显示路由绑定# 创建 Agent（进入向导流程）
4. openclaw agents add work
6. # 创建 Agent（指定参数）
7. openclaw agents add personal --workspace ~/.openclaw/workspace-personal
9. # 添加一个专门处理前端开发的代理
10. openclaw agents add\--workspace ~/.openclaw/workspace/fe-dev \--model claude-sonnet-4-2 \--bind telegram:work
12. # 添加一个专门处理后端开发的代理
13. openclaw agents add\--workspace ~/.openclaw/workspace/be-dev \--model claude-sonnet-4-2 \--bind slack:backend
15. # 删除 Agent（操作不可恢复）
16. openclaw agents delete work --force# 查看绑定
17. openclaw agents bindings
19. # 添加绑定
20. openclaw agents bind--agent work --bind feishu:work-bot
22. # 移除绑定
23. openclaw agents unbind --agent work --bind feishu:work-bot
24. openclaw agents unbind --agent work --all# 基础对话
25. openclaw agent --message"你好"# 指定目标
26. openclaw agent --message"提醒我开会"--to"+15555550123"# 指定渠道
27. openclaw agent --message"你好"--channel telegram
29. # 本地运行
30. openclaw agent --message"你好"--local# 设置思考级别
31. openclaw agent --message"分析这个问题"--thinking high

复制代码

八、Session 管理

1. # 列出会话
2. openclaw sessions
4. # 列出特定 Agent 的会话
5. openclaw sessions --agent work
7. # 列出所有 Agent 的会话
8. openclaw sessions --all-agents
10. # 查看最近活跃的会话（最近 120 分钟）
11. openclaw sessions --active120# 清理会话（预览）
12. openclaw sessions cleanup --dry-run
14. # 执行清理
15. openclaw sessions cleanup --enforce

复制代码

九、Node 管理

1. # 添加节点
2. openclaw nodeadd${name}
3. openclaw nodeadd macos-app
5. # 运行 Node Host（前台）
6. openclaw node run --host<gateway-ip>--port18789# 安装为系统服务
7. openclaw nodeinstall--host<gateway-ip>--port18789 --display-name "Build Node"# 查看状态
8. openclaw node status
10. # 启动服务
11. openclaw node start
13. # 停止服务
14. openclaw node stop
16. # 重启服务
17. openclaw node restart
19. # 卸载服务
20. openclaw node uninstall
22. # 查看所有节点状态
23. openclaw nodes status
25. # 列出节点
26. openclaw nodes list
28. # 查看待批准请求
29. openclaw nodes pending
31. # 批准节点
32. openclaw nodes approve <requestId># 拒绝节点
33. openclaw nodes reject <requestId># 重命名节点
34. openclaw nodes rename--node<id>--name"New Name"# 查看节点详情
35. openclaw nodes describe --node<id># 在节点上执行命令
36. openclaw nodes run --node<id> -- echo"hello"# 发送通知（macOS）
37. openclaw nodes notify --node<id>--title"提醒"--body"会议开始了"# 列出设备
38. openclaw devices list
40. # 批准设备
41. openclaw devices approve <requestId>
42. openclaw devices approve --latest# 拒绝设备
43. openclaw devices reject <requestId># 移除设备
44. openclaw devices remove <deviceId># 清除所有设备
45. openclaw devices clear--yes

复制代码

十、Cron 管理

OpenClaw 内置了强大的定时任务系统，支持 3 种任务类型：

类型	说明
system-event	在主会话中触发系统事件
agent-turn	在隔离会话中运行 AI 代理任务
message	直接发送消息到指定频道

1. # 查看状态
2. openclaw cron status
4. # 列出任务
5. openclaw cron list
7. # 添加任务（每天早上 9 点）
8. openclaw cronadd\--name"daily-report"\--cron"0 9 * * *"\
9.   --system-event "生成日报"# 添加每周一早上的周报提醒
10. openclaw cronadd\--name"周报提醒"\--cron"0 9 * * 1"\
11.   --system-event "提交周报的日子到了！"# 添加每天早上 9 点的提醒
12. openclaw cronadd\--name"晨间提醒"\--cron"0 9 * * *"\
13.   --system-event "记得喝咖啡 ☕️"# 编辑任务
14. openclaw cron edit <id># 删除任务
15. openclaw cronrm<id># 启用/禁用任务
16. openclaw cronenable<id>
17. openclaw cron disable <id># 查看运行记录
18. openclaw cron runs --id<id># 立即运行
19. openclaw cron run <id>

复制代码

十一、Heartbeat 管理

创建 ~/.openclaw/workspace/HEARTBEAT.md 文件：

1. # 心跳检查清单
3. 每次心跳时执行：
5. - [] 检查邮件
6. - [] 检查日历
7. - [] 检查待办事项
8. - [] 更新记忆文件

复制代码

控制心跳：

1. # 查看最后一次心跳
2. openclaw system heartbeat last
4. # 启用心跳系统
5. openclaw system heartbeat enable# 禁用心跳系统
6. openclaw system heartbeat disable

复制代码

十二、Memory 管理

OpenClaw 支持通过 CLI 来索引和搜索你的 MEMORY.md 文件，让它记住重要信息。

1. # 查看记忆状态
2. openclaw memory status
4. # 重新索引记忆文件
5. openclaw memory index
7. # 搜索记忆内容
8. openclaw memory search "项目进度"# 搜索需要密码的内容
9. openclaw memory search "SSH 凭证"

复制代码

十三、Message 管理

[code]# 发送文本消息
openclaw message send --target"+15555550123"--message"你好"# 发送到 Telegram
openclaw message send \--channel telegram \--target"@your_bot"\--message"Hello from OpenClaw!"# 发送到 WhatsApp
openclaw message send \--channel whatsapp \--target"+8613800138000"\--message"测试消息"# 发送到 Discord 频道
openclaw message send \--channel discord \--target"channel:1234567890"\--message"@here 重要通知"# 发送图片
openclaw message send --target"+15555550123"--media /path/to/image.jpg

# 创建投票
openclaw message poll \--channel discord \--target"channel:123"\
  --poll-question "这周五聚餐吃什么？"\
  --poll-option "火锅"\
  --poll-option "烧烤"\
  --poll-option "西餐"# 发送表情回应
openclaw message react \--channel discord \--target"channel:123"\
  --message-id "456"\--emoji"