OpenClaw 安装指南：从零开始搭建个人AI助手

Posted on Sun 05 April 2026 in 技术教程

OpenClaw 安装指南：从零开始搭建个人AI助手

前言

OpenClaw是一个本地优先的个人AI助手，它允许你在自己的设备上运行AI能力，同时保持对数据的完全控制。与依赖云端的AI助手不同，OpenClaw的所有数据处理都在本地进行，这为隐私保护提供了坚实基础。

本指南将带你完成从环境准备到成功运行的完整安装过程。

系统要求

硬件要求

  • 内存：最低4GB，推荐8GB或以上
  • 存储空间：至少2GB可用空间
  • 处理器：现代多核处理器

软件要求

  • 操作系统：
  • macOS 10.15+
  • Linux (Ubuntu 20.04+, CentOS 8+, Debian 11+)
  • Windows (通过WSL2)
  • Node.js：版本18或更高，推荐22+
  • 包管理器：npm、pnpm或bun

网络要求

  • 稳定的互联网连接（用于下载依赖和模型）
  • 如果使用消息通道（如WhatsApp、Telegram），需要相应的网络访问权限

安装步骤

步骤1：安装Node.js

macOS用户

# 使用Homebrew安装
brew install node@22

# 验证安装
node --version
npm --version

Linux用户 (Ubuntu/Debian)

# 添加NodeSource仓库
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -

# 安装Node.js
sudo apt-get install -y nodejs

# 验证安装
node --version
npm --version

Windows用户 (WSL2推荐)

# 在WSL2中安装
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs

步骤2：安装OpenClaw

使用npm安装

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

# 验证安装
openclaw --version

使用pnpm安装（推荐）

# 首先安装pnpm
npm install -g pnpm

# 使用pnpm安装OpenClaw
pnpm add -g openclaw@latest

步骤3：初始化配置

使用引导式配置向导

# 启动配置向导（推荐新手使用）
openclaw onboard --install-daemon

向导将引导你完成： 1. 工作空间设置 2. 模型配置 3. 通道选择 4. 守护进程安装

手动配置

如果你更喜欢手动控制，可以跳过向导：

# 创建配置文件目录
mkdir -p ~/.openclaw

# 创建基本配置文件
cat > ~/.openclaw/openclaw.json << EOF
{
  "agent": {
    "model": "deepseek/deepseek-chat"
  },
  "gateway": {
    "bind": "loopback",
    "port": 18789
  }
}
EOF

步骤4：启动Gateway

前台运行（用于测试）

# 启动Gateway并查看日志
openclaw gateway --port 18789 --verbose

后台运行（生产环境）

# 安装为系统服务
openclaw onboard --install-daemon

# 检查服务状态
openclaw gateway status

步骤5：验证安装

测试基础功能

# 测试命令行交互
openclaw agent --message "你好，OpenClaw！"

# 检查系统状态
openclaw status

测试Web界面

  1. 确保Gateway正在运行
  2. 打开浏览器访问：http://localhost:18789
  3. 你应该能看到OpenClaw的控制界面

平台特定配置

macOS配置

权限设置

OpenClaw在macOS上可能需要以下权限： - 辅助功能权限（用于自动化） - 屏幕录制权限（用于Canvas功能） - 通知权限（用于系统通知）

菜单栏应用（可选）

# 安装macOS菜单栏应用
openclaw apps install mac

Linux配置

系统服务配置

# 创建systemd服务（如果自动安装失败）
sudo cp ~/.openclaw/systemd/openclaw.service /etc/systemd/system/
sudo systemctl daemon-reload
sudo systemctl enable openclaw
sudo systemctl start openclaw

防火墙配置

# 如果需要远程访问，开放端口
sudo ufw allow 18789/tcp

Windows WSL2配置

网络配置

# 在WSL2中配置端口转发
# 编辑~/.bashrc或~/.zshrc，添加：
export OPENCLAW_HOST=0.0.0.0

启动脚本

创建启动脚本 start-openclaw.sh：

#!/bin/bash
openclaw gateway --port 18789 --bind 0.0.0.0

模型配置

选择AI模型

OpenClaw支持多种AI模型提供商：

{
  "agent": {
    "model": "deepseek/deepseek-chat",  // 深度求索（推荐中文用户）
    // "model": "anthropic/claude-3-haiku",  // Anthropic Claude
    // "model": "openai/gpt-4o",  // OpenAI GPT
    "auth": {
      "profiles": [
        {
          "provider": "deepseek",
          "apiKey": "你的API密钥"
        }
      ]
    }
  }
}

配置API密钥

环境变量方式

# 设置环境变量
export DEEPSEEK_API_KEY="你的API密钥"
export OPENAI_API_KEY="你的OpenAI密钥"

# 或者写入shell配置文件
echo 'export DEEPSEEK_API_KEY="你的API密钥"' >> ~/.bashrc

