# 🦞 ClawdBot 一键部署工具 > 🚀 一键部署你的私人 AI 助手 ClawdBot，支持多平台多模型配置 **Published by:** [链求君精选推荐](https://paragraph.com/@acc/) **Published on:** 2026-01-30 **URL:** https://paragraph.com/@acc/clawbot-depoly ## Content 🔗 https://github.com/miaoxworld/ClawdBotInstaller 📖 目录功能特性系统要求快速开始详细配置常用命令配置说明安全建议常见问题更新日志✨ 功能特性🤖 多模型支持 主流服务商:Anthropic Claude - Claude Opus 4 / Sonnet 4 / Haiku (支持自定义 API 地址)OpenAI GPT - GPT-4o / GPT-4 Turbo / o1 (支持自定义 API 地址)Google Gemini - Gemini 2.0 Flash / 1.5 ProxAI Grok - Grok 4 / Grok 3 / Grok 2 Vision (Elon Musk 的 AI)多模型网关:OpenRouter - 多模型网关，一个 Key 用遍所有模型OpenCode - 免费多模型 API，支持 Claude/GPT/Gemini/GLM快速推理:Groq - 超快推理，Llama 3.3 / MixtralMistral AI - Mistral Large / Codestral本地/企业:Ollama - 本地部署，无需 API KeyAzure OpenAI - 企业级 Azure 部署国产模型:智谱 GLM (Zai) - GLM-4.7 / GLM-4.6 (中国领先 AI)MiniMax - MiniMax-M2 系列 (支持国内/国际版)实验性:Google Gemini CLI - Gemini 3 预览版Google Antigravity - Google 实验性多模型 API💡 自定义 API 地址: Anthropic Claude 和 OpenAI GPT 都支持自定义 API 地址，可接入 OneAPI/NewAPI/API 代理等服务。配置时先输入自定义地址，再输入 API Key。📱 多渠道接入 Telegram BotDiscord BotWhatsAppSlack微信 (WeChat)iMessage (仅 macOS)飞书 (Feishu)🧪 快速测试 API 连接测试渠道连接验证ClawdBot 诊断工具🧠 核心能力持久记忆 - 跨对话、跨平台的长期记忆主动推送 - 定时提醒、晨报、告警通知技能系统 - 通过 Markdown 文件定义自定义能力远程控制 - 可执行系统命令、读写文件、浏览网络💻 系统要求项目要求操作系统macOS 12+ / Ubuntu 20.04+ / Debian 11+ / CentOS 8+Node.jsv22 或更高版本内存最低 2GB，推荐 4GB+磁盘空间最低 1GB🚀 快速开始方式一：一键安装（推荐）# 下载并运行安装脚本 curl -fsSL https://raw.githubusercontent.com/miaoxworld/ClawdBotInstaller/main/install.sh | bash安装脚本会自动：检测系统环境并安装依赖安装 ClawdBot引导完成核心配置（AI模型、身份信息）测试 API 连接自动启动 ClawdBot 服务可选打开配置菜单进行详细配置（渠道等）方式二：手动安装# 1. 克隆仓库 git clone https://github.com/miaoxworld/ClawdBotInstaller.git cd ClawdBotInstaller # 2. 添加执行权限 chmod +x install.sh config-menu.sh # 3. 运行安装脚本 ./install.sh安装完成后安装完成后脚本会：自动询问是否启动服务（推荐选择 Y）后台启动 ClawdBot Gateway可选打开配置菜单进行渠道配置如果需要后续管理：# 手动启动服务 source ~/.clawdbot/env && clawdbot gateway # 后台启动服务 clawdbot gateway start # 运行配置菜单进行详细配置 bash ~/.clawdbot/config-menu.sh # 或从 GitHub 下载运行 curl -fsSL https://raw.githubusercontent.com/miaoxworld/ClawdBotInstaller/main/config-menu.sh | bash⚙ 详细配置配置 AI 模型运行配置菜单后选择 [2] AI 模型配置，可选择多种 AI 提供商： Anthropic Claude 配置在配置菜单中选择 Anthropic Claude先输入自定义 API 地址（留空使用官方 API）输入 API Key（官方 Key 从 Anthropic Console 获取）选择模型（推荐 Sonnet 4）💡 支持 OneAPI/NewAPI 等第三方代理服务，只需填入对应的 API 地址和 KeyOpenAI GPT 配置在配置菜单中选择 OpenAI GPT先输入自定义 API 地址（留空使用官方 API）输入 API Key（官方 Key 从 OpenAI Platform 获取）选择模型Ollama 本地模型# 1. 安装 Ollama curl -fsSL https://ollama.ai/install.sh | sh # 2. 下载模型 ollama pull llama3 # 3. 在配置菜单中选择 Ollama # 输入服务地址：http://localhost:11434Groq (超快推理)访问 Groq Console 获取 API Key在配置菜单中选择 Groq输入 API Key选择模型（推荐 llama-3.3-70b-versatile）Google Gemini访问 Google AI Studio 获取 API Key在配置菜单中选择 Google Gemini输入 API Key选择模型（推荐 gemini-2.0-flash）配置 Telegram 机器人在 Telegram 中搜索 @BotFather发送 /newbot 创建新机器人设置机器人名称和用户名复制获得的 Bot Token搜索 @userinfobot 获取你的 User ID在配置菜单中选择 Telegram，输入以上信息配置 Discord 机器人访问 Discord Developer Portal点击 "New Application" 创建应用进入 "Bot" 页面，点击 "Add Bot"复制 Bot Token在 "OAuth2" → "URL Generator" 中生成邀请链接邀请机器人到你的服务器获取目标频道的 Channel ID（右键频道 → 复制 ID）在配置菜单中输入以上信息配置飞书机器人访问 飞书开放平台创建企业自建应用，选择"机器人"能力获取 App ID 和 App Secret在"权限管理"中添加权限：im:message.receive_v1 (接收消息)im:message:send_as_bot (发送消息)im:chat:readonly (读取会话信息)配置"事件订阅"：请求地址：https://你的服务器:18789/channels/feishu/webhook添加事件：im.message.receive_v1发布应用并添加到群组在配置菜单中选择飞书，输入以上信息📝 常用命令服务管理# 启动服务（后台守护进程） clawdbot gateway start # 停止服务 clawdbot gateway stop # 重启服务 clawdbot gateway restart # 查看服务状态 clawdbot gateway status # 前台运行（用于调试） clawdbot gateway # 查看日志 clawdbot logs # 实时日志 clawdbot logs --follow配置管理# 打开配置文件 clawdbot config # 运行配置向导 clawdbot onboard # 诊断配置问题 clawdbot doctor # 健康检查 clawdbot health数据管理# 导出对话历史 clawdbot export --format json # 清理记忆 clawdbot memory clear # 备份数据 clawdbot backup📋 配置说明ClawdBot 使用以下配置方式：环境变量: ~/.clawdbot/env - 存储 API Key 和 Base URLClawdBot 配置: ~/.clawdbot/clawdbot.json - ClawdBot 内部配置（自动管理）命令行工具: clawdbot config set / clawdbot models set 等💡 注意：配置主要通过安装向导或 config-menu.sh 完成，无需手动编辑配置文件环境变量配置示例~/.clawdbot/env 文件内容：# ClawdBot 环境变量配置 export ANTHROPIC_API_KEY=sk-ant-xxxxx export ANTHROPIC_BASE_URL=https://your-api-proxy.com # 可选，自定义 API 地址 # 或者 OpenAI export OPENAI_API_KEY=sk-xxxxx export OPENAI_BASE_URL=https://your-api-proxy.com/v1 # 可选自定义 Provider 配置当使用自定义 API 地址时，安装脚本会自动在 ~/.clawdbot/clawdbot.json 中配置自定义 Provider：{ "models": { "providers": { "anthropic-custom": { "baseUrl": "https://your-api-proxy.com", "apiKey": "your-api-key", "models": [ { "id": "claude-sonnet-4-5-20250929", "name": "claude-sonnet-4-5-20250929", "api": "anthropic-messages", "input": ["text"], "contextWindow": 200000, "maxTokens": 8192 } ] } } } }目录结构~/.clawdbot/ ├── clawdbot.json # ClawdBot 核心配置 ├── env # 环境变量 (API Key 等) ├── backups/ # 配置备份 └── logs/ # 日志文件 (由 ClawdBot 管理) 🛡️ 安全建议⚠ 重要警告：ClawdBot 需要完全的计算机权限，请务必注意安全！部署建议不要在主工作电脑上部署 - 建议使用专用服务器或虚拟机使用 AWS/GCP/Azure 免费实例 - 隔离环境更安全Docker 部署 - 提供额外的隔离层权限控制禁用危险功能（默认已禁用）security: enable_shell_commands: false enable_file_access: false启用沙箱模式security: sandbox_mode: true限制允许的用户channels: telegram: allowed_users: - "only-your-user-id"API Key 安全定期轮换 API Key不要在公开仓库中提交配置文件使用环境变量存储敏感信息# 使用环境变量 export ANTHROPIC_API_KEY="sk-ant-xxx" export TELEGRAM_BOT_TOKEN="xxx"❓ 常见问题Q: 安装时提示 Node.js 版本过低？# macOS brew install node@22 brew link --overwrite node@22 # Ubuntu/Debian curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - sudo apt-get install -y nodejsQ: 启动后无法连接？检查配置文件是否正确运行诊断命令：clawdbot doctor查看日志：clawdbot logsQ: Telegram 机器人没有响应？确认 Bot Token 正确确认 User ID 在 allowed_users 列表中检查网络连接（可能需要代理）Q: 如何更新到最新版本？# 使用 npm 更新 npm update -g clawdbot # 或使用配置菜单 ./config-menu.sh # 选择 [7] 高级设置 → [7] 更新 ClawdBotQ: 如何备份数据？# 手动备份 cp -r ~/.clawdbot ~/clawdbot_backup_$(date +%Y%m%d) # 使用命令备份 clawdbot backupQ: 如何完全卸载？# 停止服务 clawdbot gateway stop # 卸载程序 npm uninstall -g clawdbot # 删除配置（可选） rm -rf ~/.clawdbot📜 更新日志v1.0.0 (2026-01-29)🎉 首次发布✨ 支持一键安装部署✨ 交互式配置菜单✨ 多模型支持 (Claude/GPT/Ollama)✨ 多渠道支持 (Telegram/Discord/WhatsApp)✨ 技能系统✨ 安全配置 ## Publication Information - [链求君精选推荐](https://paragraph.com/@acc/): Publication homepage - [All Posts](https://paragraph.com/@acc/): More posts from this publication - [RSS Feed](https://api.paragraph.com/blogs/rss/@acc): Subscribe to updates