OpenClaw入门教程推荐：安装配置与使用技巧

先说几个核心判断：OpenClaw（最初叫Clawdbot，中间改过Moltbot）这个项目，乍看像是又一个开源AI助手小玩意，但仔细研究就会发现，它很可能是2026年AI工具赛道里最值得关注的一匹黑马。

它的开发者是Peter Steinberger——没错，就是搞PSPDFKit的那位。这个背景本身就暗示了一件事：这不是学生练手项目，而是有成熟工程经验的人在认真打磨。

OpenClaw的定位很清晰：一个能真正执行任务的智能体。我们给它一条指令，它不只是输出文字建议，而是直接上手——操作系统、访问网页、处理邮件、整理文件、设置提醒、甚至在终端里写代码。说白了，这是把本地算力+大模型Agent自动化这事玩到了极致。

项目的目标是让AI真正帮你干完活，而不是只告诉你“应该怎么干活”。

有一点必须说明：因为Anthropic在1月27日发了律师函，说Clawd / Clawdbot跟Claude品牌太接近，项目当天紧急更名为Moltbot（脱皮龙虾的意思，吉祥物是很萌的龙虾Molty）。但功能完全不变，旧命令也能继续用。后来到了1月30日，才定下了最终官方名——OpenClaw。Moltbot只是一个过渡，现在大家认准OpenClaw就对了。

• 官网：https://openclaw.ai/
• GitHub仓库：https://github.com/openclaw/openclaw
• 技能合集：https://github.com/VoltAgent/awesome-openclaw-skills

为了方便理解这三个名字的关系，整理了下面对应的时间线：

OpenClaw安装方法

OpenClaw的安装门槛可以说被压得非常低，哪怕不是专业开发者，跟着提示走也能搞定。系统要求很简单：2GB内存就能跑，支持Mac、Windows、Linux，需要装Node.js，或者直接上Docker。

当然，如果手边有台Mac Mini，上手体验会更好一些（不过现在16+256G版的价格已经从之前的2800涨到3800了，成本上确实有点心疼）。

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或pnpm装全局包：

npm i -g openclaw

或：

pnpm add -g openclaw

安装完以后，再运行初始化并安装后台服务：

openclaw onboard

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

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build   # 首次运行会安装UI依赖并构建前端
pnpm build      # 构建整个项目（后端与相关模块）
pnpm openclaw onboard --install-daemon  # 初始化并安装为系统后台服务（开机自启）
pnpm gateway:watch  # 开发模式：监听代码变更自动重载

配置说明

回到一键脚本安装。运行后，它会先检查环境、安装依赖，然后启动配置向导。

这一步会跳出一个警告：这个龙虾能力很强，但风险也很高。直接选yes（选no就退出了）。

接着选快速启动（QuickStart）选项。

然后配置大模型：选择AI供应商，国内外的都支持。如果没有海外账号，用国内的Qwen、MiniMax、智谱的API key也完全OK。

接着选择聊天工具。海外用户一般没有，选最后一个选项；国内用户可以直接选飞书。

其他配置如端口（Gateway Port），默认18789就好。Skills、包管理器选npm，一路默认下去即可。

选一些自己喜欢的skills，也可以直接跳过——用空格键来选择就好。

API key部分，没有就直接选no。

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

安装完成后，浏览器自动打开http://127.0.0.1:18789/chat，界面就出来了。比如让它搜搜最新的科技新闻：

平时可以用openclaw status查看运行状态。

常用命令

openclaw gateway           # 运行WebSocket网关服务（可加--port指定端口）
openclaw gateway start     # 启动
openclaw gateway stop      # 停止
openclaw gateway restart   # 重启
openclaw channels login    # WhatsApp QR配对登录
openclaw channels add      # 添加Telegram/Discord/Slack机器人（可加--token）
openclaw channels status --probe      # 检查通道健康状态
openclaw onboard # 交互式设置向导（可加--install-daemon）
openclaw doctor --deep     # 健康检查与快速修复
openclaw config get|set|unset    # 读取/写入配置值
openclaw models list|set|status  # 模型管理与认证状态
openclaw models auth setup-token # Anthropic认证流程设置

通道管理

• 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 ：切换模型
• /compact：释放窗口空间
• /new：全新会话
• /stop：中止当前运行
• /tts on|off：切换语音
• /think：切换推理模式

关键路径映射（Essential Path Map）

• 主配置：~/.openclaw/openclaw.json
• 默认工作区：~/.openclaw/workspace/
• 袋里状态目录：~/.openclaw/agents//
• OAuth & API密钥：~/.openclaw/credentials/
• 向量索引存储：~/.openclaw/memory/.sqlite
• 全局共享技能：~/.openclaw/skills/
• 网关文件日志：/tmp/openclaw/*.log

语音与TTS

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

内存与模型

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

Hooks与技能

• ClawHub：clawhub install
• Hook列表：openclaw hooks list

故障排除

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

自动化与研究

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

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

如果不想在本机折腾，现在各大云平台已经接入了OpenClaw的镜像，可以一键部署到云上：

• 阿里云轻量级服务器镜像
• 腾讯云服务器镜像

阿里云的镜像部署页面如下，选镜像、点安装，几步就完事：

腾讯云也是类似的操作：

常用命令

下面这个表格基本覆盖了日常需要用到的所有OpenClaw命令，建议收藏：

为什么最近这么火？

简单总结几个原因：

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

其核心能力包括：

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

如果拿它和Claude Code、OpenCode这类代码补全工具对比，OpenClaw的定位其实更接近一个“具备执行权限的工程型智能体”。也就是说：

• Claude Code与OpenCode强在代码质量与理解
• OpenClaw强在自动完成整个工程流程