快速上手教程
10 分钟内运行起你的私人 AI 助手。
1
环境准备
你需要安装 Node.js (v22+)。macOS 用户可直接使用终端；Windows 用户强烈建议安装 WSL2 (Ubuntu)。
2
一键安装与向导
在终端运行以下命令，启动交互式配置向导：
openclaw onboard --install-daemon
向导会引导你选择网关模式、配置 AI 模型（推荐 Anthropic Claude Pro）以及绑定聊天渠道。
3
启动与验证
安装完成后，服务会自动在后台运行。检查状态：
openclaw status
或者在浏览器访问 Dashboard： http://127.0.0.1:18789/
4
配对首个设备
如果使用 WhatsApp，运行 `openclaw channels login` 扫码。如果使用 Telegram，向 Bot 发送消息并批准 Pairing Code。
安全指南
OpenClaw 拥有系统级权限，请务必遵循以下最佳实践。
高风险提示
不要将 Gateway 端口（18789）直接暴露在公网。请使用 Tailscale Serve 进行安全的远程访问。
访问控制 (Access Control)
保持 Pairing 开启
默认情况下，陌生人私聊 Bot 需管理员批准。不要改为 `open` 模式。
群聊 @提及
在群组中设置 `requireMention: true`，防止 AI 随意插话或被恶意触发。
沙箱与隔离
对于非主会话（如公开群聊），建议开启 Docker 沙箱模式，并禁用高风险工具（如 `system.run`）。
// openclaw.json
{
"agents": {
"defaults": {
"sandbox": { "mode": "non-main" }
}
}
}