AI创想

标题: OpenClaw：火爆GitHub的开源“全能”AI助手，从部署到实战全指南 [打印本页]

作者: 创想小编 时间: 7 小时前
标题: 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 框架之一。
核心特性：

多平台聚合

持久化记忆（Persistent Memory）

主动性（Proactive）

本地运行

强大的技能系统（Skills）

2. 快速部署指南

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

Node.js

API Key

操作系统

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

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

<BASH>
npm install -g openclaw@latest

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

<BASH>
openclaw onboard --install-daemon

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

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

Bot Token

添加 Provider

<BASH>
# 假设你已经安装了 CLI 工具
openclaw providers add --provider telegram --token "你的_TELEGRAM_BOT_TOKEN"

开始对话

注意：出于安全考虑，首次对话可能需要进行“配对（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） 的一个重要方向：去中心化、本地化、工具化。
它的优点：

完全掌控

无限扩展

它的风险：

安全门槛

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

参考链接：

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

欢迎光临 AI创想 (http://www.llms-ai.com/)