开始安装
🦞 Self-hosted · Multi-channel · Agent-native

OpenClaw
入门教程

这是一页适合新手的 OpenClaw 教程：你会知道它是什么、怎么安装、怎么完成 Onboarding、怎么打开控制台、怎么用 CLI 让 Agent 跑一次任务，以及部署时要注意哪些安全问题。

5 分钟快速跑通 先看核心概念

页面为静态 HTML，可直接上传到网站空间、宝塔、Vercel、Netlify 或普通服务器。

# macOS / Linux / WSL2
$ curl -fsSL https://openclaw.ai/install.sh | bash
# Windows PowerShell
PS> iwr -useb https://openclaw.ai/install.ps1 | iex
# 完成引导并安装后台服务
$ openclaw onboard --install-daemon
# 打开 Web 控制台
$ openclaw dashboard
Gateway负责会话、路由、渠道连接
ChannelsTelegram、Slack、Discord、WhatsApp 等
Agent接收消息、调用模型与工具完成任务
Dashboard浏览器里管理聊天、配置和会话

OpenClaw 是什么？

简单说，它是一个你自己运行的个人 AI 助手网关：把你常用的聊天软件连接到一个本地或服务器上的 AI Agent，让你可以像发消息一样让它处理任务。

适合开发者和重度效率用户
🏠

自托管

OpenClaw 运行在你自己的电脑或服务器上，Gateway 是会话、路由和渠道连接的中心。

💬

多渠道

它可以把 Telegram、Slack、Discord、Signal、WhatsApp、WebChat 等渠道接到同一个助手。

🧠

Agent 原生

它围绕工具调用、会话、记忆、多 Agent 路由等能力设计，不只是一个普通聊天 UI。

先理解 5 个核心概念

把这几个词搞懂，后面安装和排错会轻松很多。

概念通俗解释你要关心什么
GatewayOpenClaw 的核心进程，负责接收消息、路由会话、调用 Agent。它要保持运行；部署到服务器时要注意端口和权限。
Channel聊天入口，比如 Telegram、Slack、Discord、WhatsApp、WebChat。不同渠道需要不同的 Bot Token、账号或插件配置。
Agent真正处理任务的 AI 助手，可以调用模型、工具、技能和工作区文件。给它的权限越多，安全边界越要清晰。
Session一次持续对话或任务上下文。CLI 里可用 session key / session id 指定会话。
Dashboard浏览器里的控制台，用来聊天、管理配置、查看会话。本机默认地址通常是 127.0.0.1:18789。

安装 OpenClaw

推荐先用官方安装脚本。它会检测系统，必要时安装 Node，并启动 Onboarding。已经熟悉 Node 的用户也可以用 npm / pnpm / bun。

需要 Node 24 或 Node 22.19+
🍎

macOS / Linux / WSL2

适合 Mac、Linux 服务器，以及 Windows 用户使用 WSL2 的情况。

推荐安装脚本
curl -fsSL https://openclaw.ai/install.sh | bash
🪟

Windows PowerShell

适合 Windows 原生环境。也可以使用 Windows Hub 应用或 WSL2 Gateway。

PowerShell 安装
iwr -useb https://openclaw.ai/install.ps1 | iex
📦

已有 Node：npm 安装

已经装好 Node 的用户可以直接全局安装。

npm
npm install -g openclaw@latest
openclaw onboard --install-daemon
🧪

从源码运行

适合想看源码、二次开发或贡献代码的人。

Source checkout
git clone https://github.com/openclaw/openclaw.git
cd openclaw
corepack enable
pnpm install
pnpm build
pnpm ui:build
pnpm openclaw onboard

5 分钟快速跑通

按下面流程走一遍，目标是先让 OpenClaw 能启动、能打开控制台、能收到一次 Agent 回复。

安装 CLI

优先用安装脚本。如果你使用 Windows，建议先确认 PowerShell 可以正常联网，或者直接使用 WSL2。

运行 Onboarding

引导过程会帮你设置 Gateway、模型提供商、工作区、渠道和基础服务。

Onboarding
openclaw onboard --install-daemon

打开 Dashboard

Gateway 启动后，用浏览器控制台进行聊天、配置和会话管理。

Dashboard
openclaw dashboard

接入第一个聊天渠道

