clawdbot本体完全免费，无订阅、激活码或隐藏收费；但调用openai等远程大模型、whatsapp企业认证、云服务器资源等第三方服务可能产生费用。
Clawdbot 本身是开源免费的本地 AI 助手工具，其核心代码、安装脚本与基础功能均不收取任何费用。但实际使用过程中，部分依赖服务可能产生第三方成本。以下是关于 Clawdbot 是否收费、安装环境要求及基础使用方式的详细说明：
一、Clawdbot 是否收费
Clawdbot 本体完全免费，无需订阅、无需激活码、无隐藏付费模块。所有命令行工具、网关服务、TUI 终端交互、插件管理功能均开放使用。但以下环节涉及外部服务，费用由对应平台承担：
1、大模型调用：若选择 OpenAI、Anthropic、Google Gemini 或阿里云百炼等远程 API，需自行申请并充值对应平台的 API Key，费用按调用量结算。
2、消息通道接入：Telegram、WhatsApp、飞书、钉钉等渠道本身免费，但 WhatsApp 需企业认证（非必需），飞书/钉钉自建应用无费用，iMessage 接入需 macOS 设备且运行在真实 Apple 环境中，不额外收费但硬件门槛存在。
3、云部署镜像：阿里云、UCloud 提供的 Moltbot（原 Clawdbot）预装镜像为免费镜像，仅收取云服务器基础资源费用（如轻量应用服务器月付68元起），非 Clawdbot 软件授权费。
二、Clawdbot 安装环境要求
Clawdbot 对运行环境有明确最低要求，不满足将导致安装失败或服务无法启动。所有组件必须满足版本约束，否则后续配置无法进行。
1、Node.js 版本必须为 v22 或更高：低于 v22 的版本（如 v18、v20）会报错“unsupported Node.js version”，执行 node -v 验证，输出必须为 v22.x.x 或 v24.x.x。
2、操作系统支持范围：macOS（Intel/Apple Silicon）、Linux（Ubuntu 22.04+/Debian 12+）、Windows（PowerShell + Windows 10/11，需开启脚本执行策略）；Windows 必须以普通用户权限运行 PowerShell，并执行 Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser。
3、内存与存储：最小推荐 2GB 内存、10GB 可用磁盘空间；若启用本地模型（如 Ollama 运行 Qwen2.5），则需至少 8GB 内存与 20GB 存储；虚拟机部署时务必分配 2 核 CPU 与 2GB 内存，否则 gateway 启动后立即崩溃。
三、Clawdbot 基础使用说明
完成安装后，Clawdbot 提供三种主要交互模式，适用于不同场景，彼此独立且可共存。每种模式启动前均需确保 clawdbot 已完成 onboard 初始化。
1、终端交互模式（TUI）：适合调试与快速测试，不依赖外部消息平台。执行 clawdbot tui 即可进入纯文本对话界面，输入 /help 查看内置指令。
请注意以下说明:1、本程序允许任何人免费使用。2、本程序采用PHP+MYSQL架构编写。并且经过ZEND加密，所以运行环境需要有ZEND引擎支持。3、需要售后服务的，请与本作者联系，联系方式见下方。4、本程序还可以与您的网站想整合，可以实现用户在线服务功能，可以让客户管理自己的信息，可以查询自己的订单状况。以及返点信息等相关客户利益的信息。这个功能可提高客户的向心度。安装方法：1、解压本系统，放在
2、网关服务模式（Gateway）：提供 HTTP API 接口，供前端、自动化脚本或自定义 UI 调用。执行 clawdbot gateway start 启动服务，默认监听 127.0.0.1:18789，需手动放通防火墙端口。
3、消息平台对接模式：将 Clawdbot 绑定至 Telegram、WhatsApp、飞书等，实现手机/桌面多端实时响应。首次配对需在对应平台获取 Bot Token 或 App ID/Secret，并通过 clawdbot config set 命令写入配置文件。
四、Clawdbot 配置文件与数据存储位置
Clawdbot 采用基于文件的持久化设计，所有配置、记忆、技能定义均落盘为明文 JSON 或 YAML 文件，便于人工审查与版本控制。默认路径因系统而异，不可硬编码引用。
1、主配置文件路径：Linux/macOS 默认为 ~/.clawd/config.json，Windows 默认为 %USERPROFILE%\.clawd\config.json；该文件包含 channels、models、skills 等顶层键。
2、记忆数据库路径：默认存储于 ~/.clawd/memory/ 目录下，每个对话生成独立 .json 文件，含时间戳、上下文摘要与操作日志。
3、工作目录（workspace）：onboard 初始化时指定，默认为 /root/clawd（Linux root 用户）或 %USERPROFILE%\clawd（Windows）；插件、自定义 hooks、临时下载文件均存放于此。
五、Clawdbot 插件安装与管理方法
Clawdbot 支持通过官方插件市场或 npm 包名安装扩展能力，所有插件均为独立模块，不影响核心稳定性。安装后需显式启用并配置参数才能生效。
1、安装飞书插件：执行 clawdbot plugins install @m1heng-clawd/feishu，安装完成后需手动设置 appId 与 appSecret。
2、安装钉钉插件：执行 clawdbot plugins install @alibaba-clawd/dingtalk，该插件由阿里云官方维护，支持百炼模型直连。
3、卸载插件：执行 clawdbot plugins uninstall @m1heng-clawd/feishu，卸载后配置项仍保留在 config.json 中，需手动删除 channels.feishu 相关字段。
