OpenClaw命令行速查教程与使用指南

目录 一、OpenClaw核心架构解析 二、核心基础命令：安装与启动 三、模型配置核心命令 四、飞书对接专属命令 五、插件与技能赋能相关命令 （一）插件管理 （二）系统能力启用 （三）Skills技能包管理 六、状态查询常用命令 七、彻底卸载与清理命令 八、常用命令总结

---

一、OpenClaw核心架构解析

说到底，OpenClaw是一个基于Node.js构建的智能体框架。它的核心任务是什么？其实就是扮演好一个“超级通讯员”的角色，打通我们常用的聊天工具（应用层）和背后那些强大的大模型（服务层）。为了高效完成这个任务，它的整体架构设计得非常清晰，分成了五个职责分明的层级，每一层都各司其职：

聊天工具层：这一层负责对接各种前端交互渠道，比如我们熟悉的飞书、WhatsApp、Slack，甚至直接的命令行接口（CLI），确保用户能通过各种方式接入。

网关层：可以把它看作是整个系统的交通枢纽，主要负责消息的路由和转发，承上启下，连接工具层与核心层。

OpenClaw核心层：这是框架的心脏，基于Node.js运行。它内部又细分为工作台层（管理日志、会话、模型调用和上下文）、Skills能力层以及Plugins插件层。插件层尤为关键，它提供了对飞书、文件、数据库、各类API等外部服务的适配能力。

大模型服务商：这一层就是各类大模型的“供应商”，框架支持对接OpenAI、Qwen、GLM等多种主流模型，用户可以根据需求灵活选择。

二、核心基础命令：安装与启动

万事开头难，我们先从最基础的安装和启动开始。这几个命令，是你开启OpenClaw之旅的钥匙：

全局安装：执行 npm i -g openclaw 或者更稳妥点，用 npm install -g openclaw@latest（注意，某些网络环境下可能需要开启TUN模式）。

启动与安装服务：运行 openclaw onboard --install-daemon，这个命令会同时启动Web管理界面并安装后台守护进程，一气呵成。

编辑核心配置：想自定义设置？用 nano ~/.openclaw/openclaw.json 打开核心配置文件进行查看和编辑。

重启网关：修改配置后，记得执行 openclaw gateway restart 让改动生效。贴心的是，重启过程会自动运行诊断修复，重启后需要刷新一下Dashboard页面。

网络优化：如果遇到npm包下载缓慢的问题，可以尝试配置国内镜像源：npm config set registry https://registry.npmmirror.com。

版本查看：想知道自己装的是什么版本？openclaw --version 一目了然。

初始化向导：对于新手，直接运行 openclaw onboard，跟着图形化向导一步步走，是最省心的方式。

三、模型配置核心命令

配置大模型是发挥OpenClaw能力的关键一步。这里以配置智谱GLM模型为例，重点解决一个常见的路径解析问题。操作流程其实很清晰：

注册模型别名：首先，执行 openclaw config set 'agents.defaults.models["zai/glm-4.6v-flash"].alias' GLM46V。这里有个细节，用中括号把完整的模型名括起来，可以避免路径中的斜杠被错误解析。

验证与重启：接着，用 openclaw models status 和 openclaw status 检查状态。确认无误后，执行 openclaw gateway restart 重新加载配置。

设为主模型：最后，通过 openclaw config set 'agents.defaults.model.primary' 'zai/glm-4.6v-flash' 将其设置为主力模型。

四、飞书对接专属命令

将OpenClaw接入飞书，核心在于完成那一次性的配对授权。操作非常简单：

首次对接时，在终端执行 openclaw pairing approve feishu 配对码。而这个“配对码”，需要你在飞书里和OpenClaw的机器人账号私聊获取。飞书开放平台的地址是 open.feishu.cn/app，应用开发和管理都在那里进行。

五、插件与技能赋能相关命令

（一）插件管理

插件是扩展框架能力的核心组件，管理起来非常直观：

