跳到主要内容

Clawdbot保姆级教程

· 阅读需 4 分钟
Goose Soaring
Goose Soaring
Docusaurus maintainer

一、安全警告⚠️​

强烈建议使用备用机或虚拟机部署！

  • 该工具拥有极高系统权限
  • 可能误删重要文件或执行危险操作
  • 不要在主电脑上直接部署
  • 建议使用：新电脑、虚拟机或云服务器

二、基础环境准备​

1. 安装Node.js​

  • 版本要求：v22.0.0 或更高
  • 下载地址：https://nodejs.org/
  • 安装后验证：node --version

2. 系统要求​

  • Windows 10/11
  • macOS 10.15+
  • Linux (Ubuntu/Debian等)

三、安装Clawdbot​

Windows系统安装：​

iwr -useb https://molt.bot/install.ps1 | iex

macOS/Linux系统安装：​

curl -fsSL https://molt.bot/install.sh | bash -s -- --install-method git

四、初始配置流程​

1. 启动配置​

安装完成后按提示操作：

Do you want to continue? [yes/no] → 输入 yes

选择配置方式：
1. Quick start (recommended) → 选择此项
2. Manual configuration

2. API配置​

选择AI模型服务商：

  • OpenAI GPT/Codex（推荐，但需要API额度）
  • Claude（注意：可能被封号）
  • 国产模型：MiniMax、智谱GLM、通义千问等

重要提醒：

  • 避免使用Claude Max额度，可能导致封号
  • 该工具消耗Token极快，注意监控使用量

3. 通信渠道配置​

跳过海外聊天软件，选择：

Skip channel setup for now

4. 技能安装​

Install skills? [yes/no] → 输入 yes
选择包管理器：npm (推荐)

5. 插件配置​

建议开启以下三个hooks：

  • boot-md：启动时加载自定义引导内容
  • command-logger：记录操作日志
  • session-memory：保存会话记忆

五、启动Clawdbot​

1. 启动命令​

clawdbot gateway --verbose

2. 访问Web界面​

六、飞书集成配置（国内用户推荐）​

1. 安装飞书插件​

在Clawdbot Web界面中输入：

给我安装Clawdbot plugins install @m1heng-clawd/feishu

2. 创建飞书应用​

  1. 访问飞书开放平台：https://open.feishu.cn
  2. 创建企业自建应用
  3. 获取并保存：
    • App ID
    • App Secret

3. 配置飞书插件​

在Clawdbot对话框中输入：

我的App ID是：[你的App ID]，App Secret是：[你的App Secret]

Clawdbot会自动完成剩余配置

4. 飞书应用设置​

在开放平台配置：

  1. 权限管理开启：

    • 获取用户userID
    • 以应用身份读取通讯录
    • 获取用户邮箱信息
    • 获取用户手机号
    • 获取用户基本信息
    • 获取用户头像
    • 用户发送消息

  2. 事件订阅添加：

    • im.message.receive_v1

  3. 安全设置添加：

    • IP白名单（如果需要）

  4. 版本管理与发布：

    • 创建版本
    • 申请发布

七、使用技巧与注意事项​

1. 成本控制​

  • 监控API使用量（消耗极快）
  • 考虑使用国产模型降低成本
  • 设置使用额度限制

2. 安全建议​

  • 限制文件访问范围
  • 定期备份重要数据
  • 监控操作日志
  • 避免赋予过高权限

3. 实用技能​

  • 文件处理：自动整理、转换格式
  • 数据录入：Excel自动填充
  • 邮件处理：自动分类、回复
  • 日常任务：定时提醒、信息整理

八、故障排除​

常见问题：​

  1. 安装失败：检查Node.js版本和网络
  2. API错误：检查API密钥和额度
  3. 飞书连接失败：检查权限配置和网络

获取帮助：​

九、总结​

Clawdbot代表了AI Agent发展的一个重要方向，但安全永远是第一位的。在享受自动化便利的同时，务必：

  1. 隔离环境：使用专用设备或虚拟机
  2. 权限最小化：只开放必要的访问权限
  3. 持续监控：定期检查操作日志
  4. 备份重要数据：防止意外损失

记住：你交给AI的不仅是任务，还有系统的控制权。在追求效率的同时，保持必要的警惕和理性。

moltbot记忆卡

· 阅读需 2 分钟
Goose Soaring
Goose Soaring
Docusaurus maintainer

moltbot-clawd AI智能体配置文件总览​

文件名核心作用类比关键内容示例
IDENTITY.md核心身份定义“身份证”姓名 (moltbot)、核心职责（如“全栈开发助手”）、性格特质（严谨/幽默）、沟通风格、目标。
SOUL.md内在原则与价值观“道德宪法”道德准则（无害、诚实）、决策框架、核心信念、行为边界与禁忌。
USER.md用户模型“用户画像”目标用户身份（如“开发者”）、用户目标、偏好、工作流背景、期望的交互模式。
TOOLS.md能力与工具箱“技能手册”可调用的工具列表（代码解释器、搜索API、文件读写）、使用规范、权限说明。
AGENTS.md多智能体协作“协作网络”可协作的其他智能体、角色分工、任务传递协议、通信规则（如用于复杂任务分解）。
BOOTSTRAP.md初始化与启动流程“启动脚本”启动步骤、环境检查、依赖加载、初始状态设置、配置文件加载顺序。
HEARTBEAT.md状态维持与活跃机制“生命体征”定期自检任务、状态更新/同步机制、记忆维护策略、存活确认信号。
README项目总览与指南“使用说明书”项目简介、快速入门、核心功能、配置与运行方法、贡献指南。

文件关系与信息流​

核心逻辑：

  1. 智能体（moltbot）基于 身份（IDENTITY）和 原则（SOUL）形成核心人格。
  2. 根据 用户画像（USER）调整其行为和服务方式。
  3. 通过 启动流程（BOOTSTRAP）初始化，并依靠 心跳机制（HEARTBEAT）保持状态。
  4. 在执行任务时，调用 工具（TOOLS）或与其他 智能体（AGENTS）协作。
  5. 所有文件通过 README 提供总入口和指引。

项目本质总结​

moltbot-clawd 是一个模块化、人格化AI智能体的“源代码”。它不记录硬件数据或运行日志，而是定义了一个AI代理（moltbot）是谁、如何思考、为谁服务以及能做什么。这是一个用于构建和配置高级别AI助手的框架性项目。