磁头笔记:OpenClaw常用指令

磁头笔记:OpenClaw常用指令

OpenClaw 更新非常快,本文基于 2026.3.x 版本,整理基础指令和进阶指令。基础指令适合新手快速上手,掌握启动对话、切换模型、查看状态等操作;进阶指令适合需要深度定制工作流的用户,利用子代理、权限控制、配置调优等高级功能。

一、基础指令:新手必备

1. 启动对话界面

1
openclaw tui

使用场景: 这是新版 OpenClaw 的主要交互方式,启动一个终端 UI(Terminal User Interface),支持消息历史、工具调用卡片、快捷键操作等。

前置操作: 如果 TUI 连接失败,请先启动 Gateway:

1
openclaw gateway

2. 查看整体状态

1
2
3
4
5
# 查看整体状态
openclaw status

# 或查看网关状态
openclaw gateway status

使用场景: 快速确认当前使用的模型、API 连接状态、工具权限配置(tools.profile)等。在开始重要任务前,先运行此命令确保一切正常。

3. 在对话中切换模型

在 TUI 界面内,使用斜杠命令:

1
/model <模型标识>

使用场景: 当你需要更高推理能力时(如复杂代码生成),从默认模型切换到 gpt-5.2claude-3.5-sonnet;或为了节省成本,切换回轻量模型。

4. 查看可用模型列表

在 TUI 界面内:

1
/model list

使用场景: 查看当前配置下可用的所有模型,确认是否正确接入阿里云百炼、OpenAI 等 API 服务。

5. 重置当前会话

在 TUI 界面内:

1
2
3
/new
# 或
/reset

使用场景: 当对话上下文混乱或需要开始全新话题时,快速清空历史,开始新对话。


二、进阶指令

1. 子代理管理(并行任务)

在 TUI 界面内:

1
2
3
/subagents spawn        # 创建子代理
/subagents list # 列出子代理
/kill <代理 ID> # 终止指定子代理

使用场景: 同时处理多个独立任务(如一边让主代理写周报,一边让子代理查资料),实现多任务并行。

2. 提权模式(执行操作)

在 TUI 界面内:

1
2
/elevated full          # 开启完整权限
/elevated ask # 高权限操作需确认

使用场景: OpenClaw 2026.3.x 版本默认关闭了工具权限,导致无法调用 Skills 或执行命令。开启 elevated full 或设置 tools.profile full 可恢复所有操作能力。

3. 导出会话记录

在 TUI 界面内:

1
/export-session ./my_session.html

使用场景: 将当前对话导出为 HTML 文件,方便归档或分享。

4. 控制思考深度

在 TUI 界面内:

1
2
/think high             # 高思考深度,推理更详细
/think off # 关闭思考,响应更快

使用场景: 调整 AI 的推理时间和详细程度。复杂逻辑问题用 high,简单问答用 off 提升速度。

5. 查看 Token 用量

在 TUI 界面内:

1
/usage full             # 显示完整用量信息

使用场景: 监控 API 消耗,避免超额。尤其在处理长文本或高频使用时,实时掌握成本。

6. 配置管理与调试

1
2
3
4
5
6
7
8
# 开启所有工具权限
openclaw config set tools.profile full

# 查看当前权限设置
openclaw config get tools.profile

# 列出所有配置
openclaw config list

使用场景: 解决权限问题(如”无法调用工具”),或批量调整系统配置。

7. 查看日志排查问题

1
openclaw logs --follow

使用场景: 当 TUI 连接断开、工具调用失败或模型无响应时,实时跟踪日志定位错误原因。


三、常用快捷键

快捷键 功能说明
Ctrl+C 中断当前操作
Ctrl+L 清屏
Ctrl+D 退出 TUI
↑/↓ 查看历史消息
Tab 自动补全命令

四、常见问题

1. TUI 连接失败

1
2
3
4
5
6
7
8
# 检查 Gateway 是否运行
openclaw gateway status

# 启动 Gateway
openclaw gateway

# 查看日志
openclaw logs --follow

2. 无法调用工具

1
2
3
4
5
# 检查权限配置
openclaw config get tools.profile

# 开启完整权限
openclaw config set tools.profile full

3. 模型切换失败

1
2
3
4
5
# 查看可用模型
/model list

# 检查 API 配置
openclaw config list

4. Token 消耗过快

1
2
3
4
5
6
7
8
# 查看用量
/usage full

# 切换到轻量模型
/model <轻量模型标识>

# 降低思考深度
/think off

注意事项

  • ⚠️ 本文基于 OpenClaw 2026.3.x 版本,不同版本指令可能有差异
  • ⚠️ 提权模式请谨慎使用,确保在安全环境下操作
  • ⚠️ 定期查看 Token 用量,避免 API 超额
  • ⚠️ 敏感配置(如 API 密钥)不要提交到代码仓库

技术工具的生命力在于持续迭代!更多指令请参考官方文档和社区讨论。

原文参考:OpenClaw常用指令清单,新手与进阶


磁头笔记:OpenClaw常用指令
https://blog.luluvip.cn/2026/04/22/磁头笔记-OpenClaw-常用指令/
作者
Sagit.
发布于
2026年4月22日
许可协议