OpenClaw (Clawdbot) 教程 | 菜鸟教程

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

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

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

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

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

• • OpenClaw 官网: https://openclaw.ai/
• • 中文文档： https://docs.openclaw.ai/zh-CN
• • Github 地址：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。

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

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

macOS/Linux 系统:

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

Windows 系统：

#PowerShelliwr -useb https://openclaw.ai/install.ps1 | iex#CMDcurl -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# 如果速度慢可以指定国内镜像npm i -g openclaw --registry=https://registry.npmmirror.com

或使用 pnpm：

pnpm add -g openclaw

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

openclaw onboard

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

git clone https://github.com/openclaw/openclaw.gitcd openclawpnpm installpnpm 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 系统：

#PowerShelliwr -useb https://openclaw.ai/install.ps1 | iex#CMDcurl -fsSL https://openclaw.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

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

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

openclaw onboard --install-daemon

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

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

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

openclaw status

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

openclaw gateway status

手动运行（前台）：

openclaw gateway --port 18789 --verbose

安装后可以执行的命令：

• • 运行新手引导：openclaw onboard --install-daemon
• • 快速检查：openclaw doctor
• • 检查 Gateway 网关健康状态：openclaw status + openclaw health
• • 打开仪表板：openclaw dashboard

卸载

使用内置卸载程序：

openclaw uninstall

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

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

使用技能

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

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

ClawHub 国内镜像：https://skillhub.tencent.com/

安装 ClawHub 工具：

# 推荐方式（npx 无需全局安装）npx clawhub@latest --version# 或全局安装（方便以后直接用 clawhub 命令）npm install -g clawhub# 或者用 pnpmpnpm 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 常用命令一览表：

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

通道管理

• • WhatsApp：openclaw channels login（或扫描 QR）
• • Telegram：openclaw channels add --channel telegram（需 Bot Token）
• • Discord：openclaw channels add --channel discord（需 Bot Token）
• • iMessage：macOS 原生桥接
• • Slack：openclaw channels add --channel slack（需 Bot Token）

工作区结构（Workspace Anatomy）

• • AGENTS.md：指令说明
• • USER.md：偏好设置
• • MEMORY.md：长期记忆
• • HEARTBEAT.md：检查清单
• • SOUL.md：人格/语气
• • IDENTITY.md：名称/主题
• • BOOT.md：启动配置
• • 根目录：~/.openclaw/workspace

聊天内斜杠命令

• • /status：健康 + 上下文
• • /context list：上下文贡献者
• • /model <m>：切换模型
• • /compact：释放窗口空间
• • /new：全新会话
• • /stop：中止当前运行
• • /tts on|off：切换语音
• • /think：切换推理模式

关键路径映射（Essential Path Map）

• • 主配置：~/.openclaw/openclaw.json
• • 默认工作区：~/.openclaw/workspace/
• • 智能体状态目录：~/.openclaw/agents/<cid>/
• • OAuth & API 密钥：/.openclaw/agents//agent/auth-profiles.json，如果是旧版本的在`/.openclaw/credentials/`
• • 向量索引存储：~/.openclaw/memory/<cid>.sqlite
• • 全局共享技能：~/.openclaw/skills/
• • 网关文件日志：/tmp/openclaw/*.log

语音与 TTS

• • 付费：OpenAI / ElevenLabs
• • 免费：Edge TTS（无需 API Key）
• • 自动 TTS：messages.tts.auto: "always"

内存与模型

• • 向量搜索：memory search "X"
• • 模型切换：models set <model>
• • 认证设置：models auth setup
• • 日志：memory/YYYY-MM-DD.md

Hooks 与技能

• • ClawHub：clawhub install <slug>
• • Hook 列表：openclaw hooks list

故障排除

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

自动化与研究

• • 浏览器：browser start/screenshot
• • 子代理：/subagents list/info
• • 定时任务：cron list/run <cid>
• • 心跳：heartbeat.every: "30m"

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

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

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

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

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 强在自动完成整个工程流程