Ubuntu 安装 OpenClaw 教程

前置要求

动手部署之前，咱们先得把环境准备妥当。确保你的系统满足以下几个基本条件，这是后续一切顺利的前提。

安装步骤

步骤 1：安装 Node.js 22

OpenClaw 的运行依赖 Node.js 22 或更高版本，这是硬性要求。

# 使用 nvm 安装 Node.js 22或者直接安装nodejs22+
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
# 重新加载 shell
source ~/.bashrc
# 安装 Node.js 22
nvm install 22
nvm use 22
# 验证安装
node --version

???? 提示：安装成功后，命令行应该显示类似 v22.x.x 这样的版本号。

步骤 2：全局安装 OpenClaw

环境准备好之后，接下来就是安装 OpenClaw 本体了。

npm install -g openclaw@latest

安装完成后，别忘了验证一下是否成功：

openclaw --version

步骤 3：初始化并安装服务

OpenClaw 本身是一个功能集合，需要通过初始化向导来配置核心服务。

# 启动初始化向导
openclaw onboard --install-daemon

执行这个命令，它会自动帮你完成几件关键事情：

• ???? 安装核心的 Gateway 服务
• ⚙️ 进行基础的运行配置
• ???? 引导你完成 API Key 的配置流程

步骤 4：配置 API Key

刚才的初始化过程中，最关键的一环就是配置 API Key。这里的选择其实挺灵活的，你可以接入：

• OpenAI 的官方 API
• Anthropic (Claude) 的接口
• 或者其他任何兼容的主流 LLM 服务提供商

如果想查看或手动编辑配置，可以使用以下命令：

# 查看配置
openclaw config edit

配置文件的格式大致如下（以 .openclaw.json 为例），这里可以清晰地看到模型、认证等信息的结构：

{
  "meta": {
    "lastTouchedVersion": "2026.2.24",
    "lastTouchedAt": "2026-03-09T01:29:22.222Z"
  },
  "wizard": {
    "lastRunAt": "2026-03-09T01:29:22.211Z",
    "lastRunVersion": "2026.2.24",
    "lastRunCommand": "configure",
    "lastRunMode": "local"
  },
  "auth": {
    "profiles": {
      "zai:default": {
        "provider": "zai",
        "mode": "api_key"
      },
      "deepseek": {
        "provider": "deepseek",
        "mode": "token"
      }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "custom-api-deepseek-com3": {
        "baseUrl": "https://api.deepseek.com",
        "apiKey": "sk-",
        "api": "openai-completions",
        "models": [{
          "id": "deepseek-reasoner",
          "name": "deepseek-reasoner (Custom Provider)",
          "reasoning": false,
          "input": ["text"],
          "cost": {
            "input": 0,
            "output": 0,
            "cacheRead": 0,
            "cacheWrite": 0
          },
          "contextWindow": 409600,
          "maxTokens": 409600
        }]
      },
      "custom-gpt-agent-cc": {
        "baseUrl": "https://gpt-agent.cc",
        "apiKey": "sk-",
        "api": "anthropic-messages",
        "models": [{
          "id": "claude-sonnet-4-6",
          "name": "claude-sonnet-4-6 (Custom Provider)",
          "reasoning": false,
          "input": ["text"],
          "cost": {
            "input": 0,
            "output": 0,
            "cacheRead": 0,
            "cacheWrite": 0
          },
          "contextWindow": 4096000,
          "maxTokens": 4096000
        }]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "custom-gpt-agent-cc/claude-sonnet-4-6",
        "fallbacks": ["zai/glm-5", "zai/glm-4.5", "deepseek/deepseek-chat", "custom-api-deepseek-com3/deepseek-reasoner"]
      },
      "imageModel": {
        "fallbacks": []
      },
      "models": {
        "zai/glm-5": {
          "alias": "GLM"
        },
        "zai/glm-4.5": {},
        "openai:manual/deepseek-chat": {},
        "anthropic/deepseek-chat": {},
        "deepseek/deepseek-chat": {},
        "openai:deepseek/deepseek-chat": {},
        "custom-api-deepseek-com/deepseek-chat": {
          "alias": "custom-api-deepseek-com"
        },
        "custom-api-deepseek-com2/deepseek-chat": {
          "alias": "custom-api-deepseek-com2"
        },
        "custom-api-deepseek-com3/deepseek-reasoner": {
          "alias": "custom-api-deepseek-com3"
        },
        "minimax-cn/MiniMax-M2.5": {
          "alias": "Minimax"
        },
        "custom-gpt-agent-cc/claude-sonnet-4-6": {
          "alias": "custom-gpt-agent-cc"
        }
      },
      "workspace": "/home/wyx/.openclaw/workspace",
      "compaction": {
        "mode": "safeguard"
      },
      "maxConcurrent": 4,
      "subagents": {
        "maxConcurrent": 8
      }
    }
  },
  "messages": {
    "ackReactionScope": "group-mentions"
  },
  "commands": {
    "native": "auto",
    "nativeSkills": "auto",
    "restart": true,
    "ownerDisplay": "raw"
  },
  "session": {
    "dmScope": "per-channel-peer"
  },
  "gateway": {
    "port": 18789,
    "mode": "local",
    "bind": "loopback",
    "auth": {
      "mode": "token",
      "token": "019f50158ddb4c30aa3987a56a6a711a."
    },
    "tailscale": {
      "mode": "off",
      "resetOnExit": false
    }
  }
}

步骤 5：启动 Gateway

万事俱备，现在可以启动核心的 Gateway 服务了，它是所有功能对外提供服务的入口。

# 启动 Gateway（默认端口 18789）
openclaw gateway
# 或者指定端口
openclaw gateway --port 18789

常用命令

部署完成后，这些命令会成为你的日常操作，不妨先熟悉一下。