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 这是目前的最终官方名称。

• OpenClaw 官网: https://openclaw.ai/
• 中文文档： https://docs.openclaw.ai/zh-CN
• Github openclaw 教程 地址：https://github.com/openclaw/openclaw
• OpenClaw 技能合集: https://github.com/VoltAgent/awesome-openclaw-skills

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

Clawdbot → Moltbot → OpenClaw

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

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

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

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

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）并完成基本配置。

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

使用 npm：

 npm i -g openclaw # 如果速度慢可以指定国内镜像 npm i -g openclaw --registry=https://registry.npmmirror.com 

或使用 pnpm：

 pnpm add -g openclaw

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

openclaw onboard

 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(设置向导) 流程。

后期要重新进入设置向导，可以执行以下命令：

openclaw onboard --install-daemon

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

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

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

如果没有海外的账号，配置咱们国内的 Qwen、MiniMax、智谱的 API key 也是可以的，认证配置文件（OAuth + API 密钥）在，后期也可以在这个文件上修改。

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

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

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

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

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

选择Open the Web UI，使用浏览器打开：

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

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

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

openclaw status

如果你在新手引导期间安装了服务，Gateway 网关应该已经在运行：

openclaw gateway status

手动运行（前台）：

 openclaw gateway --port 18789 --verbose

安装后可以执行的命令：

• 运行新手引导：
• 快速检查：
• 检查 Gateway 网关健康状态： +
• 打开仪表板：

使用内置卸载程序：

 openclaw uninstall

非交互式（自动化 / npx）：

 openclaw uninstall --all --yes --non-interactive npx -y openclaw uninstall --all --yes --non-interactive

技能是包含 SKILL.md 文件的独立文件夹，想要为 OpenClaw 代理拓展新功能，ClawHub 是查找、安装技能的最优选择。

ClawHub 技能仓库地址：https://clawhub.ai/

安装 ClawHub 工具：

 # 推荐方式（npx 无需全局安装） npx clawhub@latest --version # 或全局安装（方便以后直接用 clawhub 命令） npm install -g clawhub # 或者用 pnpm pnpm add -g clawhub

登录：

clawhub login

搜索技能：

 clawhub search "postgres backups"

下载安装新技能：

 clawhub install my-skill-pack

批量更新已安装技能：

 clawhub update --all

插件是轻量代码模块，可通过新增命令、工具及 Gateway RPC 能力，为 OpenClaw 拓展额外功能。

查看已加载插件：

 openclaw plugins list

安装官方插件（示例：语音通话插件）：

 openclaw plugins install @openclaw/voice-call

插件安装后重启网关生效：

 openclaw gateway restart

OpenClaw 常用命令一览表：

改完配置后记得运行 让改动生效～ 🦞

• WhatsApp：（或扫描 QR）
• Telegram：（需 Bot Token）
• Discord：（需 Bot Token）
• iMessage：macOS 原生桥接
• Slack：（需 Bot Token）

• ：指令说明
• ：偏好设置
• ：长期记忆
• ：检查清单
• ：人格/语气
• ：名称/主题
• ：启动配置
• 根目录：

• ：健康 + 上下文
• ：上下文贡献者
• ：切换模型
• ：释放窗口空间
• ：全新会话
• ：中止当前运行
• ：切换语音
• ：切换推理模式

• 主配置：
• 默认工作区：
• 智能体状态目录：
• OAuth & API 密钥：，如果是旧版本的在
• 向量索引存储：
• 全局共享技能：
• 网关文件日志：

• 付费：OpenAI / ElevenLabs
• 免费：Edge TTS（无需 API Key）
• 自动 TTS：

• 向量搜索：
• 模型切换：
• 认证设置：
• 日志：

• ClawHub：
• Hook 列表：

• 无 DM 回复 → 配对列表 → 批准
• 群组中静音 → 检查提及模式配置
• 认证过期 →
• 网关关闭 →
• 内存 Bug → 重建内存索引

• 浏览器：
• 子代理：
• 定时任务：
• 心跳：

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

• 阿里云：https://www.aliyun.com/activity/ecs/clawdbot
• 腾讯云：https://cloud.tencent.com/developer/article/

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

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

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

OpenClaw 常用命令如下：

• 真正做到了”像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 强在自动完成整个工程流程