OpenClaw 使用命令大全

OpenClaw 是一款强大的本地 AI 助手框架，支持多种模型、丰富的技能扩展和便捷的命令行管理。本文详细介绍常用命令和使用技巧。

一、Gateway 管理命令

Gateway 是 OpenClaw 的核心服务，负责管理 AI 对话和技能调度。

查看状态

openclaw gateway status

这条命令显示 Gateway 的当前运行状态，包括服务是否在线、连接数等信息。

启动服务

openclaw gateway start

启动 OpenClaw Gateway 服务，使其开始监听请求。

停止服务

openclaw gateway stop

优雅地停止 Gateway 服务，确保所有会话数据已保存。

重启服务

openclaw gateway restart

重启 Gateway，适用于配置更新后或服务异常时。

查看帮助

openclaw help

显示所有可用命令和简要说明。

二、配置管理命令

查看配置

openclaw config get

查看当前配置项。

更新配置

openclaw config set <key> <value>

修改指定配置项的值。

验证配置

openclaw config validate

检查配置文件的语法和完整性。

三、技能管理命令

OpenClaw 的技能系统支持功能扩展，通过 skillhub 管理。

安装技能

skillhub install <skill-name>

从技能商店安装指定技能。

查看已安装技能

skillhub list

列出所有已安装的技能及其版本。

更新技能

skillhub upgrade <skill-name>

更新指定技能到最新版本。

卸载技能

skillhub uninstall <skill-name>

移除已安装的技能。

四、日志和调试命令

查看日志

openclaw logs

实时查看 Gateway 日志，便于排查问题。

诊断工具

openclaw doctor

运行系统诊断，检查依赖和配置完整性。

五、会话管理命令

查看会话列表

openclaw sessions list

显示当前所有活动会话。

查看会话历史

openclaw sessions history <session-id>

查看指定会话的消息历史。

终止会话

openclaw sessions kill <session-id>

强制结束指定的会话。

六、实用技巧

1. 快捷命令

使用别名简化常用命令：

alias ocs='openclaw gateway status'alias ocr='openclaw gateway restart'

2. 输出过滤

查看特定日志：

openclaw logs | grep error

3. 配置备份

定期备份配置文件：

cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.bak

七、常见问题解决

服务无法启动

检查端口占用：

lsof -i :18789

技能安装失败

检查网络连接和权限：

openclaw doctor --non-interactive

模型连接异常

验证 Ollama 服务：

curl http://127.0.0.1:11434/api/tags

八、进阶使用

自定义技能开发

OpenClaw 支持编写自定义技能，主要文件结构：

• SKILL.md：技能描述和配置
• scripts/：执行脚本
• references/：参考文档

环境变量配置

export OLLAMA_HOST=http://127.0.0.1:11434export OPENCLAW_PORT=18789

多模型配置

openclaw config set models.ollama qwen3:8b

总结

OpenClaw 提供了完整的命令行工具集，从基础的 Gateway 管理到高级的技能开发，都能通过命令行高效完成。熟练掌握这些命令，可以大幅提升使用效率。

建议收藏本文，随时查阅常用命令。