OpenClaw 命令行工具速查手册#

概述#

OpenClaw 提供了丰富的命令行工具，方便用户快速配置、管理和使用 AI 助手。本文档整理了最常用的 CLI 命令和斜杠命令，帮助你高效地操作 OpenClaw。

CLI 命令#

查看帮助#

PRTCL // BASH

1
# 查看所有可用命令
2
openclaw --help
3

4
# 查看特定命令的帮助
5
openclaw <command> --help
6

7
# 查看版本信息
8
openclaw --version

初始化配置#

PRTCL // BASH

1
# 启动配置向导
2
openclaw onboard
3

4
# 初始化配置文件
5
openclaw init
6

7
# 验证配置
8
openclaw config validate

服务管理#

PRTCL // BASH

1
# 启动 OpenClaw 服务
2
openclaw start
3

4
# 停止 OpenClaw 服务
5
openclaw stop
6

7
# 重启 OpenClaw 服务
8
openclaw restart
9

10
# 查看服务状态
11
openclaw status
12

13
# 查看服务日志
14
openclaw logs
15

16
# 实时查看日志
17
openclaw logs -f

Agent 管理#

PRTCL // BASH

1
# 列出所有 Agent
2
openclaw agent list
3

4
# 查看特定 Agent 信息
5
openclaw agent info <agent-id>
6

7
# 创建新 Agent
8
openclaw agent create <name>
9

10
# 删除 Agent
11
openclaw agent delete <agent-id>
12

13
# 启用 Agent
14
openclaw agent enable <agent-id>
15

16
# 禁用 Agent
17
openclaw agent disable <agent-id>
18

19
# 重新加载 Agent 配置
20
openclaw agent reload

技能管理#

PRTCL // BASH

1
# 列出已安装的技能
2
openclaw skill list
3

4
# 安装技能
5
openclaw skill install <skill-name>
6

7
# 卸载技能
8
openclaw skill uninstall <skill-name>
9

10
# 更新技能
11
openclaw skill update <skill-name>
12

13
# 搜索技能
14
openclaw skill search <keyword>

渠道管理#

PRTCL // BASH

1
# 列出所有渠道
2
openclaw channel list
3

4
# 查看渠道状态
5
openclaw channel status <channel-name>
6

7
# 添加渠道
8
openclaw channel add <channel-name>
9

10
# 删除渠道
11
openclaw channel remove <channel-name>
12

13
# 测试渠道连接
14
openclaw channel test <channel-name>

工作流管理#

PRTCL // BASH

1
# 列出所有工作流
2
openclaw workflow list
3

4
# 执行工作流
5
openclaw workflow run <workflow-id>
6

7
# 查看工作流状态
8
openclaw workflow status <execution-id>
9

10
# 暂停工作流
11
openclaw workflow pause <execution-id>
12

13
# 恢复工作流
14
openclaw workflow resume <execution-id>
15

16
# 取消工作流
17
openclaw workflow cancel <execution-id>
18

19
# 查看工作流日志
20
openclaw workflow logs <execution-id>

模型管理#

PRTCL // BASH

1
# 列出可用模型
2
openclaw model list
3

4
# 设置默认模型
5
openclaw model default <model-id>
6

7
# 添加模型提供商
8
openclaw model provider add <provider-name>
9

10
# 移除模型提供商
11
openclaw model provider remove <provider-name>
12

13
# 测试模型连接
14
openclaw model test <model-id>

配置管理#

PRTCL // BASH

1
# 查看当前配置
2
openclaw config show
3

4
# 编辑配置
5
openclaw config edit
6

7
# 导出配置
8
openclaw config export <output-file>
9

10
# 导入配置
11
openclaw config import <input-file>
12

13
# 重置配置
14
openclaw config reset

数据管理#

PRTCL // BASH

1
# 查看数据目录
2
openclaw data dir
3

4
# 备份数据
5
openclaw data backup <backup-path>
6

7
# 恢复数据
8
openclaw data restore <backup-path>
9

10
# 清理缓存
11
openclaw data clear-cache
12

13
# 查看数据大小
14
openclaw data size

诊断工具#

PRTCL // BASH

1
# 运行诊断
2
openclaw diagnose
3

4
# 健康检查
5
openclaw health
6

7
# 查看系统信息
8
openclaw info
9

10
# 生成诊断报告
11
openclaw report generate

斜杠命令（聊天中）#

斜杠命令可以在 OpenClaw 的聊天界面中使用，用于快速执行特定操作。

