Linux 机器（Ubuntu/Debian）

1. 更新系统并安装依赖

代码语言：Bash

sudo apt update && sudo apt upgrade -y
sudo apt install -y curl git

2. 安装 Node.js

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

检查版本：

node -v
npm -v

3. 配置 npm 国内镜像（推荐）

npm config set registry https://registry.npmmirror.com

4. 安装 OpenClaw

sudo npm install -g openclaw@latest

openclaw --version

5. 运行初始化向导

openclaw onboard

配置步骤与前述系统一致。

6. 手动启动与管理（可选）

# 启动服务
openclaw gateway start
# 查看状态
openclaw status
# 重启服务
openclaw gateway restart

7. 设置开机自启（可选）

运行初始化向导时选择安装守护进程，或执行：

openclaw gateway enable

8. 健康检查（重要）

openclaw doctor

9. 获取 WebUI 访问令牌（如需）

openclaw token generate

10. 配置文件位置

Linux 配置文件通常位于：

~/.openclaw/openclaw.json

---

配置大模型API（以阿里云百炼为例）

1. 获取API Key

登录阿里云百炼控制台，在“密钥管理”页面创建并复制你的API Key。

2. 使用命令行配置（推荐）

避免手动编辑配置文件，使用 openclaw config 命令进行配置：

# 设置默认模型的提供商为百炼
openclaw config set agents.defaults.model.provider "bailian"
# 设置模型名称（可根据实际替换）
openclaw config set agents.defaults.model.model_id "qwen-max"
# 设置 API Key
openclaw config set models.providers.bailian.api_key "你的API Key"
# 设置 API 基础地址（兼容 OpenAI 格式）
openclaw config set models.providers.bailian.base_url "https://dashscope.aliyuncs.com/compatible-mode/v1"

3. 重启服务

openclaw gateway restart

重启后，即可在 WebUI 中体验完整的 AI 自动化功能。

---

常见问题与提示

• 权限错误：在 Linux/macOS 上，若全局安装失败，可尝试在命令前加 sudo。

• 安装缓慢或失败：确保已配置 npm 国内镜像源；若仍失败，可改用 pnpm 安装：

    npm install -g pnpm
    pnpm install -g openclaw@latest
  

  端口占用：默认端口为 18789。若被占用，可在配置文件 openclaw.json 中修改 port 字段。

• 安全警告：OpenClaw 需要文件读写权限。请勿在存有敏感信息的生产环境根目录下运行，建议指定专用工作区。

• 配置未生效：修改配置文件后，必须执行 openclaw gateway restart 重启服务。

• WebUI 无法访问：确认服务已启动（openclaw status），并检查防火墙设置。若提示需要令牌，使用 openclaw token generate 生成。

---

✅ 验证部署

完成上述步骤后，可以通过以下方式确认部署成功：

1. 浏览器访问 http://localhost:18789，进入 WebUI。

2. 在 WebUI 中尝试执行一个简单任务（如“列出当前目录文件”）。

3. 运行 openclaw doctor 确保所有检查项通过。

✅ 远程访问

gateway:{
    "allowedOrigins": [
        "https://xxxx.com"
    ],
    "allowInsecureAuth": true,
    "dangerouslyDisableDeviceAuth": true
}