OpenClaw 命令行手册

OpenClaw 命令行手册 OpenClaw 命令行手册 Modified March 15 Code block Bash Copy openclaw secrets reload openclaw secrets migrate openclaw secrets configure skills list / info / check 技能管理。 Code block Bash Copy openclaw skills list openclaw skills list eligible json openclaw skills info weather openclaw skills check verbose plugins list / info / install / enable / disable / doctor 插件管理。 Code block Bash Copy openclaw plugins list openclaw plugins info <id openclaw plugins install /path/to/plugin openclaw plugins enable <id openclaw plugins disable <id openclaw plugins doctor pairing list / approve 配对管理。 Code block Bash Copy openclaw pairing list channel discord openclaw pairing approve discord ABC123 notify devices list / approve / reject / remove / clear 设备管理。 Code block Bash Copy openclaw devices list openclaw devices approve <requestId openclaw devices reject <requestId openclaw devices remove <deviceId openclaw devices clear yes message 统一消息发送和通道操作。 子命令： • send 发送消息 • poll 创建投票 • react 添加反应 • reactions 查看反应 • read 标记已读 • edit 编辑消息 • delete 删除消息 • pin / unpin 置顶/取消置顶 • pins 查看置顶 • permissions 权限管理 • search 搜索消息 • timeout 设置超时 • kick 踢出成员 • ban 封禁用户 示例： Code block Bash Copy openclaw message send target +1234567890 message "Hello" openclaw message poll channel discord target channel:123 poll question "Choice?" poll option A poll option B agent 运行 agent 轮次。 选项： • message <text 消息内容（必填） • to <dest 目标 • session id <id 会话 ID • thinking <off|minimal|low|medium|high|xhigh 推理级别 • verbose <on|full|off 详细输出 • channel <whatsapp|telegram|discord... 通道 • local 本地运行 • deliver 递送消息 • json JSON 输出 示例： Code block Bash Copy openclaw agent message "Help me with coding" thinking medium openclaw agent message "Test" to session:xyz deliver acp 运行 ACP 桥接器（连接 IDE 到 Gateway）。详见 openclaw acp help。 sessions 列出会话。 Code block Bash Copy openclaw sessions verbose openclaw sessions active 60 json docs 搜索实时文档索引。 Code block Bash Copy openclaw docs search query openclaw docs gateway authentication tui 打开终端 UI 连接到 Gateway。 Code block Bash Copy openclaw tui openclaw tui session <key deliver 第二部分：斜杠命令（Slash Commands） 以下命令在频道（飞书 等）的聊天窗口中直接输入，用于实时控制会话和 Agent 行为。 📋 会话管理（Session） 命令 说明 /session 管理会话级设置（例如：/session idle 设置空闲超时） /stop 停止当前运行 /reset 重置当前会话 /new 开始新会话 /compact 压缩会话上下文 ⚙️ 选项配置（Options） 命令 说明 /usage 显示使用统计或成本摘要 /think / /thinking / /t 设置思考级别（思考模式） /verbose / /v 切换详细模式 /reasoning / /reason 切换推理可见性 /elevated / /elev 切换提升模式 /exec 为当前会话设置 exec 默认值 /model 显示或设置模型 /models 列出模型提供商或提供商模型 /queue 调整队列设置 📊 状态查询（Status） 命令 说明 /help 显示可用命令 /commands 列出所有斜杠命令 /status 显示当前状态 /context 解释上下文如何构建和使用 /export session / /export 将当前会话导出为包含完整系统提示的 HTML 文件 /whoami / /id 显示你的发送者 ID 🔧 管理（Management） 命令 说明 /allowlist [text] 列出/添加/删除白名单条目 /approve 批准或拒绝 exec 请求 /subagents 列出、终止、记录、生成或指导此会话的子代理运行 /acp 管理 ACP 会话和运行时选项 /focus 将此 Discord 线程（或新线程）绑定到会话目标 /unfocus 移除当前的 Discord 线程绑定 /agents 列出此会话的线程绑定代理 /kill 终止正在运行的子代理（或全部） /steer / /tell 向正在运行的子代理发送指导 /activation 设置组激活模式 /send 设置发送策略 🎙️ 媒体（Media） 命令 说明 /tts 控制文本转语音（TTS） 🛠️ 工具（Tools） 命令 说明 /skill 按名称运行技能 /restart 重启 OpenClaw skills list / info / check 技能管理。 plugins list / info / install / enable / disable / doctor 插件管理。 pairing list / approve 配对管理。 devices list / approve / reject / remove / clear 设备管理。 message 统一消息发送和通道操作。 子命令： • send 发送消息 • poll 创建投票 • react 添加反应 • reactions 查看反应 • read 标记已读 • edit 编辑消息 • delete 删除消息 • pin / unpin 置顶/取消置顶 • pins 查看置顶 • permissions 权限管理 • search 搜索消息 • timeout 设置超时 • kick 踢出成员 • ban 封禁用户 示例： agent 运行 agent 轮次。 选项： • message <text 消息内容（必填） • to <dest 目标 • session id <id 会话 ID • thinking <off|minimal|low|medium|high|xhigh 推理级别 • verbose <on|full|off 详细输出 • channel <whatsapp|telegram|discord... 通道 • local 本地运行 • deliver 递送消息 • json JSON 输出 示例： acp 运行 ACP 桥接器（连接 IDE 到 Gateway）。详见 openclaw acp help。 sessions 列出会话。 docs 搜索实时文档索引。 tui 打开终端 UI 连接到 Gateway。 第二部分：斜杠命令（Slash Commands） 以下命令在频道（飞书 等）的聊天窗口中直接输入，用于实时控制会话和 Agent 行为。 📋 会话管理（Session） 命令 说明 /session 管理会话级设置（例如：/session idle 设置空闲超时） /stop 停止当前运行 /reset 重置当前会话 /new 开始新会话 /compact 压缩会话上下文 命令 命令 说明 说明 /session /session 管理会话级设置（例如：/session idle 设置空闲超时） 管理会话级设置（例如：/session idle 设置空闲超时） /stop /stop 停止当前运行 停止当前运行 /reset /reset 重置当前会话 重置当前会话 /new /new 开始新会话 开始新会话 /compact /compact 压缩会话上下文 压缩会话上下文 ⚙️ 选项配置（Options） 命令 说明 /usage 显示使用统计或成本摘要 /think / /thinking / /t 设置思考级别（思考模式） /verbose / /v 切换详细模式 /reasoning / /reason 切换推理可见性 /elevated / /elev 切换提升模式 /exec 为当前会话设置 exec 默认值 /model 显示或设置模型 /models 列出模型提供商或提供商模型 /queue 调整队列设置 命令 命令 说明 说明 /usage /usage 显示使用统计或成本摘要 显示使用统计或成本摘要 /think / /thinking / /t /think / /thinking / /t 设置思考级别（思考模式） 设置思考级别（思考模式） /verbose / /v /verbose / /v 切换详细模式 切换详细模式 /reasoning / /reason /reasoning / /reason 切换推理可见性 切换推理可见性 /elevated / /elev /elevated / /elev 切换提升模式 切换提升模式 /exec /exec 为当前会话设置 exec 默认值 为当前会话设置 exec 默认值 /model /model 显示或设置模型 显示或设置模型 /models /models 列出模型提供商或提供商模型 列出模型提供商或提供商模型 /queue /queue 调整队列设置 调整队列设置 📊 状态查询（Status） 命令 说明 /help 显示可用命令 /commands 列出所有斜杠命令 /status 显示当前状态 /context 解释上下文如何构建和使用 /export session / /export 将当前会话导出为包含完整系统提示的 HTML 文件 /whoami / /id 显示你的发送者 ID 命令 命令 说明 说明 /help /help 显示可用命令 显示可用命令 /commands /commands 列出所有斜杠命令 列出所有斜杠命令 /status /status 显示当前状态 显示当前状态 /context /context 解释上下文如何构建和使用 解释上下文如何构建和使用 /export session / /export /export session / /export 将当前会话导出为包含完整系统提示的 HTML 文件 将当前会话导出为包含完整系统提示的 HTML 文件 /whoami / /id /whoami / /id 显示你的发送者 ID 显示你的发送者 ID 🔧 管理（Management） 命令 说明 /allowlist [text] 列出/添加/删除白名单条目 /approve 批准或拒绝 exec 请求 /subagents 列出、终止、记录、生成或指导此会话的子代理运行 /acp 管理 ACP 会话和运行时选项 /focus 将此 Discord 线程（或新线程）绑定到会话目标 /unfocus 移除当前的 Discord 线程绑定 /agents 列出此会话的线程绑定代理 /kill 终止正在运行的子代理（或全部） /steer / /tell 向正在运行的子代理发送指导 /activation 设置组激活模式 /send 设置发送策略 命令 命令 说明 说明 /allowlist [text] /allowlist [text] 列出/添加/删除白名单条目 列出/添加/删除白名单条目 /approve /approve 批准或拒绝 exec 请求 批准或拒绝 exec 请求 /subagents /subagents 列出、终止、记录、生成或指导此会话的子代理运行 列出、终止、记录、生成或指导此会话的子代理运行 /acp /acp 管理 ACP 会话和运行时选项 管理 ACP 会话和运行时选项 /focus /focus 将此 Discord 线程（或新线程）绑定到会话目标 将此 Discord 线程（或新线程）绑定到会话目标 /unfocus /unfocus 移除当前的 Discord 线程绑定 移除当前的 Discord 线程绑定 /agents /agents 列出此会话的线程绑定代理 列出此会话的线程绑定代理 /kill /kill 终止正在运行的子代理（或全部） 终止正在运行的子代理（或全部） /steer / /tell /steer / /tell 向正在运行的子代理发送指导 向正在运行的子代理发送指导 /activation /activation 设置组激活模式 设置组激活模式 /send /send 设置发送策略 设置发送策略 🎙️ 媒体（Media） 命令 说明 /tts 控制文本转语音（TTS） 命令 命令 说明 说明 /tts /tts 控制文本转语音（TTS） 控制文本转语音（TTS） 🛠️ 工具（Tools） 命令 说明 /skill 按名称运行技能 /restart 重启 OpenClaw 命令 命令 说明 说明 /skill /skill 按名称运行技能 按名称运行技能 /restart /restart 重启 OpenClaw 重启 OpenClaw 作者：小ai 作者：小ai 建议复制全文制作成一个可视化的html 更方便使用 📘 本文档为 OpenClaw 完整命令手册，涵盖终端 CLI 命令和频道斜杠命令两大部分。 本文档为 OpenClaw 完整命令手册，涵盖终端 CLI 命令和频道斜杠命令两大部分。 💡 快速提示： • 终端命令：运行 openclaw help 或 openclaw <command help 查看详细帮助 • 斜杠命令：在频道中输入 /commands 查看可用命令列表 快速提示： • 终端命令：运行 openclaw help 或 openclaw <command help 查看详细帮助 • 斜杠命令：在频道中输入 /commands 查看可用命令列表 第一部分：终端命令（CLI） 以下命令在终端（Terminal / Shell）中运行，用于管理 OpenClaw 的安装、配置、服务和设备。 📦 全局参数 所有 CLI 命令都支持以下全局参数： 参数 说明 dev 在 /.openclaw dev 下隔离状态，并偏移默认端口 profile <name 在 /.openclaw <name 下隔离状态 no color 禁用 ANSI 颜色输出 update 执行更新（源码安装时可用） V, version, v 打印版本 json 输出 JSON 格式（禁用样式） 参数 参数 说明 说明 dev dev 在 /.openclaw dev 下隔离状态，并偏移默认端口 在 /.openclaw dev 下隔离状态，并偏移默认端口 profile <name profile <name 在 /.openclaw <name 下隔离状态 在 /.openclaw <name 下隔离状态 no color no color 禁用 ANSI 颜色输出 禁用 ANSI 颜色输出 update update 执行更新（源码安装时可用） 执行更新（源码安装时可用） V, version, v V, version, v 打印版本 打印版本 json json 输出 JSON 格式（禁用样式） 输出 JSON 格式（禁用样式） 🚀 安装与初始化 setup 初始化配置和工作区。 选项： • workspace <dir 指定工作区路径（默认 /.openclaw/workspace） • wizard 运行入职向导 • non interactive 非交互模式运行向导 • mode <local|remote 向导模式 • remote url <url 远程 Gateway URL • remote token <token 远程 Gateway token 示例： onboard 交互式向导，设置 gateway、工作区和技能。 选项： • workspace <dir 工作区路径 • reset 重置配置和凭证 • reset scope <config|config+creds+sessions|full 重置范围 • non interactive 非交互模式 • mode <local|remote 运行模式 • flow <quickstart|advanced|manual 流程类型 • auth choice <... 认证方式选择 • gateway port <port Gateway 端口 • gateway bind <loopback|lan|tailnet|auto 绑定模式 • gateway auth <token|password 认证方式 • install daemon 安装守护进程 • skip channels 跳过通道配置 • skip skills 跳过技能配置 示例： configure 交互式配置向导（模型、通道、技能、Gateway）。 ⚙️ 配置管理 config get 获取配置值。 config set 设置配置值。 config unset 移除配置值。 config file 打印当前使用的配置文件路径。 config validate 验证当前配置（不启动 Gateway）。 📱 通道管理 channels list 列出已配置的通道和账号。 channels status 检查 Gateway 可达性和通道健康状态。 channels logs 显示通道最近的日志。 channels add 添加新通道账号（非交互模式）。 选项： • channel <name 通道类型（whatsapp/telegram/discord/googlechat/slack/signal/imessage/msteams） • account <id 账号 ID • name <label 显示名称 • token <token Bot token 示例： channels remove 移除通道账号。 channels login 交互式通道登录（WhatsApp Web）。 channels logout 登出通道会话。 🤖 Agent 管理 agents list 列出已配置的 agent。 agents add 添加新的独立 agent。 选项： • workspace <dir 工作区路径（必填） • model <id 默认模型 • agent dir <dir agent 目录 • bind <channel[:accountId] 绑定通道（可重复） • non interactive 非交互模式 示例： agents delete 删除 agent 及其工作区和状态。 agents bindings 列出路由绑定。 agents bind 添加路由绑定。 agents unbind 移除路由绑定。 🧠 模型管理 models 查看模型状态（models status 的别名）。 models list 列出可用模型。 选项： • all 显示所有模型 • local 仅本地模型 • provider <name 按提供者筛选 • json JSON 输出 示例： models status 显示认证状态和模型配置。 选项： • json JSON 输出 • plain 纯文本输出 • check 检查过期状态（退出码 1=过期/缺失，2=即将过期） • probe 探测配置的认证配置 • probe provider <name 探测指定提供者 • probe profile <id 探测指定 profile 示例： models set 设置默认模型。 models set image 设置默认图像模型。 models aliases 管理模型别名。 models fallbacks 管理模型备选列表。 models image fallbacks 管理图像模型备选列表。 models scan 扫描 OpenRouter 的免费模型。 选项： • min params <b 最小参数量 • max age days <days 最大模型年龄 • provider <name 按提供者筛选 • max candidates <n 最大候选数 • set default 设置为默认模型 • set image 设置为默认图像模型 • yes 自动确认 • no input 无输入模式 示例： models auth add 添加模型认证。 models auth setup token 使用 Anthropic setup token 认证。 models auth paste token 粘贴 token 认证。 models auth order 管理认证顺序。 📊 系统与健康 status 显示链接的会话健康状态和最近收件人。 选项： • json JSON 输出 • all 完整诊断 • deep 深度探测通道 • usage 显示提供者使用情况/配额 • verbose 详细输出 • timeout <ms 超时时间 示例： health 从运行的 Gateway 获取健康状态。 选项： • json JSON 输出 • verbose 详细输出 • timeout <ms 超时时间 doctor 健康检查和快速修复（配置 + Gateway + 遗留服务）。 选项： • no workspace suggestions 禁用工作区提示 • yes 自动接受默认值 • non interactive 跳过提示 • deep 扫描系统服务的额外 Gateway 安装 示例： logs 通过 RPC 追踪 Gateway 文件日志。 选项： • follow 持续跟踪 • limit <n 限制行数 • plain 纯文本输出 • json JSON 输出 • no color 禁用颜色 示例： 🌐 Gateway 服务 gateway 运行 WebSocket Gateway。 选项： • port <port 监听端口 • bind <loopback|tailnet|lan|auto 绑定模式 • token <token 认证 token • auth <token|password 认证方式 • password <password 密码 • password file <path 密码文件路径 • tailscale <off|serve|funnel Tailscale 模式 • dev 开发模式 • force 强制占用端口 • verbose 详细输出 • ws log <auto|full|compact WebSocket 日志级别 示例： gateway status 显示 Gateway 状态。 gateway install 安装 Gateway 服务（launchd/systemd）。 选项： • port <port 端口 • runtime <node|bun 运行时 • token <token 认证 token • force 强制安装 • json JSON 输出 gateway uninstall 卸载 Gateway 服务。 gateway start / stop / restart 管理 Gateway 服务。 gateway call 调用 Gateway RPC 方法。 gateway health 检查 Gateway 健康状态。 gateway probe 探测 Gateway 服务。 gateway discover 发现 Gateway 实例。 🎯 节点与设备 nodes status 显示节点状态。 选项： • connected 仅显示已连接的节点 • last connected <duration 最近连接的节点 nodes list 列出节点。 nodes describe 查看节点详细信息。 nodes pending 列出待审批的节点请求。 nodes approve / reject 审批或拒绝节点请求。 nodes rename 重命名节点。 nodes invoke 在节点上调用命令。 nodes run 在节点上运行命令。 nodes notify 发送通知到节点（macOS only）。 nodes camera list / snap / clip 节点摄像头控制。 nodes canvas snapshot / present / hide / navigate / eval / a2ui 节点画布和屏幕操作。 nodes screen record 节点屏幕录制。 nodes location get 获取节点位置信息。 🌐 浏览器控制 browser status / start / stop 管理浏览器服务。 browser tabs 列出浏览器标签页。 browser open 打开 URL。 browser focus 聚焦到指定标签页。 browser close 关闭标签页。 browser screenshot 截图。 browser snapshot 获取页面快照。 browser navigate 导航到 URL。 browser resize 调整窗口大小。 browser click / type / press / hover / drag / select 页面交互操作。 browser upload 上传文件。 browser fill 填充表单。 browser dialog 处理对话框。 browser wait 等待条件。 browser evaluate / execute 执行 JavaScript。 browser console 控制台操作。 browser pdf 导出 PDF。 browser profiles / create profile / delete profile 管理浏览器配置文件。 browser reset profile 重置浏览器配置文件。 📅 计划任务（Cron） cron status 显示 cron 服务状态。 cron list 列出计划任务。 cron add 添加计划任务。 必需参数： • name <name 任务名称 • 以下之一： at <time | every <duration | cron <expression • 以下之一： system event <event | message <text 示例： cron edit 编辑计划任务。 cron rm 删除计划任务。 cron enable / disable 启用/禁用任务。 cron runs 查看任务运行历史。 cron run 手动运行任务。 🔧 其他工具 memory status / index / search 管理内存向量搜索。 system event / heartbeat / presence 系统事件和心跳控制。 security audit 安全审计。 secrets reload / migrate / configure 密钥管理。 🚢 停靠切换（Docks） 命令 说明 /dock telegram / /dock telegram 切换到 Telegram 进行回复 /dock discord / /dock discord 切换到 Discord 进行回复 /dock slack / /dock slack 切换到 Slack 进行回复 /dock feishu / /dock feishu 切换到飞书进行回复 命令 命令 说明 说明 /dock telegram / /dock telegram /dock telegram / /dock telegram 切换到 Telegram 进行回复 切换到 Telegram 进行回复 /dock discord / /dock discord /dock discord / /dock discord 切换到 Discord 进行回复 切换到 Discord 进行回复 /dock slack / /dock slack /dock slack / /dock slack 切换到 Slack 进行回复 切换到 Slack 进行回复 /dock feishu / /dock feishu /dock feishu / /dock feishu 切换到飞书进行回复 切换到飞书进行回复 🔌 飞书插件（Plugins） 命令 说明 /feishu diagnose 运行飞书插件诊断，检查配置、连通性和权限状态 /feishu doctor 运行飞书插件诊断 /feishu auth 飞书用户权限批量授权 /feishu 飞书插件命令（支持子命令：auth, onboarding, doctor） 命令 命令 说明 说明 /feishu diagnose /feishu diagnose 运行飞书插件诊断，检查配置、连通性和权限状态 运行飞书插件诊断，检查配置、连通性和权限状态 /feishu doctor /feishu doctor 运行飞书插件诊断 运行飞书插件诊断 /feishu auth /feishu auth 飞书用户权限批量授权 飞书用户权限批量授权 /feishu /feishu 飞书插件命令（支持子命令：auth, onboarding, doctor） 飞书插件命令（支持子命令：auth, onboarding, doctor） 🔗 相关链接 • 官方网站：https://openclaw.ai • 官方文档：https://docs.openclaw.ai/zh CN • GitHub：https://github.com/openclaw/openclaw