#OpenClaw 安装与使用

本章带你完成安装、初始化、并通过 Dashboard 与聊天软件完成第一次对话。

#系统要求

• 操作系统：macOS、Linux、Windows
• 运行时：Node.js 22+
• 硬件：最低 2GB 内存 / 2 核（基础聊天）；浏览器自动化建议 4GB+
• 可运行在旧笔记本、Docker 容器，或 $5/月 的 VPS 上

#一键安装

macOS / Linux：

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

Windows（PowerShell）：

iwr -useb https://openclaw.ai/install.ps1 | iex

安装脚本来自网络，执行前请理解其作用；生产环境建议先在隔离机器上试用。

#初始化：onboard

安装完成后运行引导向导，并安装常驻守护进程：

openclaw onboard --install-daemon

向导会引导你完成：模型 Provider 与密钥、要接入的聊天平台、基本工具策略等。

检查网关状态：

openclaw gateway status

#打开 Dashboard

OpenClaw 自带本地 Web 控制台：

openclaw dashboard

随后在浏览器访问：

http://127.0.0.1:18789/

控制平面通过 WebSocket 监听 :18789。请勿将该端口暴露到公网，并保持版本更新（见 安全章节）。

如需自定义端口运行网关：

openclaw gateway --port 18789

#第一次对话

完成 onboard 后，你可以通过两种方式与 OpenClaw 对话：

1）Dashboard（最快验证）：在 http://127.0.0.1:18789/ 的对话框里直接输入，例如：

你好，做个自我介绍，并告诉我你现在能访问哪些工具。

2）聊天软件：在已接入的平台（如 Telegram）给你的 Bot 发消息。接入方式见 消息通道。

试着让它执行真实任务：

在当前工作区新建一个 notes 文件夹，并写一个 README.md 说明用途。

涉及写入/删除等高风险动作时，OpenClaw 会按工具策略请求你审批后再执行。

#常用命令速查

不同版本命令可能有差异，可运行 openclaw --help 查看当前完整命令。

#部署为常驻服务

让 OpenClaw 24×7 在线（适合 VPS）：

• --install-daemon 会安装系统守护进程
• 也可用 systemd / pm2 / Docker 常驻网关进程
• 确保进程崩溃后能自动拉起，并定期 git 备份 ~/.openclaw

#更新

OpenClaw 迭代很快且曾出现高危漏洞，请保持更新到最新版（至少 2026.1.29 及以上，见 安全章节）。具体更新命令以官方仓库为准。

#下一步

• 配置模型 — 接入你的 LLM
• 消息通道 — 接入 Telegram / WhatsApp
• 上手实战 — 从零搭一个自主助理