OpenClaw (Clawdbot) 教程

OpenClaw（原名 Clawdbot，过渡名 Moltbot）是 2026 年 1 月突然爆火的开源个人 AI 助手项目，由 Peter Steinberger（PSPDFKit 创始人）开发。

OpenClaw 是一个可执行任务的智能体，我们给指令，它不仅回答，还能主动操作系统、访问网页、处理邮件、整理文件、发起提醒甚至自动编写代码。

OpenClaw 是一个把 本地算力 + 大模型 Agent 自动化 玩到极致的开发者效率工具。

OpenClaw 目标是让 AI 不只是给建议，而是直接完成完整工程任务。

因为 Anthropic 在 1 月 27 日发律师函称 Clawd / Clawdbot与 Claude 太像，项目在当天紧急更名为 Moltbot（脱皮龙虾之意，吉祥物是小龙虾 Molty 🦞），但功能完全一致，旧命令 clawdbot 仍然兼容。

Moltbot 是项目组为了应对侵权风险想出的过渡名字，OpenClaw 这是目前的最终官方名称。

Clawbot、Moltbot 和 OpenClaw 其实是同一个开源项目，名字演进顺序为：

Clawdbot → Moltbot → OpenClaw
名称 时间线 背景/原因 本质关系
Clawdbot / Clawbot 2025 年末至 2026 年 1 月初 最初项目名；灵感来自 Claude 和 claw（龙虾爪）梗 原始名称，是最早出现在 GitHub 的身份
Moltbot 2026 年 1 月 27 日 因 Anthropic 商标顾虑被要求更名 中间过渡名字；功能、代码与 Clawdbot 一致
OpenClaw 2026 年 1 月 30 日之后 抛弃版权冲突、强调开源性/长线品牌 当前官方名称，也是今后文档、仓库等统一标识

安装方法

OpenClaw 的安装被设计得极为友好，即使是非开发者也能快速上手。

系统要求（不一定 Mac mini）：

  • 硬件：极低，2GB RAM 即可运行。
  • 环境：支持 Mac, Windows, Linux，需要安装 Node.js (pnpm) 或使用 Docker。

1、推荐安装方式（一键脚本）：

直接通过终端，执行以下命令。

macOS/Linux 系统:

curl -fsSL https://openclaw.ai/install.sh | bash

Windows 系统：

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

#CMD
curl -fsSL https://openclaw.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

这会自动安装 Node.js（≥22）并完成基本配置。

2、手动安装

需要 Node.js ≥22并完成基本配置。

使用 npm：

npm i -g openclaw

或使用 pnpm：

pnpm add -g openclaw

安装完成后，初始化并安装后台服务（launchd / systemd 用户服务）：

openclaw onboard

3、从源码安装（开发模式）

git clone https://github.com/openclaw/openclaw.git
cd openclaw

pnpm install

pnpm ui:build   # 首次运行会自动安装 UI 相关依赖并构建前端界面
pnpm build      # 构建整个项目（包含后端与相关模块）

# 初始化 OpenClaw 并安装为系统后台服务（开机自动运行）
pnpm openclaw onboard --install-daemon

# 开发模式：监听 TypeScript 代码变更并自动重载网关服务
pnpm gateway:watch

配置说明

我们推荐使用一键脚本安装。

macOS/Linux 系统:

curl -fsSL https://openclaw.ai/install.sh | bash

Windows 系统：

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

#CMD
curl -fsSL https://openclaw.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

它会完成环境检测，并且安装必要的依赖，还会启动 onboarding 流程。

然后，会提醒你这个龙虾能力很强，当然风险也很大，我们选 yes（no 就不安装了） 就好了：

接下来我们就选快速启动 QuickStart 选项：

接下来我们需要配置一个大模型，Model/Auth Provider 选择 AI 供应商，国内外的供应商基本都支持。

如果没有海外的账号，配置咱们国内的 Qwen、MiniMax、智谱的 API key 也是可以的。

然后会出现选择聊天工具的选项，海外的一般都没有可以选最后一个：

其他配置，比如端口的设置 Gateway Port，按默认的 18789 即可，比如 Skills、包的安装管理器选 npm 或其他，可以一路 Yes 下去。

选一些自己喜欢的 skills，也可以直接跳过，使用空格按键选择：

