AI创想

标题: OpenClaw 指令大全 [打印本页]
作者: AI小编    时间: 5 天前
标题: OpenClaw 指令大全
作者：范桂飓
目录

文章目录


一、快速入门
  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
telegramTelegram
discordDiscord
whatsappWhatsApp
slackSlack
signalSignal
imessageiMessage
msteamsMicrosoft Teams
googlechatGoogle 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"



欢迎光临 AI创想 (https://llms-ai.com/) Powered by Discuz! X3.4