帮助命令#

PRTCL // PLAINTEXT

1
/help                    # 显示帮助信息
2
/commands               # 列出所有可用命令
3
/about                  # 关于 OpenClaw

会话管理#

PRTCL // PLAINTEXT

1
/clear                  # 清除当前对话历史
2
/new                    # 开始新的对话
3
/history                # 查看对话历史
4
/export                 # 导出对话内容
5
/reset                  # 重置 Agent 状态

Agent 操作#

PRTCL // PLAINTEXT

1
/agent list             # 列出可用 Agent
2
/agent switch <name>    # 切换到指定 Agent
3
/agent info             # 查看当前 Agent 信息
4
/agent reset            # 重置当前 Agent

技能操作#

PRTCL // PLAINTEXT

1
/skill list             # 列出可用技能
2
/skill use <name>       # 使用指定技能
3
/skill info <name>      # 查看技能信息

工作流操作#

PRTCL // PLAINTEXT

1
/workflow list          # 列出可用工作流
2
/workflow run <name>    # 运行工作流
3
/workflow status        # 查看工作流状态

配置操作#

PRTCL // PLAINTEXT

1
/config show            # 显示当前配置
2
/config model <model>   # 切换模型
3
/config temp <value>    # 设置温度参数
4
/config max <value>     # 设置最大 Token 数

文件操作#

PRTCL // PLAINTEXT

1
/file list              # 列出可访问的文件
2
/file read <path>       # 读取文件内容
3
/file write <path>      # 写入文件内容
4
/file delete <path>     # 删除文件

工具操作#

PRTCL // PLAINTEXT

1
/tool list              # 列出可用工具
2
/tool use <name>        # 使用指定工具
3
/tool search <keyword>  # 搜索工具

任务管理#

PRTCL // PLAINTEXT

1
/task list              # 列出运行中的任务
2
/task stop <id>         # 停止指定任务
3
/task status <id>       # 查看任务状态

记忆操作#

PRTCL // PLAINTEXT

1
/memory save            # 保存当前对话到记忆
2
/memory recall          # 检索相关记忆
3
/memory clear           # 清除记忆
4
/memory search <query>  # 搜索记忆

常用组合命令#

快速重启服务#

PRTCL // BASH

1
# 停止并重新启动
2
openclaw stop && openclaw start
3

4
# 重启并查看日志
5
openclaw restart && openclaw logs -f

批量更新技能#

PRTCL // BASH

1
# 更新所有已安装的技能
2
openclaw skill list | awk '{print $1}' | xargs -I {} openclaw skill update {}

配置备份#

PRTCL // BASH

1
# 创建配置备份
2
openclaw config export backup-$(date +%Y%m%d).yaml
3

4
# 备份完整数据
5
openclaw data backup backup-$(date +%Y%m%d).tar.gz

健康检查#

PRTCL // BASH

1
# 全面健康检查
2
openclaw health && openclaw diagnose

清理和优化#

PRTCL // BASH

1
# 清理缓存和日志
2
openclaw data clear-cache
3

4
# 清理旧备份
5
find ~/.openclaw/backups -name "*.tar.gz" -mtime +30 -delete

环境变量#

OpenClaw 支持通过环境变量进行配置。

通用配置#

PRTCL // BASH

1
# API Key
2
export OPENCLAW_API_KEY="your-api-key"
3

4
# API 端点
5
export OPENCLAW_API_ENDPOINT="https://api.openclaw.ai"
6

7
# 配置目录
8
export OPENCLAW_CONFIG_DIR="~/.openclaw"
9

10
# 数据目录
11
export OPENCLAW_DATA_DIR="~/.openclaw/data"

模型配置#

PRTCL // BASH

1
# 默认模型
2
export OPENCLAW_DEFAULT_MODEL="gpt-4o-mini"
3

4
# 温度参数
5
export OPENCLAW_TEMPERATURE=0.7
6

7
# 最大 Token 数
8
export OPENCLAW_MAX_TOKENS=2000

日志配置#

PRTCL // BASH

1
# 日志级别
2
export OPENCLAW_LOG_LEVEL="info"
3

4
# 日志文件
5
export OPENCLAW_LOG_FILE="~/.openclaw/logs/openclaw.log"

网络配置#

PRTCL // BASH

1
# 代理设置
2
export HTTP_PROXY="http://proxy.example.com:8080"
3
export HTTPS_PROXY="http://proxy.example.com:8080"
4