配置文件方式

编辑 ~/.openclaw/openclaw.json：

{
  "agent": {
    "auth": {
      "profiles": [
        {
          "provider": "deepseek",
          "apiKey": "你的API密钥"
        }
      ]
    }
  }
}

常见问题解决

安装问题

问题1：权限错误

# 解决方案：使用sudo或修复权限
sudo npm install -g openclaw@latest
# 或者
npm install -g openclaw@latest --unsafe-perm

问题2：Node.js版本过低

# 升级Node.js
npm install -g n
n latest

问题3：端口被占用

# 检查端口占用
lsof -i :18789

# 停止占用进程或更改端口
openclaw gateway --port 18790

运行问题

问题1：Gateway启动失败

# 查看详细日志
openclaw gateway --verbose

# 检查配置文件
openclaw doctor

问题2：模型连接失败

# 测试模型连接
openclaw agent --message "测试" --thinking minimal

# 检查API密钥
openclaw config get agent.auth

问题3：内存不足

# 调整内存限制
export NODE_OPTIONS="--max-old-space-size=4096"
openclaw gateway

进阶配置

多模型配置

{
  "agent": {
    "model": "deepseek/deepseek-chat",
    "fallbacks": [
      "anthropic/claude-3-haiku",
      "openai/gpt-3.5-turbo"
    ]
  }
}

工作空间配置

{
  "agents": {
    "defaults": {
      "workspace": "~/.openclaw/workspace",
      "sandbox": {
        "mode": "non-main",
        "dockerImage": "openclaw/sandbox:latest"
      }
    }
  }
}

日志配置

{
  "logging": {
    "level": "info",
    "file": "~/.openclaw/logs/openclaw.log",
    "maxSize": "10m",
    "maxFiles": 5
  }
}

安装后步骤

1. 创建工作空间

# 初始化工作空间
openclaw workspace init

# 查看工作空间结构
ls -la ~/.openclaw/workspace/

2. 安装基本技能

# 查看可用技能
openclaw skills list

# 安装常用技能
openclaw skills install weather
openclaw skills install calendar

3. 配置消息通道

# 查看支持的通道
openclaw channels list

# 配置Telegram（示例）
openclaw channels configure telegram

4. 设置自动化

# 创建定时任务
openclaw cron add "0 8 * * *" "发送每日简报"

性能优化建议

硬件优化

  1. 使用SSD：显著提升IO性能
  2. 增加内存：AI模型需要足够的内存
  3. 优化网络：使用有线连接减少延迟

软件优化

  1. 使用轻量级模型：如DeepSeek Chat
  2. 启用缓存：减少重复计算
  3. 定期清理：删除不必要的日志和临时文件

配置优化

{
  "gateway": {
    "performance": {
      "maxConnections": 20,
      "workerThreads": 4,
      "memoryLimitMB": 1024
    }
  }
}

安全考虑

1. 访问控制

{
  "gateway": {
    "auth": {
      "mode": "password",
      "password": "强密码"
    }
  }
}

2. 网络隔离

  • 仅在需要时开放端口
  • 使用防火墙限制访问
  • 考虑使用VPN或Tailscale

3. 数据加密

# 启用TLS（如果需要远程访问）
openclaw gateway --tls --tls-cert cert.pem --tls-key key.pem

维护和更新

定期更新

# 检查更新
openclaw update --check

# 执行更新
openclaw update

# 更新插件和技能
openclaw plugins update
openclaw skills update

备份配置

# 备份配置文件
cp -r ~/.openclaw ~/.openclaw-backup-$(date +%Y%m%d)

# 备份工作空间
tar -czf openclaw-workspace.tar.gz ~/.openclaw/workspace

监控和日志

# 查看运行状态
openclaw status

# 查看日志
openclaw logs --follow

# 监控资源使用
openclaw metrics

结语

通过本指南，你应该已经成功安装了OpenClaw并完成了基本配置。OpenClaw的强大之处在于它的灵活性和可定制性，你可以根据自己的需求调整配置。

记住，OpenClaw是一个本地优先的工具，这意味着你有完全的控制权。花时间熟悉它的各种功能，你会发现它能够极大地提升你的工作效率和生活质量。

如果在安装过程中遇到问题，可以参考官方文档或社区论坛。OpenClaw有一个活跃的社区，很多问题都能在那里找到解决方案。

现在，你的个人AI助手已经准备就绪，开始探索OpenClaw的无限可能吧！

本文基于OpenClaw v2026.3编写，具体命令和配置可能随版本更新而变化。建议查阅官方文档获取最新信息。

系列导航

← 上一篇：OpenClaw 系列文章首页 下一篇：OpenClaw 核心概念详解：理解个人AI助手的工作原理 →

OpenClaw 安装指南 AI助手 本地部署 命令行工具