a2Mia姐1. OpenClaw 命令手册概述
OpenClaw 是一款功能强大的 AI 开发与管理工具，提供了丰富的命令行接口来控制系统行为、管理会话和配置各种功能模块。作为一名长期使用 OpenClaw 进行 AI 开发的技术人员，我整理了这份详细的命令手册，希望能帮助开发者更高效地使用这个工具。
OpenClaw 的命令主要分为两大类：对话框内直接使用的 Slash Commands 和终端运行的 CLI 命令。Slash Commands 适合在日常交互中使用，而 CLI 命令则更适合系统管理和自动化场景。本文将详细介绍这两类命令的使用方法和实际应用场景。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 对话框中可直接使用的 Slash Commands
2.1 信息查询类命令
信息查询命令是日常使用最频繁的一类命令，它们能帮助我们快速了解系统状态和获取帮助信息。
/help 命令会显示基础帮助信息，特别适合新手快速了解系统功能。而 /commands 则会列出所有可用的 Slash Commands，当你不确定有哪些命令可用时，这个命令非常有用。
/status 命令会显示当前系统状态，包括模型提供商的使用配额情况。这对于监控资源消耗特别重要，可以避免因配额耗尽导致的工作中断。例如，当使用 Claude 模型时，这个命令会显示剩余的 API 调用次数和 token 使用量。
/context 命令是调试会话上下文的重要工具。使用 /context detail 可以查看当前会话中每个文件、工具和技能占用的空间大小，这对于优化上下文长度特别有帮助。当发现模型响应变慢时，可以用这个命令检查是否上下文过大。
2.2 会话管理类命令
会话管理命令帮助我们控制对话流程和生命周期。
/new 命令可以开始一个新的会话，可选指定模型。例如 /new anthropic/claude-opus-4 会使用指定的 Claude 模型开始新对话。如果不指定模型，则使用默认模型。
/reset 命令会重置当前会话，清除所有上下文。这在对话偏离主题或需要重新开始时非常有用。需要注意的是，重置后的会话无法恢复，重要信息应提前保存。
/session ttl 命令可以设置会话的存活时间（TTL）。例如 /session ttl 24h 设置会话在24小时后自动过期。这对于管理长期运行的会话特别有用，可以避免资源浪费。
/compact 命令会尝试压缩当前会话上下文，去除冗余信息但保留核心内容。这个功能在长时间对话后特别有用，可以显著减少 token 消耗。
2.3 行为控制类命令
行为控制命令让我们可以精细调整模型的响应方式。
/think 命令（别名 /t）可以动态设置思考级别，从 off（不显示思考过程）到 xhigh（显示最详细的思考过程）。在调试复杂问题时，设置为 high 或 xhigh 可以看到模型的完整推理链条。
/verbose 命令控制输出的详细程度。设置为 on 时，模型会提供更详细的解释；设置为 off 时则只返回核心内容。根据场景需要灵活调整这个设置可以提高工作效率。
/model 命令用于切换当前使用的模型。使用 /model list 可以查看所有可用模型，然后通过 /model <name> 切换到特定模型。不同模型适合不同任务，比如 Claude 适合长文本分析，GPT 适合创意生成。
2.4 插件与工具类命令
插件和工具命令扩展了 OpenClaw 的功能边界。
/skill 命令可以按名称运行预定义的技能。例如 /skill my-skill arg1 会执行名为 "my-skill" 的自定义技能并传入参数。技能是 OpenClaw 的强大扩展机制，可以封装复杂操作为简单命令。
/exec 命令允许在指定目标上执行操作。通过参数可以控制执行位置（沙箱、网关或节点）和安全级别。例如 /exec host=sandbox security=allowlist 会在沙箱环境中以白名单模式执行命令。
/bash 命令（或 ! 快捷方式）可以直接在主机上运行 shell 命令。这个功能需要先在配置中启用 commands.bash: true。使用时务必小心，避免执行危险命令。
2.5 配置管理类命令
配置管理命令帮助我们持久化和调试系统设置。
/config 命令可以查看、设置和删除持久化配置。例如 /config show 显示当前配置，/config set key value 修改特定配置项。配置变更会保存到磁盘，重启后仍然有效。
/debug 命令用于运行时调试，可以临时覆盖配置而不影响持久化设置。例如 /debug set log_level verbose 会临时提高日志级别帮助排查问题。
2.6 渠道控制类命令
渠道控制命令管理 OpenClaw 与各种通讯平台的集成。
/dock- 系列命令（如 /dock-telegram）可以切换回复到不同的通讯平台。这在多平台集成环境中特别有用，可以灵活控制消息流向。
/activation 命令设置群组中的激活方式。mention 模式要求 @提及机器人才会响应，而 always 模式则会响应所有消息。根据群组性质选择合适的模式可以避免干扰。
2.7 子代理相关命令
子代理命令用于管理和控制并行运行的代理实例。
/subagents 命令可以列出、终止和监控子代理。例如 /subagents list 显示所有运行中的子代理，/subagents kill all 终止所有子代理。在复杂任务分解场景中，这些命令必不可少。
/focus 和 /unfocus 命令用于绑定和解除线程到特定代理。这让我们可以在同一会话中与多个代理交互，实现更复杂的工作流。
2.8 其他实用命令
其他实用命令提供了各种便利功能。
/export-session 命令将会话导出为 HTML 文件，方便分享或存档。导出的文件包含完整的对话历史和上下文，是记录工作成果的好方法。
/tts 命令控制文本转语音功能。可以设置不同的触发条件（如 always 始终朗读，inbound 只朗读收到的消息）和提供商参数。
3. 终端运行的 CLI 命令
3.1 核心管理命令
核心管理命令是 OpenClaw 系统的基础操作入口。
openclaw setup 命令初始化配置和工作区。通过 --workspace 参数可以指定工作区路径，这在多项目环境中特别有用。建议为每个独立项目创建单独的工作区。
openclaw onboard 是交互式设置向导，适合初次使用者。--mode local 参数可以限制为本地模式，简化设置过程。完成向导后，系统会自动生成基础配置文件。
openclaw doctor 命令执行健康检查并尝试修复常见问题。添加 --deep 参数会进行更全面的检查，--repair 参数则自动修复发现的问题。在系统异常时，这是首选的诊断工具。
3.2 配置命令
配置命令提供了灵活的系统配置管理能力。
openclaw config get/set/unset 命令组可以查看和修改配置项。例如 openclaw config get gateway.port 获取网关端口设置，openclaw config set gateway.port 19001 修改端口。使用点号路径可以访问嵌套配置。
--strict-json 参数确保值按 JSON 格式解析，这在设置复杂结构时特别重要。例如设置数组：openclaw config set plugins.active '["plugin1","plugin2"]' --strict-json。
3.3 网关服务命令
网关命令控制 OpenClaw 的核心服务。
openclaw gateway run 在前台运行网关服务，适合调试场景。通过 --port 可以指定监听端口。在生产环境中，通常使用 openclaw gateway install 安装为后台服务。
openclaw gateway health 检查服务健康状态，返回详细的组件状态信息。--url 参数可以指定检查的端点，这在分布式部署中很有用。
3.4 渠道管理命令
渠道命令管理各种通讯平台的集成。
openclaw channels add 添加新的渠道账号。例如添加 Telegram 机器人：openclaw channels add --channel telegram --token <bot-token>。每个渠道都有特定的认证方式，需要参考对应文档。
openclaw channels resolve 将渠道中的名称解析为内部 ID。例如解析 Slack 频道和用户：openclaw channels resolve --channel slack "#general" "@jane"。这在编写自动化脚本时特别有用。
3.5 代理管理命令
代理命令管理 OpenClaw 的代理实例。
openclaw agents add 创建新代理并指定工作区。例如 openclaw agents add work --workspace ~/.openclaw/workspace-work 创建名为 "work" 的代理。不同代理可以完全隔离配置和环境。
openclaw agents set-identity 配置代理身份信息。--from-identity 参数会交互式引导完成设置过程，包括名称、描述和默认能力等。
3.6 会话管理命令
会话命令管理存储的对话历史。
openclaw sessions 列出所有会话，--active 参数筛选最近活跃的会话。例如 openclaw sessions --active 120 显示过去2小时内有活动的会话。
openclaw sessions cleanup 清理过期或无效的会话。先用 --dry-run 预览将被清理的会话，确认无误后再使用 --enforce 执行实际清理。合理的会话清理策略可以节省存储空间。
3.7 模型管理命令
模型命令管理系统可用的 AI 模型。
openclaw models status 显示各模型提供商的连接状态和使用情况。--probe 参数会主动测试每个模型的可用性，这在排查模型访问问题时很有帮助。
openclaw models set 设置默认模型。例如 openclaw models set anthropic/claude-opus-4-6 切换到指定的 Claude 模型版本。不同模型在性能、成本和能力上有显著差异，应根据任务需求选择。
3.8 记忆管理命令
记忆命令管理系统的长期记忆功能。
openclaw memory index 重新索引记忆文件，更新语义搜索的数据。添加 --verbose 参数会显示详细的索引过程，帮助排查索引问题。
openclaw memory search 执行语义搜索。例如 openclaw memory search "release checklist" 会返回所有相关内容，即使不包含完全匹配的关键词。这是利用系统积累知识的高效方式。
3.9 定时任务命令
定时任务命令实现自动化工作流。
openclaw cron add 创建新的定时任务。例如 openclaw cron add --name "daily" --every "24h" --message "Check in" 创建每日检查任务。定时任务可以触发任意有效的 Slash Command。
openclaw cron edit 修改现有任务。除了基本参数外，--announce 参数控制任务执行时是否通知用户。对于重要任务，启用通知可以及时了解执行情况。
3.10 日志与监控命令
日志命令提供系统可观测性支持。
openclaw logs 实时查看系统日志。--follow 参数持续输出新日志，--json 参数以结构化格式输出，方便进一步处理。结合 --limit 可以限制查看的历史日志数量。
openclaw status 提供系统诊断快照。--deep 参数增加检测深度，--usage 参数包含资源使用统计。定期检查系统状态是维护稳定运行的好习惯。
3.11 节点管理命令
节点命令管理分布式部署中的计算节点。
openclaw nodes list 显示所有已知节点，--connected 参数只列出当前在线的节点。在集群环境中，这是了解资源分布的重要命令。
openclaw nodes invoke 在特定节点上执行命令。例如 openclaw nodes invoke --node my-node --command system.info 获取节点系统信息。这为分布式任务调度提供了基础。
3.12 安全与权限命令
安全命令管理系统访问控制。
openclaw security audit 检查系统安全配置。--fix 参数自动修复发现的问题，--json 输出机器可读的结果。定期执行安全审计是保护敏感数据的重要措施。
openclaw approvals allowlist 管理命令执行白名单。例如 openclaw approvals allowlist add "~/Projects/**/bin/rg" 允许特定路径下的 ripgrep 命令。合理配置白名单可以在便利性和安全性间取得平衡。
3.13 沙箱管理命令
沙箱命令控制隔离的执行环境。
openclaw sandbox list 显示所有沙箱容器及其状态。--json 参数输出完整细节，适合自动化处理。沙箱为不安全操作提供了隔离环境。
openclaw sandbox recreate 重建沙箱环境。--all 重建所有沙箱，--session 针对特定会话重建。当沙箱出现异常时，重建通常是有效的解决方法。
3.14 工具与插件命令
插件命令扩展系统功能。
openclaw plugins install 安装新插件。支持从本地文件或远程仓库安装，例如 openclaw plugins install ./my-plugin.tgz。插件可以添加新命令、集成第三方服务或修改系统行为。
openclaw skills check 验证技能可用性。这会测试所有已注册技能的依赖和配置，确保它们可以正常执行。在部署新环境后，执行这个检查可以提前发现问题。
3.15 Web 和 API 命令
Web 命令管理系统对外接口。
openclaw message send 通过 API 发送消息。例如 openclaw message send --channel telegram --target 123456 --message "Hello" 向指定 Telegram 用户发送消息。这为外部系统集成提供了基础。
openclaw webhooks gmail 设置 Gmail 邮件处理。配置完成后，系统可以自动处理特定条件的邮件，实现工作流自动化。
3.16 浏览器控制命令
浏览器命令实现自动化网页操作。
openclaw browser tabs 列出所有打开的浏览器标签页。结合 --browser-profile 可以指定浏览器实例。网页自动化是数据采集和测试的重要工具。
openclaw browser click 和 openclaw browser type 模拟用户交互。例如 openclaw browser click button-submit 点击提交按钮，openclaw browser type input-name "hello" 在输入框中填写文本。这些命令为网页测试自动化提供了基础能力。
3.17 全局选项
所有 CLI 命令支持一组全局选项，提供统一的控制能力。
--dev 选项将状态隔离到 ~/.openclaw-dev 目录，并使用 19001 作为默认端口。这在开发和测试时非常有用，可以避免影响生产环境。
--profile 选项类似 --dev，但允许自定义隔离目录名称。例如 --profile test 使用 ~/.openclaw-test 目录。多环境配置时这个选项特别有用。
--json 选项强制命令输出为机器可读的 JSON 格式。这在编写脚本处理命令结果时必不可少，可以方便地使用 jq 等工具进行解析。
4. 使用技巧与最佳实践
4.1 命令组合与自动化
OpenClaw 命令设计考虑了可组合性，可以通过管道和脚本实现复杂自动化。例如，以下命令序列可以定期检查模型状态并通知异常：
bash复制openclaw models status --json | jq -r '.models[] | select(.status != "healthy")' | \
xargs -I {} openclaw message send --channel telegram --target admin --message "Model异常: {}"
将这个命令设置为定时任务，就实现了模型健康监控系统。
4.2 安全注意事项
使用 OpenClaw 时需要注意以下安全事项：
- 谨慎使用
/bash和!命令，避免执行危险操作 - 为生产环境配置适当的批准白名单
- 定期执行
openclaw security audit --fix修复已知安全问题 - 为敏感操作使用沙箱环境
- 合理控制会话 TTL，避免长期保留敏感对话
4.3 性能优化建议
针对大型部署，以下优化措施可以提升系统性能：
- 为频繁访问的模型设置本地缓存
- 使用
openclaw memory index定期优化记忆索引 - 合理配置会话压缩策略，控制上下文长度
- 分布式部署时将计算密集型任务分配到专用节点
- 监控网关和节点资源使用情况，及时扩容
4.4 调试技巧
遇到问题时，可以尝试以下调试方法：
- 使用
openclaw doctor --deep --repair检查和修复常见问题 - 通过
openclaw logs --follow实时查看系统日志 - 在命令中添加
--verbose或--json获取更详细输出 - 使用
openclaw gateway health检查核心服务状态 - 在开发环境中复现问题时，添加
--dev隔离环境
掌握这些命令和技巧后，你将能够充分发挥 OpenClaw 的强大功能，构建高效的 AI 应用和工作流。根据具体需求灵活组合这些命令，可以创造出无限可能。