OpenClaw 安装配置实战：把 AI 助手部署到你自己的服务器

字数：约3500字 | 阅读时间：10分钟
“与其把数据交给别人的平台，不如自己跑一个。”

OpenClaw 是什么？

OpenClaw 是一个本地优先的个人 AI 助手平台。它不是某个大厂的 SaaS 产品，而是一个你可以在自己服务器上运行的独立系统。

核心能力：

  • 多渠道接入：微信、Telegram、Discord、Signal、Slack、QQ 等，你常用的聊天工具都能接
  • 持久化记忆：不像 ChatGPT 每次对话都是新的，OpenClaw 有完整的记忆系统，能记住你的偏好和上下文
  • Skill 热插拔：像装插件一样扩展能力——天气查询、GitHub 操作、浏览器自动化、PDF 生成，社区有大量现成的 Skill
  • 多 Agent 协作：可以跑多个 AI Agent，比如一个管工作、一个管生活，各司其职
  • 本地执行：Shell 命令、文件操作、定时任务，都在你自己的机器上跑，数据不出本地

GitHub 68K+ stars，社区活跃。创始人 Peter Steinberger（PSPDFKit 创始人）。

一句话：OpenClaw 让你拥有一个”住在自己服务器上的私人 AI 助手”。

服务器要求

OpenClaw 对硬件要求不高，关键是网络和存储。

最低配置：

项目 要求
CPU 2 核
内存 2GB
硬盘 20GB SSD
系统 Ubuntu 22.04+ / Debian 12+ / macOS
网络 需要访问 LLM API（OpenAI/智谱等）
Node.js v20+

推荐配置（长期运行）：

项目 推荐
CPU 4 核
内存 4GB
硬盘 40GB SSD
系统 Ubuntu 24.04 LTS

腾讯云轻量应用服务器 2C2G（约 50 元/月）就够跑 OpenClaw + 微信接入。

安装

方式一：一键安装脚本（推荐）

1
curl -fsSL https://get.openclaw.ai | bash

自动完成：安装 Node.js 依赖 → 下载 OpenClaw → 初始化配置 → 启动服务。

方式二：npm 全局安装

1
npm install -g openclaw@latest

国内加速：

1
npm install -g openclaw@latest --registry https://registry.npmmirror.com

方式三：Docker

1
2
3
4
5
6
7
8
docker pull ghcr.io/openclaw/openclaw:latest

docker run -d \
  --name openclaw \
  -v ~/.openclaw:/root/.openclaw \
  -p 3000:3000 \
  -e OPENAI_API_KEY="$OPENAI_API_KEY" \
  ghcr.io/openclaw/openclaw:latest

适合熟悉 Docker 的用户，方便迁移和备份。

验证安装

1
2
openclaw --version
openclaw status

初始化配置

安装完成后，运行初始化向导：

1
openclaw init

向导会引导你完成以下配置：

1. 选择 AI 模型

OpenClaw 不绑定特定模型，支持 OpenAI、Anthropic、Google Gemini、智谱 GLM、Ollama 本地模型等。

1
2
3
4
5
# 设置默认模型（以智谱 GLM 为例）
openclaw config set model glmcode/glm-5-turbo

# 设置 API Key
openclaw config set apiKey "your-zhipuai-key"

也可以配置多个模型，按场景切换：

1
2
3
4
5
6
# 配置 OpenAI 备用
openclaw config set openai.apiKey "sk-xxx"
openclaw config set openai.baseUrl "https://api.openai.com/v1"

# 配置 Ollama 本地模型
openclaw config set ollama.baseUrl "http://localhost:11434"

2. 配置工作区

工作区是 OpenClaw 的”家”，存放配置、记忆、Skill 等文件：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
# 默认工作区
~/.openclaw/workspace/

# 核心文件结构
workspace/
├── SOUL.md          # AI 的人格定义
├── USER.md          # 用户信息
├── MEMORY.md        # 长期记忆
├── TOOLS.md         # 工具笔记
├── HEARTBEAT.md     # 心跳任务配置
├── AGENTS.md        # Agent 行为规则
├── skills/          # 技能目录
├── memory/          # 记忆目录
└── docs/            # 文档目录

SOUL.md 是最重要的一一它定义了 AI 的性格和沟通方式。比如：

1
2
3
4
5
# SOUL.md

你是一名经验丰富的架构师和得力助手。
直接务实，拒绝废话，对话保持高信息密度。
有自己的判断力，发现问题直接指出。

3. 启动 Gateway

OpenClaw 的核心是 Gateway 守护进程，负责接收消息、调度 Agent、管理连接：

1
2
openclaw gateway start
openclaw gateway status

Gateway 启动后，OpenClaw 就在后台持续运行了。

接入微信

微信接入是 OpenClaw 在国内最常用的场景。

前置准备

  1. 注册一个微信公众号（订阅号或服务号）
  2. 获取 AppID 和 AppSecret
  3. 在公众号后台配置服务器地址（你的服务器 IP）
  4. 确保服务器 80/443 端口可访问

配置微信插件

1
openclaw plugin install openclaw-weixin

编辑配置文件 ~/.openclaw/config.yaml：