这些 API key，没有的直接选 no：

最后这三个钩子可以开启，主要做内容引导日志和会话记录：

安装完后，就会自动访问 http://127.0.0.1:18789/chat，就可以打开聊天界面让它开始工作。

比如搜索最新的科技新闻：

启动后，我们可以使用 openclaw status 命令查看状态：

openclaw status

其他命令：

openclaw gateway start     # 启动
openclaw gateway stop      # 停车
openclaw gateway restart   # 重启

通过第三方云直接安装配置

现在各大平台都已经支持这个智能体，如果不想安装在本机，可以一键部署云上OpenClaw：

使用阿里云的轻量级服务器安装：https://www.aliyun.com/activity/ecs/clawdbot。

可以使用它们的镜像，一键安装：

使用腾讯云的轻量级服务器安装： https://cloud.tencent.com/developer/article/2624973

常用命令

OpenClaw 常用命令如下：

命令 作用 备注 / 参数
openclaw status 查看 Gateway 状态 检查网关是否可达及运行状况
openclaw health 健康检查 主要检测 core 运行和依赖情况
openclaw doctor 综合诊断与修复建议 可配合 --yes / --non-interactive 自动执行
openclaw configure 交互式配置向导 用于设置模型、通道、凭据等
openclaw config get <path> 获取配置值 指定路径提取配置
openclaw config set <path> <value> 设置配置项 支持 JSON5/raw 文本
openclaw config unset <path> 清除配置项 移除单个键值
openclaw channels list 列出已登录通道 可观察 WhatsApp/Telegram 等登录状态
openclaw channels login 登录新的通道账号 用于扫描/授权链接
openclaw skills list 列出技能 查看可用/已安装的技能
openclaw skills info <skill> 技能详情 观察某项技能参数或版本
openclaw plugins list 列出插件 查看已安装插件
openclaw plugins install <id> 安装插件 例如 @openclaw/voice-call
openclaw plugins enable <id> 启用插件 之后通常需要重启网关
openclaw logs --follow 显示日志 --json / --plain / --limit 等组合使用
openclaw gateway install 安装系统服务 根据平台注册 Gateway 守护进程
openclaw gateway start 启动 Gateway 服务 系统服务模式下启动
openclaw gateway stop 停止 Gateway 服务 同上
openclaw gateway restart 重启 Gateway 服务 适合配置变更后应用
openclaw gateway status 网关系统服务状态 不同于 openclaw status，会探测服务单元
openclaw uninstall 卸载 Gateway 服务及数据 官方推荐使用
openclaw uninstall --all --yes --non-interactive 全自动卸载 包含状态、workspace、插件等
openclaw uninstall --state 删除状态文件 不删除 workspace/CLI
openclaw uninstall --workspace 删除工作区 移除 agent/workspace 文件
openclaw uninstall --service 仅卸载服务 不删除数据
openclaw uninstall --dry-run 模拟卸载 显示结果但不实际执行

为什么最近这么火？

  • 真正做到了"像JARVIS一样"：能读写文件、跑终端命令、操作浏览器、收发邮件、日历、写代码、订机票、清空收件箱……
  • 本地优先 + 长期记忆：所有对话跨平台共享上下文，USER.md 和 memory/ 目录会越用越聪明
  • 支持几乎所有大模型：Claude、Gemini、OpenAI、Ollama 本地模型、Pi 等
  • 社区技能生态爆炸：ClawdHub 上已有 500+ 社区技能（Slack、Discord、GitHub、浏览器控制、macOS UI 自动化……）
  • 安装简单像 npm install，实际能力却很 spicy （开发者原话）

其核心能力包括：

  • 将自然语言目标拆解为可执行步骤
  • 自动调用终端命令
  • 创建与修改项目文件
  • 运行代码并检测结果
  • 根据报错自动修复

相比 Claude Code/OpenCode 这种代码补全工具，OpenClaw 更接近一个具备执行权限的工程型智能体。

  • Claude Code 与 OpenCode等 强在代码质量与理解
  • OpenClaw 强在自动完成整个工程流程
能力维度 OpenClaw Claude Code OpenCode
任务规划 强 中 中
自动执行 完整 部分 部分
自我修复 有 无 无
工程级操作 强 强 中
本地自动化 原生支持 较弱 较弱