Openclaw（Moltbot / Clawdbot）是什么？ 作为初学者如何使用它？

人工智能的格局正迅速从被动回答问题的“聊天机器人”转向主动执行任务的“代理”。这场变革的前沿是 Clawdbot（常以龙虾表情 🦞 风格化呈现），一款席卷开发者社区的开源工具。不同于局限在浏览器标签页中的传统 AI 工具，Clawdbot 作为本地部署的操作者，常驻你的消息应用，并控制你的电脑以执行真实世界的工作流。

本指南将深入介绍 Clawdbot，涵盖其架构、安装、配置与高级用法，帮助你提升日常生产力。

它与聊天机器人有何不同？

不同于单会话的聊天机器人，Clawdbot 被构建为持久且程序化：它存储长期状态，选择性加载技能，在你机器上执行脚本（需已配置权限），并在被日程、Webhook 或消息触发时按设计自主行动。这一设计开启了全新的工作流，同时也更需要完善的运维控制与恰当的隔离。

什么是 Clawdbot，它为何正在革新 AI 助理？

Clawdbot 是一个开源、优先本地的 AI 自动化框架，旨在充当“私有执行助手”，而非仅仅是一个对话者。尽管像 ChatGPT 或标准 Claude 这样的工具允许你与 AI 聊天，它们通常处于“沙盒化”环境——这意味着除非在特定且受限的环境中，它们无法触碰你的文件、管理你的本地网络或在你的机器上执行代码。

核心理念：“重执行胜过对话”

Clawdbot 架起了高层次推理（由 Anthropic 的 Claude 3.5 Sonnet 或本地 Ollama 模型等大型语言模型提供）与底层系统操作之间的桥梁。它以守护进程（后台服务）的形式在你的硬件上运行——常见于 Mac Mini、Raspberry Pi 或本地服务器——并连接你偏好的消息平台，如 Telegram、WhatsApp、Discord 或 Slack。

关键差异点

1. 本地主权： Clawdbot 在你的基础设施上运行。你的数据、记忆与日志存储在本地，通常使用简单的 Markdown 格式，确保你对数字足迹拥有所有权。
2. 代理式行为： 它不只是等待提示。Clawdbot 可以被配置为主动——向你发送晨间简报、监控服务器状态、或在无需你发起对话的情况下提醒截止日期。
3. 通用接口： 它无需专用应用，而是在你已有的场景中与你相遇。你在与朋友的同一 WhatsApp 或 Telegram 会话中给你的 AI 助手发消息即可。

Clawdbot 的核心功能有哪些？

Clawdbot 拥有大量功能，服务于高级用户、开发者与生产力爱好者。

1. 多平台连接

Clawdbot 充当一个能通过多个“出口”说话的中央大脑。它支持广泛的消息协议，让你可在设备间无缝切换。

• 支持的平台： Telegram、WhatsApp、Discord、Slack、Signal 和 iMessage。
• 统一上下文： 若配置共享相同的记忆上下文，在 Telegram 开始的对话可在之后通过 Slack 引用。

2. 深度系统集成

不同于云端代理，Clawdbot 拥有（经许可的）本地环境访问能力。

• 文件系统访问： 它可在你的硬盘上读取、写入与整理文件。
• Shell 执行： 它可运行终端命令（如 git pull、npm install、系统更新）。
• 浏览器控制： 它可自动化网页交互，如填写表单或抓取数据。

3. 自我进化与动态技能

Clawdbot 最具未来感的功能之一是其“自我改进”能力。你可以指示它为自己编写新的“技能”或插件。例如，若你希望它查询天气但缺少天气插件，你可以让它编写一个查询天气 API 的 Python 或 Node.js 脚本，并立即集成该能力。

4. 长期记忆

Clawdbot 采用持久化记忆架构。它通过在本地文件中存储交互历史与用户偏好，构建某种“知识图谱”。这意味着它会记住你偏好 Python 而非 JavaScript，或你的会议通常在每周二，而无需在每次会话中提醒。

