Clawdbot初次使用需完成五步配置：一、运行clawdbot onboard执行初始化向导并确认许可；二、配置LLM后端，绑定API Key与模型名并设为默认；三、安装Telegram插件、写入Bot Token并启用通道；四、安装守护进程并启动服务，验证健康状态；五、Telegram私聊触发配对，执行clawdbot pair并发送/status测试。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已成功安装 Clawdbot，但尚未完成初始配置，无法启动服务或接入聊天平台，则可能是由于基础参数未设置、模型未绑定或通道未启用。以下是完成 Clawdbot 初次使用所需的基础功能配置步骤：
一、执行初始化向导并完成安全确认
clawdbot onboard 命令是首次运行的必经流程，它将引导您完成许可证确认、运行模式选择及核心参数生成，确保服务具备基本运行条件。
1、在终端中输入命令：clawdbot onboard
2、当出现“Do you agree to the disclaimer?”提示时，输入 Yes 并回车
3、在“Select onboarding mode”选项中，选择 QuickStart 模式以跳过高级定制，快速进入基础配置
4、等待配置文件 .clawdbot/config.yaml 自动生成并写入默认路径
二、配置基础大语言模型（LLM）后端
Clawdbot 必须连接至少一个可用的大模型 API 才能响应指令，模型配置直接决定其理解与生成能力，未配置将导致服务启动失败或返回空响应。
1、根据所选模型类型（如 Moonshot、Qwen、GLM 或 Claude），获取对应平台的 API Key
2、执行命令绑定模型密钥（以 Moonshot 为例）：clawdbot config set llm.moonshot.apiKey "sk-xxxxxxxx"
3、设置模型名称（必须与支持列表一致）：clawdbot config set llm.moonshot.model "moonshot-v1-8k"
4、启用该模型作为默认后端：clawdbot config set llm.default "moonshot"
三、启用并配置首个消息通道（以 Telegram 为例）
Clawdbot 默认不激活任何通信通道，需手动安装插件并注入凭证，否则无法接收或发送消息。Telegram 是新手最易上手的入门通道。
1、安装 Telegram 插件：clawdbot plugins install @clawdbot/telegram
2、获取 Telegram Bot Token：前往 https://t.me/BotFather 创建新 Bot，并保存返回的 Token 字符串
为Claude Code提供对提醒事项、日历、联系人、笔记、邮件和tmux的本地命令访问权限，以便在macOS上进行工作流感知的个人操作。
3、写入 Token 配置：clawdbot config set channels.telegram.token "1234567890:ABCdefGhIjKlmNoPqrStUvWxYz"
4、启用 Telegram 通道：clawdbot config set channels.telegram.enabled true
四、安装守护进程并启动服务
为保障 Clawdbot 7×24 小时持续运行，需将其注册为系统级守护进程；若仅前台运行，关闭终端即中断服务。
1、执行安装命令：clawdbot onboard --install-daemon
2、检查守护进程状态：systemctl --user status clawdbot（Linux）或 brew services list | grep clawdbot（macOS）
3、若状态为 inactive，手动启动：systemctl --user start clawdbot
4、验证服务健康状况：clawdbot doctor，确认输出中无 ERROR 级别问题
五、完成配对验证并测试首条指令
部分通道（如 Telegram、Discord）要求用户与 Bot 进行一次私聊触发配对流程，以建立唯一会话标识，否则 Bot 不响应群组或非私聊消息。
1、在 Telegram 中搜索并私聊您创建的 Bot，发送任意消息（如“hello”）
2、观察终端日志，查找形如 Pairing code: abc123def456 的字符串
3、立即执行配对命令：clawdbot pair --code abc123def456
4、返回 Telegram 私聊窗口，发送指令 /status，确认收到包含运行时信息的结构化回复