新手建议先从 WebChat 或 Telegram 开始。等跑通后，再接 Slack、Discord、WhatsApp、Signal 等渠道。

发第一条任务

可以先发简单任务，例如“帮我总结今天待办”“检查项目 README 里的安装步骤”“生成一份日报模板”。

Onboarding 时怎么选？

第一次配置不要追求复杂，先选择一个模型提供商、一个最容易接入的渠道、一个测试工作区，确认链路跑通后再扩展。

推荐新手配置

模型
选你已经有额度或订阅的提供商，并优先使用稳定、强一点的模型。
渠道
先用 WebChat 或 Telegram，少踩坑，适合验证流程。
工作区
先给它一个测试目录，不要一上来就开放整个电脑主目录。
权限
能不给管理员权限就不给，能用测试账号就不用主账号。

部署位置怎么选？

如果只是自己试用，可以先跑在本机；如果希望手机随时能唤醒它，建议跑在一台长期在线的机器上，例如家里的小主机、VPS、NAS 或云服务器。

查看帮助
openclaw --help
openclaw onboard --help

常用 CLI 命令

OpenClaw 不只可以在聊天软件里用，也可以通过命令行触发 Agent，适合脚本、自动化、定时任务和排错。

场景命令说明
打开控制台openclaw dashboard启动或打开 Web Control UI。
运行 Onboardingopenclaw onboard --install-daemon完成配置并安装后台服务。
指定 Agent 执行任务openclaw agent --agent ops --message "Summarize logs"让指定 Agent 跑一次任务。
本地嵌入式运行openclaw agent --agent ops --message "Run locally" --local不走 Gateway，直接在本地跑一次。
JSON 输出openclaw agent --to +15555550123 --message "status" --json适合脚本解析结果。
CLI agent 示例
openclaw agent --agent ops --message "Summarize logs"
openclaw agent --agent ops --model openai/gpt-5.4 --message "Summarize logs"
openclaw agent --session-key agent:ops:incident-42 --message "Summarize status"
openclaw agent --agent ops --message "Generate report" --deliver --reply-channel slack --reply-to "#reports"

安全建议：先小权限跑通

OpenClaw 这类 Agent 能连接聊天渠道、模型、文件、工具和账号。越“能干”，越要把权限边界设计好。

重要

⚠️ 不建议一开始就给它全盘权限

  • 先用测试目录，不要直接开放整个用户目录、桌面、下载文件夹。
  • 先用测试账号或子账号，不要一开始绑定主邮箱、主支付账号、主业务后台。
  • API Key 放到安全的环境变量或 Secret 管理里，不要写进公开仓库。
  • Dashboard 默认本地访问即可，不要随手暴露到公网；远程访问可考虑 VPN / Tailscale / 反代认证。
  • 让 Agent 执行删除、转账、发送邮件、批量改文件等高风险动作前，最好保留人工确认。
🔐

权限最小化

给它完成任务所需的最小权限，后续按需增加。

🧾

保留日志

定期查看会话、工具调用和异常输出，方便排错和审计。

🧯

先测试后生产

重要工作流先在测试环境里跑通，再接入真实账号和真实数据。

常见问题

下面是新手最容易遇到的几个问题。

OpenClaw 必须一直开着吗？

如果你希望它随时响应手机或聊天软件消息，Gateway 所在的电脑或服务器需要保持在线。只做本地测试时，打开终端运行即可。

我需要准备 API Key 吗？

通常需要。OpenClaw 本身是网关和 Agent 运行环境，真正生成回复还需要你配置模型提供商或订阅入口。

Windows 用户选原生还是 WSL2？

简单体验可以先用 Windows 原生安装或 Windows Hub；如果你要长期运行、接插件、跑开发环境，WSL2 通常更接近 Linux 服务器环境。

Dashboard 打不开怎么办？

先确认 Gateway 是否启动，再检查本机端口是否被占用。默认本地地址通常是 127.0.0.1:18789。远程访问时要检查防火墙、反向代理和认证。

能不能直接部署到我的网站空间？

普通静态空间只能放这个教程页面，不能运行 OpenClaw Gateway。Gateway 需要 Node 运行环境和长期在线进程，适合 VPS、云服务器、NAS、小主机或本机。

已复制命令