OpenClaw命令大全,从入门到精通,0基础小白也会安装

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

一、 安装与初始化 (首次部署)

如果是全新安装，请按顺序执行以下步骤：

1. 1‌.一键安装 (推荐)‌自动检测环境、安装 Node.js 及 OpenClaw 核心。

iwr -useb https://openclaw.ai/install.ps1 | iex# 国内镜像加速版:# iwr -useb https://clawd.org.cn/install.ps1 | iex

确认版本信息，确保环境变量生效。

openclaw --version

初始化配置向导‌

配置模型 API Key、选择默认模型、设置开机自启等。、

openclaw onboard --install-daemon

注：–install-daemon 参数会将网关注册为系统服务，实现开机自启。

注：--install-daemon 参数会将网关注册为系统服务，实现开机自启。

环境健康检查‌

自动诊断网络、模型连接及依赖项状态。

openclaw doctor

二、 网关服务管理 (日常核心)

OpenClaw 的核心是 Gateway 服务，以下命令用于控制其运行状态：

停止网关服务 ，修改配置前或关闭服务时

openclaw gateway stop 

 重启网关服务‌ ，修改配置文件或更换模型后必须执行‌ 

openclaw gateway restart

查看服务状态， 检查服务是否正在运行

openclaw gateway status 

安装开机自启服务，希望电脑重启后自动运行 

openclaw gateway install 

移除开机自启服务 取消自动启

openclaw gateway uninstall 

三、 可视化与交互界面

打开 Web 管理控制台 (最常用)‌

自动生成访问链接并打开浏览器，用于聊天、插件管理和日志查看。

openclaw dashboard

默认地址：http://127.0.0.1:18789

终端交互模式 (TUI)‌

直接在 PowerShell 窗口中与 AI 对话测试。

openclaw tui

编辑配置文件‌

调用默认编辑器打开 `openclaw.json。

openclaw config show

编辑配置文件‌

调用默认编辑器打开 `openclaw.json。

openclaw config edit

命令行修改特定配置‌

例如修改默认模型：

openclaw config set agents.defaults.model qwen/qwen-max

修改后记得执行 openclaw gateway restart 生效。

重新运行配置向导‌

如果想重新选择模型或通道：

openclaw onboard

五、 插件与模型管理

模型认证登录‌

针对需要 OAuth 授权的模型提供商（如通义千问门户版）：

openclaw models auth login --provider qwen-portal

‌插件管理

# 启用插件openclaw plugins enable <插件名称># 禁用插件openclaw plugins disable <插件名称># 列出所有插件openclaw plugins list

六、 日志与故障排查

当服务异常时，使用以下命令排查：

查看实时日志

openclaw logs --follow

‌深度诊断

openclaw doctor --deep

重置所有配置 (慎用)‌

清除所有数据、凭据和配置，恢复初始状态：

openclaw reset

七、 卸载与清理

如果需要彻底移除 OpenClaw：

1. ‌停止服务

openclaw gateway stopopenclaw daemon stop

卸载程序

npm uninstall -g openclaw

清理残留文件 (PowerShell)

# 删除配置目录Remove-Item -Recurse -Force "$env:USERPROFILE\.openclaw"# 删除可能的源码目录Remove-Item -Recurse -Force "$env:USERPROFILE\openclaw"# 删除残留脚本Remove-Item -Force "$env:USERPROFILE\.local\bin\openclaw.cmd" -ErrorAction SilentlyContinue

 常用工作流示例

‌场景：修改了模型配置，如何生效？‌

1. 编辑配置：openclaw config edit (或 openclaw config set ...)
3. 重启服务：openclaw gateway restart
5. 检查状态：openclaw gateway status
7. 打开界面：openclaw dashboard

‌场景：服务启动失败怎么办？‌

1. 运行诊断：openclaw doctor --fix
3. 查看日志：openclaw logs --follow
5. 尝试前台运行以查看详细报错：openclaw gateway run

6. 通过以上命令的熟练运用，你可以轻松实现OpenClaw的全生命期

7. 管理。无论是日常使用还是故障排查，这份指南都能成为你的得力助

8. 手。赶紧收藏起来，让OpenClaw为你的工作效率赋能！