实战

OpenClaw 在树莓派和家庭服务器上部署:打造 24 小时私人 AI 助手

OpenClaw 树莓派和家庭服务器(Mac Mini/NUC/VPS)部署完整指南:系统要求、安装步骤、systemd 开机自启、反向代理配置、内网穿透(Tailscale/frp)、资源优化、安全加固,以及低功耗 24 小时运行的完整方案。

2026/3/154分钟 阅读ClaudeEagle

OpenClaw 最大的优势之一是可以完全自托管——运行在你自己的设备上,数据不经过第三方,随时可用。树莓派、Mac Mini、Intel NUC 或 VPS 都是理想的运行平台。

为什么要自托管

  • 隐私:你的对话和数据只在自己的设备上
  • 始终在线:24 小时运行,随时通过 Telegram 连接
  • 低成本:树莓派耗电约 5W,每月电费不到 ¥5
  • 定制自由:完全控制配置、模型、Skills

推荐硬件

设备配置要求优势功耗
树莓派 54GB+ RAM低功耗、便宜~5W
Mac Mini M28GB+ RAM性能强、静音~10W
Intel NUC8GB+ RAM小巧、x86 兼容好~15W
VPS(轻量)2GB+ RAM无需本地硬件,IP 公网按月计费

系统要求

  • OS:Ubuntu 22.04+ / Debian 11+ / macOS 12+
  • Node.js 18+
  • 内存:最低 512MB,推荐 2GB+
  • 磁盘:最低 2GB 可用空间

安装步骤

bash
# 1. 更新系统
sudo apt update && sudo apt upgrade -y

# 2. 安装 Node.js 20
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs

# 3. 安装 OpenClaw
npm install -g openclaw

# 4. 验证
openclaw --version

配置

bash
# 交互式配置向导
openclaw configure

# 手动编辑配置文件
nano ~/.openclaw/config.json
json
{
  "ai": {
    "provider": "anthropic",
    "model": "claude-sonnet-4-5"
  },
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "你的BotToken",
      "allowedUsers": [你的UserID]
    }
  },
  "workspace": {
    "path": "/home/pi/.openclaw/workspace"
  }
}

设置 systemd 开机自启(Linux)

bash
# 创建 service 文件
sudo nano /etc/systemd/system/openclaw.service
ini
[Unit]
Description=OpenClaw AI Assistant
After=network.target

[Service]
Type=simple
User=pi
WorkingDirectory=/home/pi
ExecStart=/usr/bin/openclaw start
Restart=always
RestartSec=10
Environment=ANTHROPIC_API_KEY=sk-ant-你的key
StandardOutput=journal
StandardError=journal

[Install]
WantedBy=multi-user.target
bash
# 启用并启动
sudo systemctl daemon-reload
sudo systemctl enable openclaw
sudo systemctl start openclaw

# 查看状态
sudo systemctl status openclaw
journalctl -u openclaw -f  # 实时日志

macOS 开机自启(launchd)

bash
openclaw service install
openclaw service start

# 查看状态
openclaw service status

内网穿透:从外部访问家庭服务器

方案一:Tailscale(最推荐)

bash
# 安装 Tailscale
curl -fsSL https://tailscale.com/install.sh | sh
sudo tailscale up

# 在手机/电脑上也安装 Tailscale
# 同一账号下的设备组成私有网络
# Telegram Bot 通过互联网直接和 Telegram 通信,不需要穿透

方案二:CloudFlare Tunnel(公网访问)

bash
# 如果需要 Web 访问界面
cloudflared tunnel --url http://localhost:3000

树莓派资源优化

bash
# 使用更轻量的模型(节省 API 成本)
# 在 config.json 里设置默认用 Haiku
# "model": "claude-haiku-3-5"

# 限制 Node.js 内存(树莓派 4GB 版)
# 在 service 文件里添加:
# Environment=NODE_OPTIONS=--max-old-space-size=512

# 关闭不用的功能
# 在 config.json 里 enabled: false

安全加固

bash
# 1. 不要把 API Key 硬编码,用环境变量
# 2. 配置 allowedUsers 白名单(只允许你的 Telegram ID)
# 3. 开启防火墙
sudo ufw enable
sudo ufw allow ssh
sudo ufw deny 3000  # 不暴露 Web 端口到公网

# 4. 定期更新
npm update -g openclaw
sudo apt update && sudo apt upgrade

监控和维护

bash
# 查看 OpenClaw 状态
openclaw status