Clawdbot 如何工作？

架构概览

从高层看，Clawdbot 有三个交互层：

1. 网关 / 控制平面： 一个面向网络的服务，将来自聊天平台的消息路由到你的代理实例，并管理认证与配置。
2. 代理（助手）运行时： 维护状态、执行技能、与 LLM（本地或云端）对话并执行操作的进程。
3. 通道与技能： 消息通道的连接器（WhatsApp、Telegram、iMessage、Slack、Discord 等）与实现具体能力的技能插件（发送邮件、管理日历、GitHub 操作、家庭自动化）。

典型交互流程

1. 一条消息在某个通道到达（例如你在 Telegram 上向 Clawdbot 发消息）。
2. 网关完成认证并将消息转发给代理。
3. 代理处理消息（可选使用 LLM 或规则引擎），决定是响应还是执行某个动作（如发送邮件或触发脚本），然后回复或触发已配置的集成。
4. 代理记录该动作，并在任务完成或需要后续跟进时主动通知你。

LLM 与工具集成

Clawdbot 与模型无关：它将提示与工具调用请求发送到你在 .env 中配置的任意 LLM API（OpenAI、Anthropic、Google 等）。代理的推理与步骤规划来自 LLM 的响应，但代理会在本地或通过已配置的 API 执行具体步骤（例如调用你的 SMTP 服务器、调用 shell 脚本或调用云端 API）。由于“头脑”是外部 LLM，而执行平面驻留在你的设备上，操作者必须谨慎管理 API 密钥与本地权限边界。

如何安装和配置 Clawdbot？

安装需要对命令行（Terminal）有基本熟悉。

推荐在可 24/7 运行的机器上进行设置，如 Mac Mini 或 Raspberry Pi 5。

先决条件

• Node.js： 版本 18 或更高。
• API Key： Anthropic API 密钥（若使用 Claude）或 OpenAI 密钥。
• 消息机器人令牌： 例如从 @BotFather 获取 Telegram Bot Token。

步骤 1：通过 NPM 安装

使用 npm（Node 包管理器）是安装 Clawdbot 的最简单方式。

bash

# [...](asc_slot://start-slot-41)Open your terminal and run:
npm install -g clawdbot@latest

# Verify installation
clawdbot --version

步骤 2：引导式向导

Clawdbot 内置交互式向导，用于简化复杂的配置流程。

bash
clawdbot onboard --install-daemon

在引导过程中，你将被询问：

1. 网关模式： 个人使用选择 Local。
2. 认证： 输入你的 Anthropic 或 OpenAI API Key。
3. 模型选择： 选择 Claude 3.5 Sonnet，以获得速度与能力的良好平衡。
4. 通道设置： 选择你的主要聊天应用（如 Telegram）。你需要在此粘贴 Bot Token。
5. 守护进程设置： 选择 yes 可确保计算机重启时 Clawdbot 自动重启。

步骤 3：手动配置（可选）

对于高级用户，你可以直接编辑配置文件，通常位于 ~/.clawdbot/clawdbot.json。

示例配置（clawdbot.json）：

JSON

{
  "system": {
    "timezone": "America/New_York",
    "name": "Jarvis"
  },
  "llm": {
    "provider": "anthropic",
    "model": "claude-3-5-sonnet-20240620",
    "apiKey": "sk-ant-..."
  },
  "channels": {
    "telegram": {
      "enabled": true,
      "token": "123456789:ABCdefGHIjklMNOpqrsTUVwxyz",
      "allowedUsers": ["your_telegram_username"]
    },
    "whatsapp": {
      "enabled": false
    }
  },
  "permissions": {
    "fileSystem": true,
    "shell": true,
    "browser": false
  }
}

步骤 4：启动网关

如果你没有安装守护进程，可以手动启动机器人：

bash

clawdbot gateway --port 18789 --verbose

启动后，你应能看到日志显示已成功连接到你的消息平台。

如何通过最佳实践掌握 ClawdBot AI？

