乐于分享
好东西不私藏

OpenClaw 安装指南:图文详解 + 常用命令,手把手带你养好这只“龙虾”

OpenClaw 安装指南:图文详解 + 常用命令,手把手带你养好这只“龙虾”
O
01
前言
《论语》:“工欲善其事,必先利其器。”若欲养好OpenClaw这只“龙虾”,首要之务,便是通其性、知其法——如何“生”之,如何“治”之。本文以图文为引,从安装到常用命令一一拆解,助你既装得上,更用得顺,方得入门之径,启“养虾”之途。
02
OpenClaw安装与配置
第一步:环境准备
操作系统:Windows 11
  1. 安装 nvm for Windows
    下载地址:https://github.com/coreybutler/nvm-windows/releases
    按照指引一路Next安装即可
2. 安装Node.js(版本要求22以上)
以管理员身份运行PowerShell:

在PowerShell中输入安装Node.js 24的命令:
nvm install 24nvm use 24

检查OpenClaw的前置条件
node -vnpm -v
3. 安装WSL
什么是WSL:Windows Subsystem for Linux(适用于Windows的Linux子系统),支持在Windows系统上运行原生Linux的功能。
在PowerShell中输入安装WSL的命令:
wsl --install
安装完成以后,设置Linux系统的登录密码:

第二步:安装OpenClaw
  1. 更新依赖
在WSL的linux界面输入命令:
sudo apt update && sudo apt upgrade -y
  1. 安装openclaw:
curl -fsSL https://openclaw.ai/install.sh | bash
注意:确保能访问 https://openclaw.ai

安装成功以后会进入配置向导界面:

  • 选择大模型
申请Kimi大模型的API key:https://platform.moonshot.cn/
将API Key拷贝保存下来。

其他配置暂时跳过,只配置模型,检查openclaw是否可以正常使用。
  • 选择Moonshot AI(Kimi K2.5)

  • 选择第二个 Kimi API Key(.cn)

  • 输入Kimi API Key:

选择模型:kimi-k2.5

配置完成

  • 启动OpenClaw用户web交互界面:
openclaw dashboard
将Dashboard URL拷贝到浏览器中:
如果openclaw能正常回复,恭喜正式开启养虾之旅啦。