1
2
3
4
5
6
7
8
plugins:
  entries:
    openclaw-weixin:
      config:
        appId: "your-app-id"
        appSecret: "your-app-secret"
        token: "your-custom-token"
        encodingAESKey: "your-aes-key"

重启 Gateway：

1
openclaw gateway restart

配置完成后，你在微信上给公众号发消息，OpenClaw 就会回复。AI 助手住进了你的微信。

微信接入注意事项

  • 服务器 IP 白名单：在微信后台把你的服务器 IP 加进去
  • 域名备案：如果用 80 端口，域名需要 ICP 备案
  • HTTPS：生产环境建议用 Caddy 或 Nginx 做 HTTPS 反代
  • 消息限制：订阅号被动回复有时间限制（5秒），复杂任务建议异步处理

接入其他渠道

除了微信，OpenClaw 还支持：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
# Telegram
openclaw plugin install telegram
# 配置 Bot Token

# Discord
openclaw plugin install discord
# 配置 Bot Token

# Signal
openclaw plugin install signal

# QQ
openclaw plugin install qqbot

# Slack
openclaw plugin install slack

每个渠道的配置方式类似，都是安装插件 → 填 Token → 重启 Gateway。

Skill 扩展

Skill 是 OpenClaw 的插件系统，用来扩展 AI 的能力。

安装 Skill

1
2
3
4
5
6
# 从 ClawHub 安装（官方市场）
openclaw skill install weather

# 从 SkillHub 安装（社区市场）
openclaw skill search "github"
openclaw skill install github

常用 Skill

Skill 功能
weather 天气查询
github GitHub 操作（issue、PR）
obsidian Obsidian 知识库管理
tmux 远程控制终端会话
agent-browser 浏览器自动化
md-to-pdf Markdown 转 PDF（支持中文）
coding-agent 调用 Claude Code/Codex 编程
video-frames 视频帧提取

创建自定义 Skill

在 workspace/skills/ 下创建目录，写一个 SKILL.md 文件即可：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
---
name: my-skill
description: 我的自定义技能
---

# My Skill

## 使用说明

当用户提到 XXX 时激活此技能。

## 执行步骤

1. 步骤一
2. 步骤二

OpenClaw 会自动识别并加载新的 Skill。

定时任务（Cron）

OpenClaw 内置定时任务系统，可以让 AI 在指定时间自动执行任务。

创建定时任务

1
2
3
4
openclaw cron create \
  --name "早间简报" \
  --schedule "0 7 * * *" \
  --prompt "检查邮件和日历，生成今日简报并发送到微信"

常用场景

  • 每日简报：早上 7 点检查邮件、日历、天气，发送摘要
  • 内容创作：每天 6:30 自动写公众号文章初稿
  • 服务器巡检：每周一 9 点检查服务器状态
  • 身份检查：每天 11 点提醒”今天的行为是在逃避还是在建造”
  • 记忆整理：每天 23:30 整理当日记忆

管理定时任务

1
2
openclaw cron list          # 查看所有任务
openclaw cron remove <id>   # 删除任务

记忆系统

OpenClaw 的记忆系统分四层：

层级 内容 管理
L0 原始对话记录 自动捕获
L1 结构化记忆 自动提取
L2 场景归纳 自动聚合
L3 用户画像 自动更新

你需要维护的是 MEMORY.md（手动核心记忆）和 SOUL.md（AI 人格）。其余由系统自动管理。

支持 Embedding 向量搜索（如智谱 embedding-3），让 AI 能语义检索历史记忆。

多 Agent 架构

你可以跑多个 Agent，各有分工：

1
2
3
4
5
6
7
# 主 Agent（你）
# 已通过 init 创建

# 子 Agent（比如给孩子用）
openclaw agent create kid --model glmcode/glm-5-turbo
openclaw agent plugin kid install openclaw-weixin
# 绑定孩子的微信

每个 Agent 有独立的记忆、人格、Skill 配置，互不干扰。

日常运维

1
2
3
4
5
6
7
8
9
10
11
12
13
14
# 查看状态
openclaw status

# 重启 Gateway
openclaw gateway restart

# 查看日志
openclaw gateway logs --tail 100

# 更新版本
npm update -g openclaw

# 备份数据
tar czf openclaw-backup-$(date +%Y%m%d).tar.gz ~/.openclaw/

建议把备份加入 crontab，每天自动执行。

安全建议

  • API Key 管理：存放在 ~/.config/ 下，权限设为 600，不要提交到 Git
  • SSH 访问：禁用密码登录，只用 Key 认证
  • 防火墙：只开放必要端口（80、443、SSH）
  • 自动更新：配置定时任务检查 OpenClaw 版本更新
  • 数据备份：定期备份 ~/.openclaw/ 目录

总结

OpenClaw 的核心价值是”数据主权”和”可定制性”。你的对话记录、记忆、配置全部在本地，不依赖任何第三方平台。通过 Skill 和 Cron，你可以把 AI 助手打造成完全贴合自己需求的工具。

从安装到接入微信，全程不超过 30 分钟。一旦跑起来，你就拥有了一个 24 小时在线、有记忆、能执行任务的私人 AI 助手。

本文基于 2026 年 4 月 OpenClaw 最新版本编写。项目地址：https://github.com/openclaw/openclaw