5
# 超时设置
6
export OPENCLAW_TIMEOUT=30

快捷键#

终端快捷键#

PRTCL // PLAINTEXT

1
Ctrl + C          # 停止当前命令
2
Ctrl + Z          # 暂停当前命令
3
Ctrl + D          # 退出会话
4
Ctrl + L          # 清屏
5
Ctrl + A          # 移动到行首
6
Ctrl + E          # 移动到行尾
7
Ctrl + U          # 删除到行首
8
Ctrl + K          # 删除到行尾

聊天界面快捷键#

PRTCL // PLAINTEXT

1
Ctrl + Enter      # 发送消息
2
Ctrl + C          # 取消输入
3
Ctrl + L          # 清屏
4
↑ / ↓            # 浏览历史命令
5
Tab               # 自动补全

故障排查命令#

连接问题#

PRTCL // BASH

1
# 测试 API 连接
2
openclaw model test
3

4
# 检查网络连接
5
curl -I https://api.openclaw.ai
6

7
# 查看端口占用
8
netstat -ano | findstr :3000  # Windows
9
lsof -i :3000                 # Linux/macOS

性能问题#

PRTCL // BASH

1
# 查看资源使用
2
openclaw info
3

4
# 查看性能指标
5
openclaw diagnose
6

7
# 查看详细日志
8
openclaw logs -f --level=debug

配置问题#

PRTCL // BASH

1
# 验证配置
2
openclaw config validate
3

4
# 查看当前配置
5
openclaw config show
6

7
# 重置配置
8
openclaw config reset

最佳实践#

日常使用#

定期备份：每周备份一次配置和数据
监控日志：定期检查日志文件，及时发现异常
更新维护：及时更新 OpenClaw 和技能到最新版本

性能优化#

清理缓存：定期清理缓存释放空间
调整参数：根据实际需求调整温度和 Token 限制
选择模型：根据任务复杂度选择合适的模型

安全建议#

保护密钥：不要将 API Key 提交到版本控制
使用环境变量：敏感信息使用环境变量存储
限制访问：配置适当的权限和访问控制

常见问题#

Q: 如何查看所有可用命令？#

PRTCL // BASH

1
# CLI 命令
2
openclaw --help
3

4
# 聊天斜杠命令
5
/help 或 /commands

Q: 命令执行失败怎么办？#

PRTCL // BASH

1
# 查看详细错误信息
2
openclaw logs -f
3

4
# 运行诊断
5
openclaw diagnose
6

7
# 验证配置
8
openclaw config validate

Q: 如何更新 OpenClaw？#

PRTCL // BASH

1
# 使用包管理器更新
2
npm update -g openclaw
3

4
# 或重新安装最新版本
5
npm install -g openclaw@latest

Q: 如何卸载 OpenClaw？#

PRTCL // BASH

1
# 卸载程序
2
npm uninstall -g openclaw
3

4
# 删除配置和数据
5
rm -rf ~/.openclaw

资源链接#

官方文档: https://docs.openclaw.ai/cli
GitHub 仓库: https://github.com/openclaw/openclaw
社区支持: https://community.openclaw.ai

最后更新: 2026-03-12 作者: EchoHaoRan

OpenClaw 命令行工具速查手册#

概述#

CLI 命令#

查看帮助#

初始化配置#

服务管理#

Agent 管理#

技能管理#

渠道管理#

工作流管理#

模型管理#

配置管理#

数据管理#

诊断工具#

斜杠命令（聊天中）#

帮助命令#

会话管理#

Agent 操作#

技能操作#

工作流操作#

配置操作#

文件操作#

工具操作#

任务管理#

记忆操作#

常用组合命令#

快速重启服务#

批量更新技能#

配置备份#

健康检查#

清理和优化#

环境变量#

通用配置#

模型配置#

日志配置#

网络配置#

快捷键#

终端快捷键#

聊天界面快捷键#

故障排查命令#

连接问题#

性能问题#

配置问题#

最佳实践#

日常使用#

性能优化#

安全建议#

常见问题#

Q: 如何查看所有可用命令？#

Q: 命令执行失败怎么办？#

Q: 如何更新 OpenClaw？#

Q: 如何卸载 OpenClaw？#

资源链接#

OpenClaw命令行工具速查手册

OpenClaw工作流的用法，实现多Agent协作

Linux每日命令-01-pwd

Linux每日命令-02-cd

OpenClaw保姆级部署教程

评论