步骤#

1
# 1. 一键安装（自动检测环境、安装 Node.js、下载 OpenClaw）
2
curl -fsSL https://openclaw.ai/install.sh | bash
3

4
# 2. 验证安装
5
openclaw --version
6

7
# 3. 运行初始化向导（10 步交互式配置）
8
openclaw onboard --install-daemon

初始化向导会引导你：接受风险提示 → 选择 QuickStart 模式 → 选择 AI 服务商 → 填入 API Key → 选择消息平台 → 设置 Gateway 端口（默认 18789） → 选择 Skills → 配置可选的额外 API Key → 启用 Hooks → 完成后自动打开 Web UI（http://127.0.0.1:18789/chat）。

日常使用#

1
openclaw gateway start    # 启动网关
2
openclaw gateway stop     # 停止网关
3
openclaw channels status  # 查看频道状态
4
openclaw dashboard        # 打开 Web 控制面板

更新与卸载#

1
openclaw update           # 更新到最新版
2
openclaw uninstall        # 卸载（保留数据）
3
openclaw uninstall --purge  # 彻底卸载，删除所有数据

WSL2 + Ubuntu（强烈推荐）#

1
# 1. 启用 WSL2，在 Microsoft Store 安装 Ubuntu 22.04/24.04
2
# 2. 在 Ubuntu 终端中安装 Node.js 24
3
curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -
4
sudo apt-get install -y nodejs
5

6
# 3. 安装 OpenClaw
7
curl -fsSL https://openclaw.ai/install.sh | bash
8
openclaw onboard --install-daemon

可选：创建 start-openclaw.bat 脚本放在 Windows 桌面，自动将 WSL2 端口转发到 Windows：

1
wsl -d Ubuntu -e openclaw gateway start
2
netsh interface portproxy add v4tov4 listenport=18789 connectaddress=<WSL2-IP>

PowerShell 原生部署（备选）#

以管理员身份运行 PowerShell：

1
# 先手动安装 Node.js 24（从 nodejs.org 下载）
2
# 然后安装 OpenClaw
3
npm install -g openclaw@latest

PowerShell 原生部署可能遇到 sharp 模块编译问题，需 npm cache clean --force 后重装，或添加 Windows Defender 排除项。

docker-compose.yml 示例#

1
services:
2
  app:
3
    build: .
4
    ports:
5
      - "3000:3000"
6
    env_file: .env
7
    depends_on:
8
      - db
9
      - redis
10
  db:
11
    image: postgres:15
12
    environment:
13
      POSTGRES_USER: openclaw
14
      POSTGRES_PASSWORD: ${DB_PASSWORD}
15
      POSTGRES_DB: openclaw
16
    ports:
17
      - "5432:5432"
18
  redis:
19
    image: redis:7
20
    ports:
21
      - "6379:6379"

启动：

1
docker compose up --build

安全加固#

1
docker run --cap-drop=ALL --read-only --security-opt=no-new-privileges openclaw

要不要处理？#

如果你用 nvm 管理稳定的 Node 24，可以安全忽略此警告。 运行 openclaw doctor --fix 可能适得其反——它会把 nvm 路径替换为系统 Node（如 Homebrew 的 /opt/homebrew/bin/node），而系统 Node 版本可能与 OpenClaw 不兼容，导致原生模块（如 better-sqlite3）加载失败。这是已知问题（GitHub Issue #23314）。

建议：

• 确保使用的 Node 版本为 24（推荐）或 22.16+
• openclaw doctor 用于诊断，谨慎使用 --fix
• 安装后三连验证：openclaw doctor → openclaw status → openclaw dashboard

模型路由：按复杂度分级#

所有任务用最强模型浪费约 70% 成本。按复杂度分级路由：

1
models:
2
  default: claude-haiku     # 简单任务用廉价模型
3
  fallback: claude-sonnet   # 中等任务升级
4
  complex: claude-opus      # 复杂任务用强模型
5
  heartbeat: claude-haiku   # 心跳用最便宜模型

2026 年 4 月起，模型配置迁移为 provider catalog 驱动，/models add 已废弃。

