安装与配置

前置条件

安装 Node.js 22+（推荐用 nvm）：

# 使用 nvm 安装
nvm install 22
nvm use 22

# 验证版本
node --version   # 应显示 v22.x.x

安装 OpenClaw

# 使用 npm（全局安装）
npm install -g openclaw

# 或使用 pnpm
pnpm add -g openclaw

# 或使用 bun
bun add -g openclaw

向导初始化

首次运行使用向导模式，按步骤完成配置：

openclaw wizard

向导会引导你完成：

1. 网关基础配置（端口、日志级别）
2. AI 模型接入（API Key 配置）
3. 频道连接（至少选择一个频道）
4. 安全设置（访问控制策略）

配置文件

配置文件默认位于 ~/.openclaw/config.json，核心字段：

{
  "gateway": {
    "port": 3000,
    "logLevel": "info"
  },
  "ai": {
    "provider": "anthropic",
    "apiKey": "sk-ant-...",
    "model": "claude-sonnet-4-6"
  },
  "channels": {
    "telegram": {
      "enabled": true,
      "token": "YOUR_BOT_TOKEN"
    }
  },
  "security": {
    "dmPairingPolicy": "whitelist"
  }
}

启动服务

# 前台运行（调试用）
openclaw start

# 后台守护进程
openclaw start --daemon

# 查看状态
openclaw status

控制面板

启动后访问 Web 控制面板：

http://localhost:3000

控制面板提供实时日志、频道状态、会话管理等功能。

使用 Docker 运行

推荐生产环境使用 Docker：

docker run -d \
  --name openclaw \
  -p 3000:3000 \
  -v ~/.openclaw:/root/.openclaw \
  openclaw/openclaw:latest

提示

初次使用建议先通过向导完成配置，再考虑切换到 Docker 运行。

注意

Node.js 版本必须 ≥ 22，低版本会导致启动失败。