openclaw常用命令
OpenClaw 常用命令整理
搞定一个工具,核心往往不在于理解所有复杂原理,而在于掌握几个关键路径和核心命令。OpenClaw 也不例外。今天,咱们就来把那些最常用、最能帮你解决问题的命令梳理清楚,让配置和运维变得顺手。
先说几个核心配置的路径,这几个文件位置记牢了,修改配置或排查问题时能少走不少弯路。
重要配置路径:
cd ~/.openclaw/home/wo/.openclawnano ~/.openclaw/openclaw.json
cd ~/.openclaw/agents/main/agent//home/wo/.openclaw/agents/main/agent~/.openclaw/agents/main/agent/auth-profiles.json
诊断与修复
系统出了问题,第一步不是自己瞎捣鼓,而是让工具自己诊断一遍。
openclaw doctor --fix # 运行系统诊断并自动修复发现的问题
配置管理
玩转配置是进阶的第一步。查看、编辑、设定,这几个命令够你应对大多数场景了。
openclaw config --section models # 查看或编辑配置文件中名为 “models” 的配置段
openclaw config --list # 列出所有配置项
openclaw config --set key=value # 设置指定配置项的值
网关控制
网关是服务的核心枢纽,启动、停止、状态检查,这几个命令得备着。
openclaw gateway start # 启动 OpenClaw 网关服务
openclaw gateway stop # 停止网关服务
openclaw gateway restart # 重启网关服务
openclaw gateway status # 查看网关运行状态
服务管理(systemd)
对于长期稳定运行的服务,交给 systemd 来管理是更专业的选择。这里分系统级和用户级两种情况。
系统级服务(需 root 或 sudo)
如果你的 OpenClaw 是作为全局服务安装的,就用这一套命令。
systemctl restart openclaw-gateway # 重启系统级 openclaw-gateway 服务
systemctl status openclaw-gateway # 查看系统级服务状态
systemctl start openclaw-gateway # 启动系统级服务
systemctl stop openclaw-gateway # 停止系统级服务
systemctl enable openclaw-gateway # 设置开机自启
systemctl disable openclaw-gateway # 禁用开机自启
用户级服务(无需 root,仅当前用户)
只想在当前用户下运行?用户级服务更安全、更灵活。
systemctl --user restart openclaw-gateway # 重启用户级 openclaw-gateway 服务
systemctl --user status openclaw-gateway # 查看用户级服务状态
systemctl --user start openclaw-gateway # 启动用户级服务
systemctl --user stop openclaw-gateway # 停止用户级服务
systemctl --user enable openclaw-gateway # 设置用户级服务开机自启(需启用 linger)
仪表板与 Web UI
有没有可视化界面?当然有。
openclaw dashboard # 打开 OpenClaw 的 Web 管理界面(或输出访问地址)
日志查看
出问题看日志,这是铁律。实时追踪、历史回看,都得会。
openclaw logs --follow # 实时跟踪(tail -f)OpenClaw 的日志输出
openclaw logs --tail=100 # 查看最近 100 行日志
openclaw logs --since “2023-01-01” # 查看指定时间之后的日志
版本与帮助
任何时候,别忘了最基础的帮助命令。
openclaw --version # 显示 OpenClaw 版本信息
openclaw --help # 显示全局帮助信息
openclaw
添加机器人
让 OpenClaw 真正“动”起来的,是各种功能各异的智能体。添加一个试试?
openclaw agents add mybrowser \--model edgefn/Kimi-K2-Instruct \--workspace ~/.openclaw/workspace
这个命令的作用是向 OpenClaw 中添加一个新的智能体配置。mybrowser 是你为这个智能体指定的名称,后续通过这个名称就可以引用它。--model 参数指定了该智能体使用的模型,比如这里的 edgefn/Kimi-K2-Instruct。--workspace 则设置了它的工作目录。
测试机器人
配置好了,总得跑起来看看效果吧。
openclaw agent \--agent mybrowser \--message “打开爱奇艺官网 https://www.iqiyi.com” \--verbose on
这条命令就是启动刚刚添加的 mybrowser 智能体,并给它下达一条指令:“打开爱奇艺官网”。--verbose on 会开启详细输出模式,方便你观察执行过程中的每一步,对调试来说尤其有用。
本地部署大模型,OpenClaw 接入
最后,也是当下越来越热门的需求:如何让 OpenClaw 使用你自己在本地部署的大语言模型?这才是摆脱依赖、实现完全自主可控的关键一步。