安装完成后，与 Clawdbot 交互就像发送一条短信一样简单。不过，为了在保证安全的同时最大化收益，请遵循以下指南。

基本用法命令

你可以用自然语言与 Clawdbot 交流，但理解其能力有助于更好地使用。

什么是简单的“技能”，我该如何编写？

一个 Clawdbot 技能是一个文件夹，包含一个带 YAML 前置字段的 SKILL.md 文件（元数据：name、description、triggers）以及描述流程的正文，外加可选的 scripts/ 执行具体工作。这种模式与 AgentSkills 兼容，类似 Claude/Agent 的技能模式。以下是一个概述发送模板邮件的最小技能示例（示意性质——请根据你的环境调整脚本）：

目录

my-email-skill/
  SKILL.md
  scripts/
    send_email.py

SKILL.md

---
name: send-email
description: Send a templated email from the local SMTP server.
triggers:
  - "send an email"
  - "email to"
---

# Send Email Skill

When the user asks to send an email, gather `to`, `subject`, and `body`.
Run `scripts/send_email.py` with these args and report result.

scripts/send_email.py（Python，最小）

#!/usr/bin/env python3
import sys, smtplib
from email.message import EmailMessage

to = sys.argv[1]
subject = sys.argv[2]
body = sys.argv[3]

msg = EmailMessage()
msg["From"] = "you@example.com"
msg["To"] = to
msg["Subject"] = subject
msg.set_content(body)

# NOTE: configure SMTP credentials beforehand in a secure store
with smtplib.SMTP("localhost") as s:
    s.send_message(msg)
print("sent")

当代理判断需要该技能时，Clawdbot 会调用脚本。技能可以更为先进（运行测试、调用远程 API、操作文件等）。公共技能注册库（ClawdHub）包含许多社区技能可供查看。

安全最佳实践

赋予 AI 访问你计算机 Shell 的能力存在风险。

1. 限制权限： 在 clawdbot.json 中，如果不严格需要终端访问，请设置 shell: false。仅在执行开发任务时启用。
2. 沙箱化： 当让 Clawdbot 编写代码时，要求它先输出代码供你审阅，而不是盲目执行（“写一个删除旧文件的脚本，但先把代码给我看”）。
3. 网络隔离： 如果在服务器上运行，使用防火墙限制来自本地主机或可信 IP 的入站流量到网关端口。
4. 使用“Loopback”模式： 确保网关绑定到 127.0.0.1（localhost），避免暴露到公网上，除非你使用 Cloudflare Tunnel 或 Tailscale 等安全隧道。

成本优化

上下文管理： Clawdbot 会将会话历史发送给 LLM。定期清理上下文（通常是类似 /clear 的命令，或“Forget previous context”）以避免令牌使用膨胀。

模型选择： 简单任务（摘要、分类）使用 “Haiku” 或 “Flash”，复杂编码或推理任务使用 “Opus” 或 “Sonnet”。

CometAPI API 如何帮助 Clawdbot？

Clawdbot 通过利用 CometAPI 的兼容 OpenAI 的端点来连接 CometAPI。由于 Clawdbot 允许你定义自定义 LLM（大型语言模型）提供商，你可以有效地将默认的“头脑”（如 Anthropic 或 OpenAI）替换为 CometAPI。

这一连接将 Clawdbot 从单模型助手转变为多模型的强大工具，使其能够访问 CometAPI 汇聚的 500+ 模型。

换言之：

Clawdbot 将 CometAPI 视为一个 LLM 提供商端点，就像 OpenAI 或 Anthropic 一样。

CometAPI 充当统一的 LLM 网关，而 Clawdbot 充当代理运行时，将提示、工具调用与推理请求发送到该网关。

Clawdbot 技术上如何连接 CometAPI？

Clawdbot 使用环境变量来配置其 LLM 后端。要连接 CometAPI，你需要配置：

1. API 基础 URL
2. API 密钥
3. 模型名称（映射到 CometAPI 支持的模型）

示例 .env 配置