安装插件：命令是 openclaw plugins install 插件名。例如，安装适配国内服务的认证插件：openclaw plugins install openclaw-aicodewith-auth。

启用插件：安装后，别忘了用 openclaw plugins enable 插件名 显式启用它。

查看列表：想了解已安装和可用的插件？openclaw plugins list 给你一份清晰的清单。

（二）系统能力启用

OpenClaw提供了一些预设的能力配置文件，可以快速解锁特定场景所需的功能。对于大多数开发场景，推荐启用coding配置，它能自动开放文件系统、运行时环境、会话管理等核心能力。

启用命令很简单：openclaw config set tools.profile coding。配置完成后，同样需要重启网关才能生效。

除了 coding，还有几种配置文件可选：minimal（最精简，仅维持会话状态）、messaging（专注于消息处理）、以及 full（开放全部能力，需谨慎使用）。

（三）Skills技能包管理

Skills可以理解为更细粒度的、即插即用的功能模块。社区积累了超过30个技能包，我们可以按需选择：

必装技能：这三个建议第一时间装上：model-usage（用于监控模型token消耗，做到心中有数）、summarize（文本总结神器）、peekaboo（让你能直接读取和分析本地文件）。

建议安装：nano-pdf（PDF文档解析）、clawhub（技能包管理器本身）等，能大幅提升效率。

安装方式：通过ClawHub安装技能包是最佳实践。命令格式为：npx clawhub@latest install 技能包名。比如，安装一个控制Sonos音箱的技能：npx clawhub@latest install sonoscli。其他常用的还有查询天气的weather、辅助编程的coding-agent等。

六、状态查询常用命令

遇到问题不知从何下手？或者想验证配置是否生效？下面这几个状态查询命令就是你的“诊断工具箱”：

查看整体状态：openclaw status，一图览全局。

检查网关状态：openclaw gateway status，聚焦通信枢纽。

验证模型状态：openclaw models status，确保大模型连接畅通。

七、彻底卸载与清理命令

如果决定卸载OpenClaw，请按照以下步骤操作，确保清理干净，不留残余：

卸载全局包：首先执行 npm uninstall -g openclaw。

验证卸载：运行 which openclaw，如果返回空或者“not found”，说明主程序已移除。

删除配置目录：彻底清理用户配置：rm -rf ~/.openclaw。

清理插件缓存：删除全局安装缓存：rm -rf ~/.npm-global/lib/node_modules/openclaw（路径可能因安装方式而异）。

释放端口：检查并释放OpenClaw默认使用的18789端口：先用 lsof -i :18789 查看占用进程号，再用 kill -9 进程号 结束进程。

针对不同操作系统的补充命令：

MAC用户：

openclaw gateway stop
openclaw gateway uninstall
rm -rf "${OPENCLAW_STATE_DIR:-$HOME/.openclaw}"
npm rm -g openclaw || pnpm remove -g openclaw
rm -rf /Applications/OpenClaw.app

Windows用户：

openclaw gateway stop
openclaw gateway uninstall
schtasks /Delete /F /TN "OpenClaw Gateway"
Remove-Item -Recurse -Force "$env:USERPROFILE\.openclaw"
Remove-Item -Force "$env:USERPROFILE\.openclaw\gateway.cmd" -ErrorAction SilentlyContinue
npm rm -g openclaw
# 如果你是用 pnpm 安装的，改为执行：pnpm remove -g openclaw

八、常用命令总结

为了方便随时查阅，这里将最常用的命令做个汇总：

1. 访问控制界面：
终端环境（服务器或无桌面环境推荐）：openclaw tui
桌面环境：openclaw dashboard
或直接在浏览器访问：http://127.0.0.1:18789/

2. 验证配置是否正确：openclaw config validate

3. 重启网关使配置生效：openclaw gateway restart

4. (图片：命令关系示意图)

5. 查看配置：cat ~/.openclaw/openclaw.json

6. 千问认证命令：openclaw models auth login --provider qwen-portal