一、基础信息

查看版本信息：
  openclaw --version

查看帮助：
  openclaw --help
  openclaw <命令> --help

查看状态：
  openclaw status

二、Gateway 管理

启动 Gateway：
  openclaw gateway

停止 Gateway：
  openclaw gateway stop

重启 Gateway：
  openclaw gateway restart

强制重启（杀掉占用端口进程）：
  openclaw gateway --force

查看 Gateway 状态：
  openclaw gateway status

查看 Gateway 日志：
  openclaw logs
  openclaw gateway logs

检查健康状态：
  openclaw health

三、配置管理

查看配置文件路径：
  openclaw config file

查看配置值：
  openclaw config get <路径>
  例如：openclaw config get tools

设置配置值：
  openclaw config set <路径> <值>
  例如：openclaw config set tools.profile full

删除配置值：
  openclaw config unset <路径>

验证配置：
  openclaw config validate

打开配置向导：
  openclaw configure

四、权限管理（Exec Approvals）

查看权限配置：
  openclaw approvals get

添加允许的命令：
  openclaw approvals allowlist add <命令>
  例如：openclaw approvals allowlist add "New-Item"

移除允许的命令：
  openclaw approvals allowlist remove <命令>

为所有 agent 添加权限：
  openclaw approvals allowlist add --agent "*" <命令>

查看权限帮助：
  openclaw approvals allowlist --help

五、通道管理

登录通道：
  openclaw channels login <通道>
  例如：openclaw channels login telegram

发送消息：
  openclaw message send --target <目标> --message "消息内容"

查看通道状态：
  openclaw status
  openclaw channels list

六、Agent 与会话管理

运行 Agent：
  openclaw agent --message "问题"

列出会话：
  openclaw sessions list

查看会话历史：
  openclaw sessions history <sessionKey>

发送消息到会话：
  openclaw sessions send <sessionKey> --message "消息"

列出可用 Agent：
  openclaw agents list

七、定时任务（Cron）

列出定时任务：
  openclaw cron list

查看定时任务详情：
  openclaw cron runs <jobId>

运行定时任务：
  openclaw cron run <jobId>

发送提醒（一次性）：
  openclaw cron add --schedule '{"kind":"at","at":"2026-03-09T09:00:00"}' \
                      --payload '{"kind":"systemEvent","text":"提醒：9点开会"}' \
                      --sessionTarget main

八、技能（Skills）

列出可用技能：
  openclaw skills list

查看技能信息：
  openclaw skills inspect <技能名>

查看技能帮助：
  openclaw <技能名> --help

九、模型管理

列出可用模型：
  openclaw models list

搜索模型：
  openclaw models scan

设置默认模型：
  openclaw config set agents.defaults.model.primary "zai/glm-5"

十、浏览器控制

启动浏览器：
  openclaw browser start

停止浏览器：
  openclaw browser stop

打开网页：
  openclaw browser open https://example.com

截屏：
  openclaw browser screenshot

查看标签页：
  openclaw browser tabs

十一、系统维护

更新 OpenClaw：
  openclaw update
  npm update -g openclaw

检查更新：
  openclaw update status

诊断问题：
  openclaw doctor

重置配置：
  openclaw reset
  ⚠️ 警告：会删除本地数据，CLI 保留

卸载 Gateway：
  openclaw uninstall

十二、快捷命令

打开控制 UI：
  openclaw dashboard

打开终端 UI：
  openclaw tui

生成 Shell 补全脚本：
  openclaw completion

搜索文档：
  openclaw docs <关键词>
  例如：openclaw docs gateway

十三、常见问题

Q: Gateway 端口被占用怎么办？
A: openclaw gateway --force

Q: 命令报错 "Unrecognized key"？
A: 检查配置格式是否正确，或查看 openclaw config validate

Q: 找不到命令或工具？
A: 检查 tools.profile 设置，可能需要设置为 "full"
  openclaw config set tools.profile full

Q: 如何启用 exec 工具？
A: 1. 配置 allowlist：openclaw approvals allowlist add <命令>
   2. 设置 profile：openclaw config set tools.profile full
   3. 重启 Gateway：openclaw gateway restart

Q: 如何设置自动提醒？
A: 使用 cron 命令，例如每天9点提醒：
   openclaw cron add --schedule '{"kind":"cron","expr":"0 9 * * *"}' \
                      --payload '{"kind":"systemEvent","text":"9点提醒"}' \
                      --sessionTarget main

十四、工作文件夹配置

我的工作文件夹：D:\xxxx

记住这个路径，以后所有工作文件都保存在这里。

十五、联系方式

- 官方文档：https://docs.openclaw.ai
- GitHub：https://github.com/openclaw/openclaw
- ClawHub（技能市场）：https://clawhub.com
- 社区：https://discord.com/invite/clawd

💡 提示：遇到问题时，先运行 openclaw doctor 诊断，或查看官方文档。