# Tell Clawdbot to use an OpenAI-compatible provider
LLM_PROVIDER=openai

# CometAPI endpoint
OPENAI_API_BASE=https://api.cometapi.com/v1

# Your CometAPI key
OPENAI_API_KEY=cmpt-xxxxxxxxxxxxxxxx

# Model routed by CometAPI
OPENAI_MODEL=gpt-4o-mini

由于 CometAPI 遵循 OpenAI 兼容的模式，无需在 Clawdbot 内进行代码更改。代理只需将请求发送至 CometAPI 而非 OpenAI。

为什么选择 Clawdbot + CometAPI

Clawdbot + CometAPI 是天然契合的组合：

• Clawdbot 提供代理、技能、记忆与执行
• CometAPI 提供LLM 抽象、路由、可靠性与成本控制

两者共同组成可用于生产的自主 AI 堆栈：

Clawdbot 负责思考与行动——CometAPI 负责决定使用哪颗“大脑”。

总结表

Clawdbot 的 5 大典型用例？

当在应用之间切换上下文消耗生产力时，Clawdbot 大放异彩。

1. “DevOps” 助手

开发者无需离开 Slack 或 Discord 即可管理部署。

• 场景： 你在吃晚饭时收到服务器警报。
• 动作： 你给 Clawdbot 发消息：“检查生产服务器上 Nginx 服务的日志。”
• 结果： Clawdbot（若已配置）通过 SSH 登入服务器，运行 tail -f /var/log/nginx/error.log，并将最后 20 行粘贴到你的聊天中。

2. 智能邮件分拣

将 Clawdbot 连接到你的 Gmail API。

• 场景： 你有 500 封未读邮件。
• 动作： “扫描我的收件箱，查找来自‘Client X’的紧急邮件，并总结任何行动项。”
• 结果： 它解析你收件箱的 JSON/XML，按发件人过滤，读取正文，并向你发送任务的项目清单。

3. 个人学习与研究

Clawdbot 可作为构建知识库的研究伙伴。

• 场景： 你在学习 Rust。
• 动作： “为 Rust 制定一个学习计划。每天早上 8 点给我发送一个小型编码练习。”
• 结果： 它设置 cron 任务（主动自动化），每天向你发送其检索或生成的内容。

4. 智能家居编排器

通过集成 Home Assistant API，Clawdbot 成为你家的自然语言接口。

• 场景： “我正在回家。”
• 动作： Clawdbot 触发脚本将恒温器设置为 72°F，并打开客厅灯。

5. 自动化内容创作

对于内容创作者（如 CometAPI 用户），Clawdbot 可简化草稿流程。

• 场景： “监控 TechCrunch 关于‘LLM 定价’的新闻。如果出现新文章，草拟一篇 500 字的 Markdown 格式博客。”
• 结果： 它充当 24/7 的新闻观察者与撰稿助手，节省大量人工检查时间。

结论

Clawdbot 在个人 AI 计算领域实现了重大飞跃。通过将 AI 从浏览器解耦，并嵌入操作系统与消息层，它赋能用户自动化繁琐事务、专注于创造性工作。尽管需要技术化的设置与对安全的审慎态度，但拥有一个 24/7、主动且具备上下文意识的助手带来的生产力提升，在当前市场中无与伦比。

无论你是希望自动化 git 工作流的开发者，还是管理复杂数字生活的高级用户，Clawdbot 都提供了构建终极数字助手的框架。

如果你需要一个拥有多家厂商模型（如 OpenAI、Chatgpt、Claude 等）且定价低于官方的 API 平台，那么 CometAPI 是最佳选择。开始之前，请在 Playground 探索模型能力，并查阅 API 指南 获取详细说明。访问前，请确保你已登录 CometAPI 并获取 API Key。CometAPI 提供远低于官方价格的方案，帮助你集成。

准备好开始了吗？→ 立即注册 CometAPI！

如果你想了解更多 AI 的技巧、指南与新闻，请关注我们的 VK、X 和 Discord！