安全硬约束#

SOUL.md 中的 prompt 指令是软约束，可被注入绕过。真正的安全靠 tools.deny 硬约束：

1
{
2
  "tools": {
3
    "deny": [
4
      "group:runtime",
5
      "group:fs",
6
      "group:automation",
7
      "sessions_spawn",
8
      "sessions_send"
9
    ]
10
  }
11
}

• group:runtime — 禁止命令执行
• group:fs — 禁止文件读写
• group:automation — 禁止定时任务
• sessions_spawn / sessions_send — 禁止跨 session 操作

网关安全#

始终绑定到 127.0.0.1，使用强 Token 认证：

1
openclaw doctor --generate-gateway-token

1
{
2
  "gateway": {
3
    "bind": "127.0.0.1"
4
  }
5
}

外网访问走 Nginx/Caddy 反向代理 + HTTPS，禁止直接暴露网关端口。推荐使用 Tailscale 替代 LAN 绑定。

Context 管理#

1
{
2
  "context": {
3
    "maxMessages": 30,
4
    "mode": "cache-ttl",
5
    "ttl": "6h"
6
  },
7
  "memory": {
8
    "flushThreshold": 40000,
9
    "keepTypes": ["decision", "state_change", "lesson"]
10
  }
11
}

记忆聚焦”决策、状态变更、教训”三类高价值信息，避免上下文膨胀。

并发控制与崩溃恢复#

1
{
2
  "maxConcurrent": 4,
3
  "throttleInterval": 5
4
}

• maxConcurrent: 4–8 — 防止重试风暴耗尽 API 配额
• throttleInterval: 5 — 崩溃后 5 秒自动恢复

日志与密钥#

1
{
2
  "logging": {
3
    "redactSensitive": "tools",
4
    "rotation": "daily",
5
    "retention": "7d"
6
  }
7
}

• API Key 放 .env 文件（chmod 600），不要写入配置文件
• 使用独立 Token + 硬消费上限的 burner API Key

会话隔离#

1
{
2
  "dmScope": "per-peer",
3
  "dmPolicy": "allowlist"
4
}

面向客户场景必须 per-peer 隔离，每个用户独立 session，防止跨用户信息泄露。

个人 AI 助理#

通过 Telegram / 飞书接入，实现日程管理、邮件摘要、代码审查、网页内容总结。Mac 环境下可操作系统级功能（日历、备忘录、截图）。

企业内部知识助手#

连接公司文档、Wiki、工单系统，回答政策、流程、技术问题。核心架构：RAG 管道 + 自动索引 + 角色权限控制。文档分 chunk，检索带置信度阈值，低置信度转人工。

AI 客服代理#

对接 WhatsApp、Slack、网页聊天组件，自动回答 FAQ、创建工单、查询订单。每客户独立 session，必须设置人工升级路径。实测夜间紧急工单响应时间从 90 分钟缩短至 12 分钟。

财务自动化#

智能对账（98%+ 交易自动核销）、发票管理（效率提升 40 倍）、动态报表生成（8 小时 → 12 分钟）、政策合规监控。某零售集团月结周期从 15 天缩短至 3 天，人力成本降低 65%。

数据提取与富化管道#

从网页、PDF、API 批量提取结构化数据：竞品价格监控、简历提取、合同审查（风险点识别率超 85%）。工程要点：重试逻辑 + 验证层 + 检查点批处理。

GitHub Issue 自动分类#

OpenClaw 官方 ClawSweeper Bot 管理 7000+ issue，三通道架构：调度器 → 审查通道（只出提案） → 执行通道（15 分钟间隔验证后关闭）。关闭率仅 0.1%/周，极度保守避免误关闭。

消费硬件生态#

• 小米 — Xiaomi miclaw（已启动测试，联动米家设备）
• 华为 — 小艺 claw（已启动测试）
• AI 眼镜 — Rokid、李未可等品牌深度适配，语音远程操控电脑
• 人形机器人 — Zeroth 元点 M1 搭载 OpenClaw，QQ 发送指令操控行走、转身