OpenClaw 实用命令指南：从安装到优化的完整手册

前言

OpenClaw 是一款强大的 AI 代理工具，但在实际使用过程中，我们需要掌握一些关键命令来保证其正常运行和高效使用。本文将详细介绍 OpenClaw 的安装、升级、启动、配置优化等常用命令，帮助您更好地使用这款工具。

一、版本管理与升级

查看当前版本

openclaw -v

升级到最新版本

npm i -g openclaw@latest

二、环境检测与修复

自动修复环境问题

当 OpenClaw 启动不正常时，可以使用以下命令检测并修复环境：

openclaw doctor --fix

三、安全配置优化

禁用交互式确认

在执行命令时，如果您希望跳过每次的安全询问，可以使用以下配置：

/exec security=full ask=off

四、服务管理

停止网关服务

openclaw gateway stop

启动网关服务

openclaw gateway

一键停止再启动

openclaw gateway stop && openclaw gateway

五、访问与界面

Web 界面访问地址

启动服务后，可通过以下地址访问主会话：

http://127.0.0.1:18789/chat?session=main

终端用户界面

openclaw tui

六、配置调整

设置会话超时时间

将默认超时时间设置为 30 分钟（1800 秒）：

openclaw config set agents.defaults.timeoutSeconds 1800

重新配置启动设置

openclaw onboard --mode local

七、后台运行方案

PowerShell 后台启动（隐藏窗口）

Start-Process node -ArgumentList "`"$env:USERPROFILE\node_global\node_modules\openclaw\dist\index.js`" gateway --port 18789" -WindowStyle Hidden

启动后自动打开浏览器

start http://127.0.0.1:18789/

八、性能优化：解决 Bonjour 卡顿问题

临时禁用 Bonjour（Windows）

在 Windows 系统中，Bonjour 服务发现可能会导致启动延迟，可以使用环境变量禁用：

$env:OPENCLAW_DISABLE_BONJOUR=1; openclaw gateway

永久设置环境变量（Windows）

为了让设置永久生效，可以将环境变量写入系统：

[Environment]::SetEnvironmentVariable("OPENCLAW_DISABLE_BONJOUR", "1", "User")

设置完成后需要重启终端或重新登录，之后启动 OpenClaw 时会自动应用此设置。

九、技能扩展

Superpowers 技能框架

Superpowers 是一个强大的 agentic 技能框架，可极大提升编码效率：

https://github.com/obra/superpowers

oh-my-opencode 技能包

另一个优秀的技能集合：

https://github.com/opensoft/oh-my-opencode

十、总结

OpenClaw + Superpowers + oh-my-opencode 的组合堪称王炸级别的 AI 代理开发套件。通过合理的配置和优化，我们可以获得极佳的使用体验。

关键优化要点：

1. 使用环境变量禁用 Bonjour 解决启动延迟
2. 合理设置超时时间避免长时间挂起
3. 利用技能框架扩展功能
4. 定期使用 doctor 命令维护环境

希望这份指南能帮助您更好地使用 OpenClaw，提升开发效率！

---

作者注：本文基于 OpenClaw 2026.4.9 版本编写，部分命令可能随版本更新有所变化，请以官方文档为准。