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

作者：CSDN博客
摘要：最近，一个名为 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: 版本需 >= 22API 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 的语气会立刻改变，变得更符合你设定的角色。

---

6. 总结与展望

OpenClaw 代表了 "Agentic AI"（代理式 AI） 的一个重要方向：去中心化、本地化、工具化。
它的优点：

完全掌控：没有 Token 消耗在云端聊天记录里，隐私更好。无限扩展：只要你会写脚本，它就能做任何事（部署代码、抓取网页、甚至控制智能家居）。

它的风险：

安全门槛：赋予 AI 终端权限是一把双刃剑，建议一定要在非 Root 用户或 Docker 容器中运行。

如果你是一名喜欢折腾的开发者，OpenClaw 绝对是目前最值得尝试的开源玩具之一。赶紧去 GitHub 点个 Star 试试吧！

---

参考链接：

OpenClaw GitHub: https://github.com/openclaw/openclaw (注意：请认准最新仓库，原名可能混淆)官方文档: https://docs.openclaw.aiOpenClaw交流qq群: 1078800977

原文地址：https://blog.csdn.net/qq_55109871/article/details/157653372