OpenClaw 完全指南:安装教程、常用命令与国内镜像

OpenClaw 完全指南

OpenClaw 是一款热门的开源个人 AI 数字员工工具,它允许用户在本地或云端部署一个 AI 助手,实现自动化操作电脑、读写文件、执行任务、以及通过各类聊天应用进行沟通。因其醒目的红色龙虾图标,用户亲切地称其为「龙虾」。

一、什么是 OpenClaw?

OpenClaw 是一个开源的 AI 智能体框架,它能够:

  • 通过自然语言指令自动执行电脑操作
  • 读写文件、收发邮件、管理日历
  • 接管浏览器进行网页操作
  • 通过微信、QQ、Telegram、Discord 等聊天工具远程控制
  • 支持自定义技能和工作流

2026 年,OpenClaw 获得了英伟达 CEO 黄仁勋的高度评价,被称为「迄今最重要的软件」。腾讯也基于 OpenClaw 推出了 QClaw 产品。

二、安装前准备

  • 操作系统: Windows 10/11、macOS、Linux
  • Node.js: 推荐 Node.js 22+ (LTS 24.x)
  • Git: 必须安装
  • 内存: 推荐 8-16GB
  • API Key: 需提前准备 AI 服务商(如 OpenAI、Google Gemini、DeepSeek、Kimi 等)的 API Key

三、配置国内镜像(关键步骤)

由于网络环境原因,建议配置 npm 国内镜像以加速下载:

npm config set registry https://registry.npmmirror.com

方式一:一键安装脚本(推荐)

Windows 用户在 PowerShell(管理员)中运行:

iwr -useb https://openclaw.ai/install.ps1 | iex

按照向导选择 AI 模型、聊天渠道等即可完成安装。

方式二:npm 全局安装

npm install -g openclaw@latest
openclaw onboard --install-daemon

方式三:国内特供版

国内社区提供了优化版本:

npm install -g openclaw-cn@latest
openclaw-cn onboard --install-daemon

方式四:云端部署

阿里云、腾讯云等支持一键部署,适合 24/7 运行需求。

四、常用终端命令

服务管理

openclaw launch          # 当前终端启动
openclaw gateway start   # 启动守护进程
openclaw gateway stop    # 停止守护进程
openclaw gateway restart # 重启
openclaw status          # 查看状态
openclaw restart         # 重启服务
openclaw update          # 更新版本

配置管理

openclaw setup           # 初始化配置
openclaw onboard         # 配置向导
openclaw configure      # 重新配置
openclaw config get <key>  # 获取配置
openclaw config set <key> <value> # 设置配置

诊断与排障

openclaw doctor              # 健康检查
openclaw doctor --fix        # 自动修复
openclaw logs --follow       # 实时日志
openclaw security audit      # 安全审计

技能与模型

openclaw models status      # 模型状态
openclaw models set <model> # 切换模型
openclaw skill list         # 列出技能
openclaw skill add <name>  # 添加技能

五、常用对话框命令

在聊天窗口中使用(以 / 开头):

/help              # 查看所有命令
/new               # 开始新对话
/status            # 查看会话状态
/model             # 查看/切换模型
/compact           # 压缩上下文
/reset             # 重置上下文
/skill <name>     # 运行技能
/whoami            # 显示用户ID
/stop              # 停止输出
/usage             # 查看 Token 消耗
/reasoning         # 开关思考过程

六、连接 AI 模型

OpenClaw 支持多种 AI 服务商:

  • 国际: OpenAI GPT、Google Gemini、Anthropic Claude
  • 国内: DeepSeek、Kimi(月之暗面)、阿里通义千问、智谱 GLM

七、相关阅读

本文持续更新中...