OpenClaw大龙虾部署（国内环境）详细指南

[1. 前言](#1. 前言)

[2. 环境准备](#2. 环境准备)

[2.1 操作系统](#2.1 操作系统)

[2.2 安装Node.js环境](#2.2 安装Node.js环境)

[3. 部署OpenClaw](#3. 部署OpenClaw)

[3.1 配置 npm 国内镜像源](#3.1 配置 npm 国内镜像源)

[3.2 安装OpenClaw](#3.2 安装OpenClaw)

[3.3 初始化OpenClaw](#3.3 初始化OpenClaw)

[3.3.1 关键配置点](#3.3.1 关键配置点)

[3.3.2 关键截图展示](#3.3.2 关键截图展示)

[3.4 简单测试](#3.4 简单测试)

1. 前言

OpenClaw（江湖人称"大龙虾"），开源个人 AI 智能体（Agent）框架。它由知名开发者 Peter Steinberger 发起（前身曾叫 Clawdbot、Moltbot），其核心 Slogan 是 "The AI that actually does things"（真正做事的 AI）。

2. 环境准备

2.1 操作系统

本文以ubuntu系统为例

cat /etc/os-release

PRETTY_NAME="Ubuntu 24.04.4 LTS"

NAME="Ubuntu"

VERSION_ID="24.04"

VERSION="24.04.4 LTS (Noble Numbat)"

VERSION_CODENAME=noble

ID=ubuntu

ID_LIKE=debian

HOME_URL="https://www.ubuntu.com/"

SUPPORT_URL=" ://help.ubuntu.com/"

BUG_REPORT_URL="https://bugs.launchpad.net/ubuntu/"

PRIVACY_POLICY_URL="https://www.ubuntu.com/legal/terms-and-policies/privacy-policy"

UBUNTU_CODENAME=noble

LOGO=ubuntu-logo

2.2 安装Node.js环境

OpenClaw的核心代码由 TypeScript 编写，需要 Node.js运行环境 (要求版本 ≥ 22)

复制代码

# Ubuntu/Debian 系统
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs

# 验证安装
node --version  # 应显示 v22.x.x
npm --version   # 应显示 10.x.x

3. 部署OpenClaw

3.1 配置 npm 国内镜像源

复制代码

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

3.2 安装OpenClaw

复制代码

#  全局安装 OpenClaw
npm install -g openclaw@latest

3.3 初始化OpenClaw

复制代码

# 交互式配置
openclaw onboard --install-daemon

3.3.1 关键配置点

本文以配置阿里云百炼大模型为例（新用户有免费额度），

Model/auth provider ：选择 Custom Provider
API Base URL : 百炼模型地址填写 https://dashscope.aliyuncs.com/compatible-mode/v1
API key ：登录百炼https://bailian.console.aliyun.com/，获取方式方式如下

Endpoint compatibility ：选择 OpenAI-compatible
Model ID : 可以选择如图所示任意一个，本文选择qwen3.5-plus

3.3.2 关键截图展示

3.4 简单测试

复制代码

root@aly-ubuntu-yq-test:~# cat  /mnt/test/disk_monitor.sh 
#!/bin/bash
# 磁盘使用率监控脚本
# 创建时间：2026-03-11

LOG_FILE="/mnt/test/disk_usage.log"
DATE=$(date '+%Y-%m-%d %H:%M:%S')

# 获取磁盘使用情况
echo "=== 磁盘使用率检查 [$DATE] ===" >> "$LOG_FILE"
df -h >> "$LOG_FILE"
echo "" >> "$LOG_FILE"

# 检查是否有分区使用率超过 80%
echo "警告检查:" >> "$LOG_FILE"
df -h | awk 'NR>1 {
    gsub(/%/, "", $5);
    if ($5 > 80) {
        print "⚠️  警告: " $6 " 分区使用率已达 " $5 "%";
    }
}' >> "$LOG_FILE"
echo "" >> "$LOG_FILE"
echo "==============================" >> "$LOG_FILE"
echo "" >> "$LOG_FILE"

echo "磁盘监控完成，日志已保存到: $LOG_FILE"