夜雨聆风
OpenClaw 完整操作指南
OpenClaw
核心能力
架构概览
安装方法
OpenClaw 的安装被设计得极为友好，即使是非开发者也能快速上手。
系统要求（不一定 Mac mini）：
-
硬件：极低，2GB RAM 即可运行。 -
环境：支持 Mac, Windows, Linux，需要安装 Node.js (pnpm) 或使用 Docker
推荐安装方式（一键脚本）
直接通过终端，执行以下命令。
macOS/Linux 系统:
curl -fsSL https://openclaw.ai/install.sh | bashWindows 系统：
#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）并完成基本配置。
手动安装
需要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.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 | bashWindows 系统：
#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 uninstallopenclaw 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 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：切换模型
/compact：释放窗口空间
/new：全新会话
/stop：中止当前运行
/tts on|off：切换语音
/think：切换推理模式
命令速查表
术语表
