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         # 开关思考过程
/dreaming          # 触发记忆梦境（2026.4.5+）

六、连接 AI 模型

OpenClaw 支持多种 AI 服务商：

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

七、核心能力与新特性

🎬 视频生成（2026.4.5+）

内置 video_generate 工具，支持 xAI（Grok）、Runway、Alibaba Wan、ComfyUI 本地工作流。配置示例：

video:
  provider: xai
  api_key: your-xai-api-key
  default_duration: 5
  default_resolution: 1080p

🎵 音乐生成（2026.4.5+）

内置 music_generate 工具，支持 Google Lyria、MiniMax。示例：

/tool music_generate prompt="Warm ambient synth loop with soft tape texture"

🌙 Dreaming 记忆系统（2026.4.5+ 实验性）

模仿人类睡眠周期的记忆巩固系统，自动将短期记忆晋升为长期记忆：

  • Light（浅睡） — 扫描近期对话，去重标记候选记忆
  • Deep（深睡） — 对候选记忆打分，筛选高分内容
  • REM — 将优质记忆写入 MEMORY.md，完成晋升

📸 图像生成

内置 image_generate 工具，支持 OpenAI DALL-E、FLUX、ComfyUI 等。

🌐 浏览器与网页操作

通过 browser 工具自动接管浏览器，完成搜索、填表、数据抓取等任务。

💻 代码执行与文件操作

支持读写本地文件、安装依赖、运行脚本、写代码并调试。

🔧 技能系统（Skills）

通过 skills 机制扩展功能，可安装来自 ClawHub 的各种预置技能：

openclaw skill list          # 列出已安装技能
openclaw skill add <name>    # 添加技能
clawhub search <keyword>    # 搜索技能市场

八、相关阅读

本文持续更新中...