📄 本页内容整理自 OpenClaw 官方文档，原始资料请参阅 github.com/openclaw/openclaw。 如有出入，以官方文档为准。
简介
OpenClaw 是一款运行在您自己设备上的自托管个人 AI 助手平台。它采用本地优先架构，由您完全掌控数据与部署，同时无缝接入 WhatsApp、Telegram、Slack、Discord、Google Chat、Signal、iMessage、Microsoft Teams 等 20 余个主流消息平台。
OpenClaw 内置本地 Gateway 控制平面（默认监听 ws://127.0.0.1:18789），负责跨设备、跨渠道的会话、工具调用与事件协调。除文字交互外，还支持语音唤醒与对话、浏览器自动化以及可视化 Canvas 工作区。
20+ 消息平台
WhatsApp、Telegram、Slack、Discord、Signal 等，一个助手覆盖所有渠道。
语音能力
macOS / iOS 语音唤醒词，Android 持续语音模式，支持 ElevenLabs 及系统 TTS。
安全隔离
未知发件人默认需配对验证，群组会话在独立 Docker 沙箱中运行。
系统要求
macOS
原生支持，含语音唤醒词及 Canvas 可视化。支持 Apple Silicon (M 系列) 和 Intel 架构。
Linux
完整支持，推荐 Ubuntu / Debian / Fedora / CentOS 等主流发行版，支持 x86_64 与 ARM64。
Windows
官方强烈推荐使用 WSL2（Windows Subsystem for Linux）运行，不建议在 Windows 原生环境安装。
前置依赖
- ✓ Node.js 22 或更高版本（必须）——OpenClaw 运行时要求 Node ≥ 22，低版本将无法启动。
- ✓ 包管理器：npm（随 Node.js 附带）、pnpm 或 bun 均可，开发构建推荐使用 pnpm。
- ✓ Docker（可选）——如需为群组 / 频道会话启用沙箱隔离，须提前安装 Docker。
- ✓ 网络连接——用于调用 AI 模型 API（如 Anthropic Claude）及各消息平台接口。
方法一：npm 快速安装（推荐）
最简单的方式，两条命令完成全局安装并通过交互向导完成初始化，适合绝大多数用户。
全局安装 OpenClaw
# 使用 npm（推荐）
$ npm install -g openclaw@latest
# 或使用 pnpm
$ pnpm add -g openclaw@latest运行初始化向导并安装守护进程
$ openclaw onboard --install-daemon
onboard 命令将启动交互式向导，引导您完成模型配置、消息渠道接入和守护进程安装，全程约 5–10 分钟。
💡 提示：守护进程（daemon）安装后会在系统启动时自动运行 OpenClaw Gateway，无需每次手动启动。
方法二：源码开发安装
适合希望参与开发、自定义构建或跟踪最新提交的进阶用户。需要提前安装 pnpm。
克隆仓库
$ git clone https://github.com/openclaw/openclaw.git
$ cd openclaw安装依赖并构建
$ pnpm install
$ pnpm ui:build
$ pnpm build初始化并安装守护进程
$ pnpm openclaw onboard --install-daemon（可选）以开发模式启动网关
$ pnpm gateway:watch开发模式下，代码变更会自动重载网关，方便调试。
方法三：手动启动网关
已安装 OpenClaw 后，如需在不使用守护进程的情况下手动启动网关，可使用以下命令。
# 以详细日志模式启动网关（默认端口 18789）
$ openclaw gateway --port 18789 --verbose⚠️ 安全提示：若配合 Tailscale Serve/Funnel 对外暴露网关，必须将网关保持绑定在本地回环地址（loopback），并为 Funnel 访问启用密码认证，切勿直接暴露到公网。
初始配置
配置文件位置
# 全局配置文件
~/.openclaw/openclaw.json
# 工作区目录（可通过 agents.defaults.workspace 自定义）
~/.openclaw/workspace最小配置示例
将以下内容写入 ~/.openclaw/openclaw.json 即可启动：
{
"agent": {
"model": "anthropic/claude-opus-4-6"
}
}接入消息渠道
在配置文件中添加 channels 字段，按需填写各平台的 Bot Token 或凭证。以下为示例：
{
"agent": {
"model": "anthropic/claude-opus-4-6"
},
"channels": {
// Telegram 机器人
"telegram": {
"botToken": "123456:ABCDEF..."
},
// Discord 机器人
"discord": {
"token": "1234abcd..."
}
},
// 可选：启用浏览器自动化
"browser": {
"enabled": true,
"color": "#FF4500"
}
}基本使用
命令行常用操作
# 向指定号码发送消息
$ openclaw message send --to +1234567890 --message "Hello from OpenClaw"
# 与 AI 代理对话（高思考强度模式）
$ openclaw agent --message "Ship checklist" --thinking high
# 检查系统健康状态与安全配置
$ openclaw doctor消息平台内置指令
在 WhatsApp、Telegram、Slack、Discord、Teams 等平台的对话中，可直接使用以下斜杠命令：
/status
查看当前会话状态，含所用模型与 Token 消耗信息。
/new
重置当前会话（等同于 /reset），开启全新对话上下文。
/think <level>
设置思考强度级别：off / minimal / low / medium / high / xhigh。
/verbose on|off
切换详细输出模式，开启后将显示工具调用等调试信息。
/activation mention|always
控制群组中的激活方式：仅@提及触发，或始终响应。
/elevated on|off
切换当前会话的提升权限模式（需在配置中预先允许）。
更新与版本通道
OpenClaw 提供三个发布通道，可根据需要切换：
latest）——版本号格式 vYYYY.M.D，最稳定推荐。
beta）——格式 vYYYY.M.D-beta.N，包含最新功能但稳定性略低。
dev）——跟踪 main 分支最新提交，仅供开发调试使用。
# 切换版本通道
$ openclaw update --channel stable
$ openclaw update --channel beta
$ openclaw update --channel dev常见问题
❓ 提示 "command not found: openclaw"
全局安装后 PATH 可能未刷新。请执行：
$ source ~/.zshrc # zsh 用户
$ source ~/.bashrc # bash 用户如仍无效，确认 npm 全局 bin 目录已在 PATH 中：npm bin -g
❓ Node.js 版本过低，安装失败
OpenClaw 要求 Node ≥ 22。推荐使用 nvm 管理 Node 版本：
$ nvm install 22
$ nvm use 22
$ node --version # 应显示 v22.x.x 或更高❓ npm 全局安装出现权限错误（EACCES）
推荐使用 nvm 管理 Node.js 以完全避免此问题。或者将 npm 全局目录改到用户目录：
$ mkdir -p ~/.npm-global
$ npm config set prefix '~/.npm-global'
$ export PATH=~/.npm-global/bin:$PATH❓ DM 消息未被处理，提示需要配对
这是 OpenClaw 的默认安全行为——未知发件人的 DM 需通过配对码验证后才会被处理。批准配对请运行：
$ openclaw pairing approve如需修改此策略，请调整配置文件中各渠道的 dmPolicy 字段。
❓ 如何快速诊断配置问题？
运行内置诊断工具，它会检查运行时环境、网络连接和安全配置：
$ openclaw doctor💬 还有其他问题？
前往 社区论坛 提问，或加入官方 Discord 服务器 获取实时支持。完整文档请访问 docs.openclaw.ai。