# 查看日志
journalctl -u openclaw --since '1 hour ago'

# 重启
sudo systemctl restart openclaw

# 更新
npm update -g openclaw
sudo systemctl restart openclaw

部署完成后,在 Telegram 给机器人发消息,你的家庭服务器上的 AI 助手就在线了!


来源:OpenClaw 官方文档 | 部署指南

相关文章推荐

实战OpenClaw 日志与健康检查完全指南:监控、告警与运维自动化OpenClaw 日志系统(Logging)与健康检查(Health Check)完整教程:日志级别配置(debug/info/warn/error)和日志格式(text/json)、日志文件持久化路径配置、按渠道/Agent/Provider 过滤日志、Health Check HTTP 端点(/health)的使用(状态码/响应格式)、用于容器编排的 liveness/readiness 探针配置、Gateway Doctor 命令的详细输出解读、集成 Prometheus 指标导出(/metrics 端点)、Grafana Dashboard 可视化,以及生产环境的日志轮转和告警配置方案。2026/3/25实战OpenClaw 代理配置完全指南:SOCKS5/HTTP 代理接入 Claude API 解决网络限制OpenClaw 网络代理(Proxy)配置完整教程:为什么需要代理(大陆访问 Anthropic/OpenAI API 被限制)、SOCKS5 代理配置方式(proxy.socks5/proxy.url)、HTTP/HTTPS 代理配置、代理认证(带用户名密码的代理)、按 Provider 单独配置代理(Anthropic 用代理、国内模型不走代理)、Clash/V2Ray/Xray 等代理工具与 OpenClaw 的对接方式、代理连通性测试方法,以及常见代理问题排障(SSL证书错误/超时/认证失败)。2026/3/25实战OpenClaw 密钥管理完全指南:API Key 安全存储、环境变量与 Vault 集成OpenClaw 密钥(Secrets)管理完整教程:密钥存储的三种方式对比(配置文件明文/环境变量/外部 Vault)、openclaw secrets set/get/list 命令使用、环境变量在配置中的引用语法(${ENV_VAR})、与系统 Keychain 集成(macOS Keychain/Linux Secret Service)、1Password CLI 和 HashiCorp Vault 接入方案、密钥轮换的操作流程、防止密钥泄露的检查(避免 git commit 含密钥)、以及密钥的最小权限原则(每个渠道用独立的 Token)。2026/3/25实战OpenClaw 渠道排障完全指南:消息收不到、Bot 不回复的系统性诊断方法OpenClaw 渠道故障系统性诊断教程:openclaw doctor 一键诊断命令的输出解读、最常见的 5 类问题(Bot Token 无效/Webhook URL 不可达/DM 配对未完成/网络防火墙拦截/配置格式错误)及对应修复步骤、各主要渠道的专项排障(Telegram 403/WhatsApp QR 失效/Slack 事件订阅未开启/Discord 权限不足/Matrix E2EE 设备未验证)、Gateway 日志的关键字段解读、常见错误码含义(401/403/409/429/503),以及在 Discord 社区获取技术支持的途径。2026/3/25实战OpenClaw 费用控制完全指南:Token 限制、Rate Limit 与 API 成本优化实践OpenClaw API 费用控制完整教程:每请求/每日 Token 上限配置(maxTokensPerRequest/maxTokensPerDay)、Rate Limit 限流防刷设置、每日美元预算告警(budgetAlert)、模型降级策略(高峰期自动切 Haiku 降成本)、Prompt Caching 开启减少重复 Token 消耗、各模型每百万 Token 价格对比表、Ollama 本地模型 0 成本方案,以及监控 Token 用量的 Dashboard 和日志方法。2026/3/25实战OpenClaw 与 Claude Code 协同使用实战:AI 聊天助手 + AI 编程助手的终极组合OpenClaw 与 Claude Code 协同使用的完整实战指南:两款工具的定位差异(OpenClaw=聊天AI助手框架,Claude Code=代码库直接操作的编程工具)、在 OpenClaw 中通过 exec 工具调用 Claude Code CLI(claude 命令)执行编程任务、把 OpenClaw 的 Telegram 消息转化为 Claude Code 任务(用自然语言描述→Claude Code执行→返回结果)、使用 OpenClaw Cron 定期触发 Claude Code 执行代码审查/依赖更新/测试/文档生成、CRS 代理在两者中的统一接入方案,以及常见的协同架构模式(主动触发/被动响应/定时执行)。2026/3/24