前言

OpenClaw 是一个强大的 AI Agent 框架，通过命令行工具可以完成所有操作。本文档整理了所有常用命令及其详细说明，帮助你快速掌握 OpenClaw 的使用方法。

基础命令

openclaw --help

显示帮助信息，列出所有可用命令和选项。

openclaw --help
openclaw -h

openclaw --version

显示当前安装的 OpenClaw 版本号。

openclaw --version
openclaw -v

openclaw status

查看 OpenClaw 的运行状态，包括网关服务状态、配置信息等。

openclaw status

网关服务命令

openclaw gateway start

启动 OpenClaw 网关服务。网关是核心组件，负责处理 AI 模型调用、工具执行、消息路由等功能。

# 启动网关（默认端口）
openclaw gateway start

# 指定端口启动
openclaw gateway start --port 8080

参数说明：

• --port 或 -p：指定网关监听端口，默认 3000
• --daemon 或 -d：以守护进程方式运行

openclaw gateway stop

停止正在运行的网关服务。

openclaw gateway stop

openclaw gateway restart

重启网关服务，通常用于应用配置更改后生效。

openclaw gateway restart

openclaw gateway status

查看网关服务的详细状态信息。

openclaw gateway status

聊天会话命令

openclaw chat

启动交互式聊天会话，与 AI 助手进行对话。

# 启动聊天
openclaw chat

# 指定模型
openclaw chat --model gpt-4

# 指定会话 ID
openclaw chat --session my-session

参数说明：

• --model 或 -m：指定使用的 AI 模型
• --session 或 -s：指定会话 ID，用于恢复历史对话
• --reasoning：启用推理模式

会话管理命令

openclaw session list

列出所有聊天会话记录。

openclaw session list

openclaw session show [session-id]

查看指定会话的详细信息。

openclaw session show my-session

openclaw session delete [session-id]

删除指定的会话记录。

openclaw session delete my-session

技能管理命令

openclaw skill list

列出已安装的所有技能。

openclaw skill list

openclaw skill install [skill-name]

从 ClawHub 安装新技能。

# 安装技能
openclaw skill install github

# 安装指定版本
openclaw skill install github@1.0.0

openclaw skill uninstall [skill-name]

卸载已安装的技能。

openclaw skill uninstall github

openclaw skill update [skill-name]

更新技能到最新版本。

# 更新指定技能
openclaw skill update github

# 更新所有技能
openclaw skill update --all

openclaw skill search [keyword]

在 ClawHub 上搜索技能。

openclaw skill search weather

配置管理命令

openclaw config show

显示当前配置信息。

openclaw config show

openclaw config set [key] [value]

设置配置项的值。

# 设置默认模型
openclaw config set model gpt-4

# 设置时区
openclaw config set timezone Asia/Shanghai

openclaw config get [key]

获取指定配置项的值。

openclaw config get model

openclaw config edit

打开配置文件进行编辑。

openclaw config edit

代理（Agent）命令

openclaw agent list

列出所有可用的 AI 代理。

openclaw agent list

openclaw agent run [agent-name]

运行指定的 AI 代理。

openclaw agent run coder

工具命令

openclaw tools

列出所有可用的工具。

openclaw tools

openclaw mcp

MCP（Model Context Protocol）相关命令。

# 列出 MCP 服务器
openclaw mcp list

# 添加 MCP 服务器
openclaw mcp add server-name --command "npx -y @modelcontextprotocol/server-filesystem"

# 移除 MCP 服务器
openclaw mcp remove server-name

调试与诊断命令

openclaw doctor

运行诊断检查，检测常见问题和配置错误。

openclaw doctor

openclaw logs

查看 OpenClaw 的运行日志。

# 查看最新日志
openclaw logs

# 实时跟踪日志
openclaw logs --follow

# 查看最近 N 行日志
openclaw logs --lines 100

openclaw debug

启用调试模式运行。

openclaw debug

更新与维护命令

openclaw update

更新 OpenClaw 到最新版本。

openclaw update

openclaw uninstall

卸载 OpenClaw。

openclaw uninstall

命令速查表

常用快捷方式

OpenClaw 支持命令别名，简化输入：

总结

本文档涵盖了 OpenClaw 的所有主要命令。熟练掌握这些命令，可以让你更高效地使用 OpenClaw 构建 AI 应用。

如需更多帮助，可以随时使用 openclaw --help 或访问 官方文档。