OpenClaw：火爆GitHub的开源“全能”AI助手，从部署到实战全指南

OpenClaw是一个开源的、本地优先（Local-First）的个人 AI 助手。它的核心理念是让 AI 不再仅仅是一个浏览器里的聊天窗口，而是一个真正拥有“手脚”的数字员工。它经历了三次改名（Clawdbot -> Moltbot -> OpenClaw），目前已成为开源社区最热门的 Agent 框架之一。这是 OpenClaw 最强大的地方。你可以给它编写“技能”，让它具备特定能力。技能通常

qq_55109871

481人浏览 · 2026-02-02 16:45:22

qq_55109871 · 2026-02-02 16:45:22 发布

摘要：最近，一个名为 OpenClaw（曾用名 Clawdbot/Moltbot）的项目在 GitHub 上迅速走红。与传统的网页版 AI 不同，OpenClaw 是一个运行在你本地设备上的“主动式”AI 代理，能够接管你的微信（通过 workaround）、Telegram、Discord，甚至直接操作你的文件系统和终端。本文将带你深入了解 OpenClaw 的核心功能，手把手教你如何部署，并编写一个自定义技能。

1. 什么是 OpenClaw？

OpenClaw 是一个开源的、本地优先（Local-First）的个人 AI 助手。它的核心理念是让 AI 不再仅仅是一个浏览器里的聊天窗口，而是一个真正拥有“手脚”的数字员工。

它经历了三次改名（Clawdbot -> Moltbot -> OpenClaw），目前已成为开源社区最热门的 Agent 框架之一。

核心特性：

多平台聚合：它像一个网关，连接你的 AI 模型（Claude, GPT-4, DeepSeek 等）和你常用的通讯软件（WhatsApp, Telegram, Discord, Slack 等）。
持久化记忆（Persistent Memory）：它不会像 ChatGPT 那样关闭窗口就“失忆”。OpenClaw 会将对话上下文和重要信息以 Markdown 格式存储在本地，拥有长期记忆。
主动性（Proactive）：它支持 Cron 定时任务，可以主动给你发消息（例如：每天早上 8 点汇报服务器状态，或提醒你喝水）。
本地运行：代码运行在你自己的机器上（Mac Mini, 树莓派, VPS），数据隐私掌握在自己手中。
强大的技能系统（Skills）：通过编写脚本，它可以执行终端命令、读写文件、甚至控制浏览器。

2. 快速部署指南

OpenClaw 基于 Node.js 开发，建议使用 Docker 或 Node 环境直接运行。

前置要求

Node.js: 版本需 >= 22
API Key: 推荐使用 Anthropic (Claude) 或 OpenAI 格式的 Key（支持 OpenRouter/DeepSeek）。
操作系统: macOS / Linux / Windows (推荐使用 WSL2)

方式一：NPM 一键安装（最快）

打开终端，运行以下命令安装 CLI 工具：

<BASH>

npm install -g openclaw@latest

安装完成后，启动配置向导：

<BASH>

openclaw onboard --install-daemon

这个向导会引导你完成以下步骤：

选择 AI 提供商（如 Anthropic, OpenAI, 或兼容接口）。
输入 API Key。
配置默认网关（Gateway）端口（默认为 18789）。
选择要连接的聊天平台（推荐先从 Telegram 或 Discord 开始，配置最简单）。

方式二：Docker 部署（推荐，更安全）

由于 OpenClaw 具有执行系统命令的能力，使用 Docker 进行隔离是最佳实践。

创建 docker-compose.yml 文件：

<YAML>

version: '3.8'

services:

openclaw:

image: ghcr.io/openclaw/openclaw:latest

container_name: openclaw

restart: always

environment:

- ANTHROPIC_API_KEY=sk-ant-api03... # 替换你的 Key

# 或者使用 OpenAI 格式

# - OPENAI_API_KEY=sk-...

# - OPENAI_BASE_URL=https://api.deepseek.com # 示例：使用 DeepSeek

volumes:

- ./data:/root/.openclaw # 持久化数据挂载

ports:

- "18789:18789"

启动服务：
<BASH>

docker-compose up -d

3. 连接你的第一个聊天平台（以 Telegram 为例）

OpenClaw 启动后，你需要让它连接到一个聊天界面。

创建 Bot：在 Telegram 中搜索 @BotFather，发送 /newbot，获取 Bot Token。
添加 Provider：如果你是 Docker 部署，进入容器或使用 CLI 连接：
<BASH>

# 假设你已经安装了 CLI 工具

openclaw providers add --provider telegram --token "你的_TELEGRAM_BOT_TOKEN"
开始对话：在 Telegram 中找到你的 Bot，发送 Hello。 注意：出于安全考虑，首次对话可能需要进行“配对（Pairing）”验证，OpenClaw 会在终端输出一个验证码，你需要确认后才能继续。

4. 进阶玩法：自定义技能 (Custom Skills)

这是 OpenClaw 最强大的地方。你可以给它编写“技能”，让它具备特定能力。技能通常存放在 ~/.openclaw/skills/ 目录下。

技能结构

一个标准的技能包包含一个 SKILL.md（定义元数据）和具体的执行脚本（TS/JS/Python/Shell）。

实战：写一个“服务器健康检查”技能

假设我们要让 OpenClaw 能随时检查当前服务器的磁盘使用率。

步骤 1：创建目录

<BASH>

mkdir -p ~/.openclaw/skills/system-check

步骤 2：创建 SKILL.md

<MARKDOWN>

---

name: check_disk_usage

description: Check the current disk usage of the server.

usage: "check disk space", "disk usage", "server status"

---

# Disk Usage Checker

This skill executes a shell command to check disk usage.

## Tools

### get_disk_usage

- **Description**: Returns the output of `df -h`

- **Command**: `df -h`

步骤 3：热重载 OpenClaw 通常会自动检测技能目录的变化。

步骤 4：测试 在 Telegram 里对你的 Bot 说：“Check disk usage please.” Bot 会识别意图，调用 df -h 命令，读取返回结果，并用自然语言回答你：“Currently, the disk usage is normal. The root partition has 40% free space...”

⚠️ 安全警告：OpenClaw 的技能可以直接在宿主机执行命令。在编写或安装第三方技能时，请务必检查代码，防止 rm -rf 等恶意操作。

5. 个性化配置：赋予灵魂 (Soul)

OpenClaw 允许你通过修改 soul.md 文件来定义 AI 的人设。

文件位置通常在 ~/.openclaw/soul.md。

<MARKDOWN>

# Identity

You are JARVIS, a helpful and slightly sarcastic AI assistant running on a Linux server.

# Behaviors

- Be concise.

- If the user asks for code, provide only the code block unless explanation is requested.

- You love coffee emojis ☕.

修改后，Bot 的语气会立刻改变，变得更符合你设定的角色。