OpenClaw 完全新手指南

32次阅读

https://www.runoob.com/ai-agent/openclaw-cloud.html

https://vercel-deploy-livid-nine.vercel.app/#config

OpenClaw 是一款个人 AI 助手,运行在你自己的设备上。它可以通过你已经在使用的通讯渠道(WhatsApp、Telegram、Slack、Discord、Google Chat、Signal、iMessage、Microsoft Teams、WebChat 等)与你交互,还支持语音对话、Canvas 可视化等高级功能。

OpenClaw 是一个本地优先的 AI 助手网关,它的核心设计理念是:

个人化:为你个人服务,而非企业级多用户系统
本地运行:Gateway 运行在你的设备上(macOS、Linux、Windows WSL2)
多渠道接入:支持几乎所有主流通讯平台
功能丰富:浏览器控制、Canvas 可视化、语音交互、定时任务等

架构概览

WhatsApp / Telegram / Slack / Discord / Google Chat / Signal / iMessage / WebChat
               │
               ▼
┌───────────────────────────────┐
│            Gateway            │
│       (控制平面 - 核心)        │
│     ws://127.0.0.1:18789      │
└──────────────┬────────────────┘
               │
               ├─ AI 智能体 (Agent)
               ├─ CLI 命令行工具
               ├─ WebChat 网页界面
               ├─ macOS/iOS/Android 客户端
               └─ 浏览器控制 (Chrome CDP)

安装指南

系统要求

Node.js ≥ 22(必须)
操作系统:macOS、Linux、Windows (WSL2)
包管理器:npm、pnpm 或 bun

快速安装(推荐)

macOS / Linux

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

Windows (PowerShell)

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

npm 安装

# 使用 npm
npm install -g openclaw@latest

# 或使用 pnpm
pnpm add -g openclaw@lates

运行引导向导

# 完整安装向导 + 安装系统服务
openclaw onboard --install-daemon

# 仅运行配置向导
openclaw onboard

检查安装

# 查看 Gateway 状态
openclaw gateway status

# 打开控制面板
openclaw dashboard

快速开始

  1. 启动 Gateway

    前台运行(适合调试)
    openclaw gateway --port 18789 --verbose
    # 使用守护进程(后台运行)
    openclaw gateway start
  2. 打开控制面板

    openclaw dashboard
    # 或直接在浏览器访问:
    # http://127.0.0.1:18789
  3. 发送测试消息

    penclaw message send --to +15555550123 --message "Hello from OpenClaw"
  4. 与智能体对话

    # 命令行直接对话
    openclaw agent --message "帮我总结今天的会议" --thinking high

Workspace 工作空间

Workspace 是 OpenClaw 智能体的工作目录,也是它读取上下文、保存记忆、执行工具操作的唯一位置。

Workspace 结构

~/.openclaw/
├── openclaw.json # 主配置文件
├── workspace/ # 默认工作空间
│ ├── AGENTS.md # 操作指令和记忆
│ ├── SOUL.md # 人格、边界、语气
│ ├── TOOLS.md # 工具使用笔记
│ ├── IDENTITY.md # 助手名称/头像/表情
│ ├── USER.md # 用户信息
│ ├── MEMORY.md # 长期记忆(仅主会话加载)
│ └── skills/ # 工作空间级技能
├── agents/ # 多智能体会话存储
├── skills/ # 全局技能
└── credentials/ # 凭证存储
正文完
 0