03
OpenClaw命令大全
一、 终端 CLI 命令:系统总控制台
终端 CLI 命令是 OpenClaw 的运维核心,所有操作均以  openclaw  开头,用于系统级配置和管理。
启动、入口与诊断
这组命令是安装后首次使用或系统出现异常时的首选。
  • openclaw onboard :
    启动交互式配置向导,是首次安装后必须运行的命令,用于引导设置模型、API密钥、消息渠道等。
  • openclaw dashboard
    打开本地的 Web 控制台(默认地址  http://localhost:18789 ),提供可视化的管理界面,是部署后最快的聊天入口。
  • openclaw status
    查看系统整体运行状态,包括Gateway是否在线、端口等。使用 --deep  参数可进行带实时探测的深度诊断。
  • openclaw doctor
    全面的健康检查命令,可自动诊断常见配置、端口和依赖问题。强烈建议在系统行为异常时首先运行此命令,配合  `--fix`  参数可尝试自动修复。
  • openclaw logs
     查看 Gateway 服务的最近日志,是排查错误信息的关键命令。
总而言之
部署完运行 openclaw dashboard 
出问题运行 openclaw doctor 
模型管理
OpenClaw 支持接入和管理多种AI模型。
  • openclaw models list
    列出所有已配置的可用模型,查看其ID。
  • openclaw models status
    显示当前默认模型和详细的认证状态。
  • openclaw models set <模型ID>
    设置全局默认模型。例如: openclaw models set moonshot/kimi-k2.5 。
  • openclaw models auth
    用于模型认证的子命令集,例如通过  paste-token  粘贴API Token,或通过  login 进行OAuth登录。
渠道与消息管理
渠道(Channels)是连接飞书、Telegram、Discord等外部聊天平台的关键。
  • openclaw channels list
    列出所有已配置的渠道。
  • openclaw channels status
    检查渠道的健康状态,通常会给出修复建议。使用  --probe --json  参数可以快速诊断哪个渠道出现问题。
  • openclaw channels add
    添加新渠道。可以交互式运行,也可直接指定参数。
  • openclaw message send --target  --message
    主动向指定渠道发送消息,无需等待用户发起对话。目标ID可通过  openclaw directory命令查找。
技能与插件管理
技能(Skills)和插件(Plugins)用于扩展OpenClaw的能力。
  • openclaw skills list
    查看已安装的技能列表。
  • openclaw skills install <技能名>
    从技能市场安装新技能。也可以通过专用命令clawhub install <技能名>安装。
  • openclaw plugins list/enable/disable
    分别用于列出、启用和禁用插件。例如,启用飞书插件: openclaw plugins enable feishu 。
网关管理
网关(Gateway)是OpenClaw的核心进程,负责所有通信,必须保持运行才能通过聊天软件交互。
  • openclaw gateway start/stop/restart
    分别用于后台启动、停止和重启Gateway服务。修改配置后通常需要重启生效。
  • openclaw gateway status
    查看Gateway服务的运行状态。
  • openclaw gateway install
     将Gateway安装为系统服务,实现开机自启,适合需要长期运行的服务器环境。
配置管理
  • openclaw config get <路径>
    查看特定配置项的值,例如
    openclaw config get providers.siliconflow.apiKey。
  • openclaw config set <路径> <值>
    非交互式设置配置项,例如设置默认模型: 
    openclaw config set models.default moonshot/kimi-k2.5  。
二、聊天斜杠命令:会话临时控制器
聊斜杠命令在飞书、Telegram等聊天窗口中使用,以 / 开头,主要用于控制当前会话的临时行为。
会话控制与查询
  • /reset 或  /new 
    重置当前会话,清空对话上下文,开始一个全新的话题。 /new <模型名>可以在开新会话的同时切换模型。
  • /status
    查询当前会话的技术状态,包括使用的模型、上下文长度等。这与终端命令  openclaw status不同,后者查看的是系统整体状态。
  • /model <模型ID>
    临时切换当前会话使用的模型,例如  /model moonshot/kimi-k2.5 ,此切换仅影响当前对话。使用 /model reset  可清除覆盖,回归默认模型。
  • /context detail
    查看当前上下文的详细信息,包括文件、工具、技能等,是调试时必用的命令。
运行时参数调整
这组命令可以动态调整AI的思考和行为模式,非常实用。
  • /think
    调整AI的思考深度,可选 off 、minimal 、low 、medium 、high、 xhigh 等级别。
  • /verbose 
     控制调试详细日志的输出,平时建议关闭,在群聊中开启可能有信息泄露风险。
  • /reasoning
    控制是否输出AI的推理过程。
  • /usage cost
    显示本次会话的成本汇总,有助于控制使用开销。
高级控制与执行
  • /subagents
    用于管理当前对话中派生的子龙虾,可以查看列表、生成新的子龙虾、发送指令或终止任务,适合处理多任务并行场景。
  • 或  /bash 
    在聊天中直接执行宿主机命令。此功能需谨慎使用,必须先在配置中开启 ( commands.bash: true ) 并配合安全白名单,它受到严格的安全控制。
三、 核心区别与使用场景速查
理解CLI命令与聊天命令的核心区别是高效使用OpenClaw的关键:
 终端 CLI 命令:修改的是系统规则,影响是全局的、持久生效的。例如配置模型、管理渠道、安装技能。
 聊天斜杠命令:控制的是本次运行,默认只影响当前会话。例如切换临时模型、调整思考深度、清空当前聊天记录。
以下是对照表,帮助你快速根据场景选择命令入口:

你想做什么

应使用的命令类型

示例命令

查看系统是否正常运行

终端CLI

openclaw status

系统排障与自动修复

终端CLI

openclaw doctor 

openclaw doctor --fix

让AI在回答前多思考一会儿

聊天命令

/think high

临时用另一个模型

聊天命令

/model <新模型 ID>

管理技能

终端CLI

openclaw skills list

04
总结
OpenClaw 的安装过程其实并不复杂,按着步骤一步步来,就能顺利跑通。命令虽然看起来不少,但日常用得上的就那么几条,多上手用几次就熟练了。希望读完这篇文章,你也能当个“龙虾养殖户”,省下请人安装修理的钱,自己动手,丰衣足食。后续我们将开启养虾之旅。