快速上手 OpenClaw
用 OpenClaw onboarding 跑通 Gateway、Dashboard 和第一条消息。
快速开始的目标不是学完所有配置，而是在 5 分钟内确认三件事：Gateway 已启动、模型认证可用、你能和 Agent 发第一条消息。
你需要准备什么
安装前确认：
- Node.js 可用；Node 24 推荐，Node 22.14+ 支持。
- 至少一个模型供应商 API key，例如 Anthropic、OpenAI、Google 等。
- Windows 用户建议优先用 WSL2，尤其是需要完整本地工具链时。
检查 Node：
node --version第一步：安装
macOS / Linux / WSL2：
curl -fsSL https://openclaw.ai/install.sh | bashWindows PowerShell：
iwr -useb https://openclaw.ai/install.ps1 | iex安装脚本会在安装后进入 onboarding。如果你安装时跳过了 onboarding，手动运行：
openclaw onboard --install-daemon第二步：跑 onboarding
openclaw onboard --install-daemon 会引导你完成：
- 选择模型 provider。
- 填入 API key 或完成对应认证。
- 创建基础配置。
- 安装并配置 Gateway daemon。
- 创建默认 workspace 和启动文件。
普通用户优先走 onboarding，不要一开始手改 ~/.openclaw/openclaw.json。等跑通后，再用 openclaw configure、openclaw config set 或 Control UI 调整。
第三步：确认 Gateway 正在跑
openclaw gateway status正常情况下你会看到 Gateway 监听在 18789 端口。默认本机地址是：
127.0.0.1:18789Gateway 是 OpenClaw 的中枢。消息平台、Web UI、CLI、桌面端和移动端都通过它连接 Agent。
第四步：打开 Dashboard
openclaw dashboard这会打开 Control UI。如果浏览器能加载，并且能看到聊天入口或配置入口，说明 Gateway 的本地 WebSocket / HTTP 入口可用。
也可以直接访问：
http://127.0.0.1:18789如果打不开，先跑：
openclaw doctor
openclaw logs
openclaw health第五步：发送第一条消息
在 Control UI 聊天框里发一条简单消息，例如：
你现在能正常工作吗？请用一句话说明你的身份和当前 workspace。能收到 AI 回复，就说明最小闭环已经跑通。
接下来再接外部聊天渠道。第一次建议从 Telegram 或 Discord 这类文档更成熟的入口开始；如果只是本机使用，WebChat / Dashboard 已经足够验证系统。
常见下一步
连接消息渠道：
- Telegram、Discord、Slack、Feishu、WhatsApp、Matrix、Signal、iMessage 等都在官方 Channels 文档里。
- 每个渠道都要单独处理 bot token、OAuth、webhook 或平台侧权限。
配置 Gateway：
- 模型、工具、sandbox、session、heartbeat、cron、hooks 都在
~/.openclaw/openclaw.json。 - 不确定字段时先用 Control UI 或
openclaw config schema查 schema。
整理 workspace：
AGENTS.md写操作规则。SOUL.md写人格和边界。USER.md写用户信息。TOOLS.md写本地工具约定。MEMORY.md和memory/写长期和日常记忆。
环境变量入口
如果你用服务账号、改状态目录或配置路径，官方列出几个关键变量：
OPENCLAW_HOME=...
OPENCLAW_STATE_DIR=...
OPENCLAW_CONFIG_PATH=...普通本机使用不需要一开始就设置它们。只有迁移、多实例、服务化部署时再动。