本手册按照功能域对OpenClaw 端侧中控指令集进行分层归类，覆盖运维部署、服务管控、模组调度、会话链路、诊断排障等全场景指令。可使用浏览器检索功能快速定位目标指令。
标准调用范式
所有终端交互指令遵循统一调用结构：
bash
运行
openclaw <指令主体> [附属参数]
单条指令调取详情文档、参数说明：
bash
运行
openclaw <指令主体> --guide
一、基座部署域｜环境初始化与版本管控
负责生态基座初始化、版本迭代、卸载回收、版本核验，适配全新部署、版本升级、环境迁移场景。
表格
| 指令 | 功能释义 | 实操示例 |
|---|---|---|
openclaw onboard | 交互式初始化向导，完成基座基础参数配置 | openclaw onboard |
openclaw update | 在线拉取程序包，完成基座版本迭代更新 | openclaw update |
openclaw uninstall | 完整卸载基座，清理运行文件与配置 | openclaw uninstall |
openclaw --edition | 查看当前运行基座版本、编译标识 | openclaw --edition |
二、中枢网关域｜核心网关服务生命周期管控
针对生态核心转发网关进行启停、重启、后台驻留、前台调试等全生命周期管理，网关为全模组、会话、指令的流转中枢。
表格
| 指令 | 功能释义 | 实操示例 |
|---|---|---|
openclaw gateway probe | 探测网关进程、端口、链路运行状态 | openclaw gateway probe |
openclaw gateway reload | 热重启网关服务，重载配置不中断长连接 | openclaw gateway reload |
openclaw gateway halt | 停止网关进程，释放占用端口与资源 | openclaw gateway halt |
openclaw gateway daemonize | 将网关注册为系统后台常驻服务 | openclaw gateway daemonize |
openclaw gateway debug | 前台拉起网关，输出完整日志用于排障调试 | openclaw gateway debug |
补充说明：
daemonize会自适应操作系统，Linux 适配 systemd、macOS 适配 launchd、Windows 适配系统计划任务。
三、功能模组域｜技能单元全生命周期调度
基于 ClawHub 模组仓库，实现自研功能单元的安装、检索、迭代、卸载、信息查看、远端同步，所有模组统一存储于私有工作区。
表格
| 指令 | 功能释义 | 实操示例 |
|---|---|---|
clawhub acquire <模组名> | 从仓库拉取并安装指定功能模组 | clawhub acquire docker-sandbox |
clawhub catalog | 罗列当前环境已部署的全部功能模组 | clawhub catalog |
clawhub refresh --all | 批量更新本地所有已部署模组至最新版本 | clawhub refresh --all |
clawhub refresh <模组名> | 单独迭代更新指定功能模组 | clawhub refresh docker-sandbox |
clawhub discard <模组名> | 卸载指定模组，清理对应运行目录 | clawhub discard docker-sandbox |
clawhub inspect <模组名> | 查看模组架构、权限、接口、版本详情 | clawhub inspect docker-sandbox |
clawhub synchronize | 本地模组配置、版本同步至远端仓库 | clawhub synchronize |
存储路径：所有部署模组默认存放路径
~/.openclaw/skills/
四、链路通道域｜外部交互通道运维管理
管理生态对外交互通道，完成通道状态探测、身份绑定、通道列表检索，支撑多端、多载体接入能力。
表格
| 指令 | 功能释义 | 实操示例 |
|---|---|---|
openclaw channels overview | 批量探测所有接入通道的连通状态 | openclaw channels overview |
openclaw channels bind <通道名> | 完成通道身份校验、账号配对绑定 | openclaw channels bind whatsapp |
openclaw channels inventory | 展示当前已完成配置的全部交互通道 | openclaw channels inventory |
五、交互会话域｜对话链路生命周期管理
管控智能体交互会话，实现会话列表查询、历史链路回溯、过期会话资源回收，优化内存占用。
表格
| 指令 | 功能释义 | 实操示例 |
|---|---|---|
openclaw sessions inventory | 罗列当前所有活跃会话与会话标识 | openclaw sessions inventory |
openclaw sessions trace <会话ID> | 回溯指定会话的完整交互历史记录 | openclaw sessions trace 001 |
openclaw sessions purge | 自动清理超时、闲置的无效会话 | openclaw sessions purge |
会话快捷指令：交互界面内输入
/new新建会话，/reset清空当前会话上下文。
六、全局配置域｜工作区参数读写与初始化
负责全局配置查看、交互式参数修改、工作区环境重置，配置文件为整个生态的参数总入口。
表格
| 指令 | 功能释义 | 实操示例 |
|---|---|---|
openclaw config overview | 查看当前全局所有运行参数 | openclaw config overview |
openclaw config edit | 交互式编辑器，可视化修改全局配置 | openclaw config edit |
openclaw workspace reset | 重置工作区目录结构，恢复初始状态 | openclaw workspace reset |
配置文件路径：
~/.openclaw/openclaw.json
七、环境诊察域｜故障自检与健康度核验
内置多层级诊察工具，从深度排障、快速体检、全局状态三个维度检测环境异常，是运维排障核心工具集。
表格
| 指令 | 功能释义 | 实操示例 |
|---|---|---|
openclaw diagnose | 全维度深度诊察，检测依赖、权限、端口、文件异常并输出修复方案 | openclaw diagnose |
openclaw health-check | 轻量化健康体检，快速核验核心服务可用性 | openclaw health-check |
openclaw system-profile | 输出生态整体运行轮廓、资源占用、服务状态 | openclaw system-profile |
运维建议：环境出现异常时，优先执行
openclaw diagnose，可自动定位绝大多数常规故障。
八、记忆向量域｜上下文记忆体系运维
管控内置记忆向量库，支持状态探测、语义检索、索引重建，保障长上下文记忆的检索与读写效率。
表格
| 指令 | 功能释义 | 实操示例 |
|---|---|---|
openclaw memory profile | 查看记忆库容量、索引状态、读写负载 | openclaw memory profile |
openclaw memory retrieve <关键词> | 基于语义检索记忆库内对应内容 | openclaw memory retrieve "数据库配置" |
openclaw memory rebuild-index | 重建记忆检索索引，修复索引损坏、检索卡顿问题 | openclaw memory rebuild-index |
记忆持久化文件路径：
~/.openclaw/workspace/MEMORY.md
九、时序任务域｜周期调度任务管控
基于时序规则配置自动化周期任务，支持任务列表查看、新增、移除，兼容标准 Cron 时序表达式。
表格
| 指令 | 功能释义 | 实操示例 |
|---|---|---|
openclaw cron inventory | 罗列所有已创建的时序调度任务 | openclaw cron inventory |
openclaw cron create | 新建自定义周期调度任务 | openclaw cron create "每日生成工作简报" |
openclaw cron remove <任务ID> | 删除指定时序任务 | openclaw cron remove 3 |
时序表达式实操范例
bash
运行
# 每日上午9点执行任务
openclaw cron create --schedule "0 9 * * *" --message "生成今日工作报告"
# 每周一上午10点执行任务
openclaw cron create --schedule "0 10 * * 1" --message "盘点本周待办事项"
# 每小时轮询执行任务
openclaw cron create --schedule "0 * * * *" --message "巡检外部邮件消息"
十、触发钩子域｜事件联动钩子管理
管理全局事件触发钩子，实现动作监听、联动触发，支持钩子查看、新增、销毁。
表格
| 指令 | 功能释义 | 实操示例 |
|---|---|---|
openclaw hooks inventory | 展示全部已注册事件钩子 | openclaw hooks inventory |
openclaw hooks create | 新增自定义事件联动钩子 | openclaw hooks create |
openclaw hooks remove <钩子ID> | 销毁指定事件钩子 | openclaw hooks remove 2 |
十一、页面交互域｜浏览器会话与凭证托管
内置浏览器交互组件，实现网页登录、凭证持久化，自动复用登录态访问受限站点。
表格
| 指令 | 功能释义 | 实操示例 |
|---|---|---|
openclaw browser-auth | 唤起浏览器完成网页登录，自动持久化会话凭证 | openclaw browser-auth |
特性说明：凭证自动交由内置组件托管，后续访问同源站点可免重复登录。
十二、智能交互域｜终端交互与日志查看
拉起智能体交互终端、TUI 可视化界面，同时支持全链路运行日志调取。
表格
| 指令 | 功能释义 | 实操示例 |
|---|---|---|
openclaw agent launch | 拉起终端交互式智能体对话 | openclaw agent launch |
openclaw agent send "内容" | 单次投递消息并获取返回结果 | openclaw agent send "你好" |
openclaw tui launch | 启动终端可视化操作界面 | openclaw tui launch |
openclaw log stream | 实时查看全系统运行日志流 | openclaw log stream |
十三、扩展插件域｜附加插件单元管控
针对轻量化扩展插件进行部署、检索、卸载，插件生效需重启核心网关。
表格
| 指令 | 功能释义 | 实操示例 |
|---|---|---|
openclaw plugins acquire <插件名> | 安装第三方扩展插件 | openclaw plugins acquire voice-call |
openclaw plugins inventory | 罗列当前已加载的全部插件 | openclaw plugins inventory |
openclaw plugins discard <插件名> | 卸载指定扩展插件 | openclaw plugins discard voice-call |
生效规则：插件安装 / 卸载完成后，执行
openclaw gateway reload方可加载变更。
十四、会话内快捷指令｜交互界面内嵌指令
在对话交互窗口中，使用斜杠快捷指令快速完成操作，无需切换终端。
表格
| 内嵌指令 | 功能释义 |
|---|---|
/new | 新建独立交互会话 |
/reset | 清空当前会话上下文 |
/pause | 终止当前正在执行的任务 |
/profile | 查看当前环境与会话状态 |
/guide | 调取内嵌帮助文档 |
十五、标准运维流程模板
1. 全新基座部署全流程
bash
运行
# 1. 拉取并执行部署脚本
curl -fsSL https://get.openclaw.ai | bash
# 2. 交互式初始化配置
openclaw onboard
# 3. 深度诊察环境完整性
openclaw diagnose
# 4. 前台启动网关服务
openclaw gateway debug
# 5. 安装测试模组验证环境
clawhub acquire docker-sandbox
2. 日常常态化运维流程
bash
运行
# 查看系统整体状态
openclaw system-profile
# 升级基座版本
openclaw update
# 批量更新所有功能模组
clawhub refresh --all
# 查看实时运行日志
openclaw log stream
3. 故障排查标准流程
bash
运行
# 第一步：全维度环境诊断
openclaw diagnose
# 第二步：核查网关服务状态
openclaw gateway probe
# 第三步：检测外部通道连通性
openclaw channels overview
# 第四步：调取日志定位异常
openclaw log stream
十六、全局环境变量｜终端行为自定义参数
通过环境变量修改指令默认行为、工作目录、日志等级等全局规则。
表格
| 环境变量 | 功能释义 | 配置示例 |
|---|---|---|
OPENCLAW_WORKSPACE | 自定义生态数据与配置根目录 | export OPENCLAW_WORKSPACE=~/my-claw-space |
OPENCLAW_LOG_LEVEL | 定义日志输出等级 | export OPENCLAW_LOG_LEVEL=debug |
手册总结
本全域终端调度指令集，覆盖 OpenClaw 生态基座部署、网关服务、模组管理、会话链路、诊察排障、记忆调度、时序任务等全业务域指令，是端侧中控运维的标准检索手册。
两个核心通用指令建议牢记：
openclaw diagnose— 环境异常优先执行深度诊察openclaw <指令主体> --guide— 任意指令调取详细参数与用法