ClawdBot 一键安装，助你打造自己的 AI 助手

February 01, 2026

类别: 实用开源项目

标签:

AI Assistant Automation OpenSource One‑Click Install OpenClaw

ClawdBot: 适用于所有平台的一键 AI 助手

在快速发展的 AI 领域，拥有一款在你自己的硬件上运行的个人聊天机器人既可以是学习项目，也可以是强大的生产力工具。ClawdBot（又名 OpenClaw Installer）满足此需求，只需一条命令即可托管 AI 助手。

以下是完整的使用指南：它是什么、为何有用、如何安装、如何配置多模型和多渠道支持、如何保障安全以及如何根据你的使用场景进行微调。

1. ClawdBot 是什么？

ClawdBot 是一个轻量级、跨平台的一键部署工具，打包了 OpenClaw AI 服务器和易于使用的设置脚本。OpenClaw 是一个模块化框架，能够将请求路由到不同的 LLM 提供商（Anthropic、OpenAI、Gemini、Groq、Mistral、Ollama 等），并通过多种流行的消息渠道公开助手：Telegram、Discord、WhatsApp、Slack、WeChat、iMessage、Feishu，以及自定义 Webhook。

关键特性：

一次点击安装 – 一个 shell 脚本安装 Node，下载 OpenClaw，并完成所有配置。
多模型支持 – 选择或添加任意你偏好的 LLM 提供商。
跨渠道集成 – 通过几乎任何聊天平台与助手对话。
持久化与记忆 – 内置跨平台长期记忆、技能系统、推送通知。
安全选项 – 沙盒模式、开启/禁用 shell 命令、限制用户列表。
Docker 支持 – 在容器内部署，隔离环境。

2. 系统要求

项目	最低要求	建议配置
OS	macOS 12+、Ubuntu 20.04+、Debian 11+、CentOS 8+	所有具备 systemd 的 Linux 发行版
Node.js	v22+	v22 或以上
RAM	2 GB	4 GB+
磁盘	1 GB 可用	2 GB+

ClawdBot 会自动提示你安装任何缺失的系统包。如果你在已经托管高负载服务的机器上运行，最好使用专用 VM 或云实例。

3. 一键安装（推荐）

打开终端并运行：

curl -fsSL https://raw.githubusercontent.com/miaoxworld/OpenClawInstaller/main/install.sh | bash

脚本执行步骤：

环境检测 – 检查 Node 版本、内存、磁盘空间。
依赖安装 – 安装 Node 22 与 npm。
克隆仓库 – 下载最新 OpenClaw 源码。
交互式设置 – 询问模型提供商、密钥、模型名称及渠道。
自检 – 验证 API 连接。
服务启动 – 后台启动 OpenClaw 网关。

完成初始向导后，可选择打开配置菜单进一步细化设置：

bash ~/.openclaw/config-menu.sh

4. 手动安装（高级）

若你需要更细粒度的控制（例如构建自定义 Docker 镜像或在 CI 流水线中运行），请按以下手动步骤操作：

# 1. 克隆仓库
git clone https://github.com/miaoxworld/OpenClawInstaller.git
cd OpenClawInstaller

# 2. 赋予可执行权限
chmod +x install.sh config-menu.sh

# 3. 运行安装程序
./install.sh

你还可以使用 npm 全局安装 OpenClaw CLI：

npm install -g openclaw

5. 配置 AI 模型

在安装向导中你会看到一个菜单，用于选择 AI 供应商。界面基于文本但易于上手：

Anthropic Claude – claude-sonnet-4-5、claude-opus-4-5 等。
OpenAI GPT – gpt-4o、gpt-4o-mini。
Google Gemini – gemini-2.0-flash、gemini-1.5-pro。
OpenRouter – 单一密钥即可使用多家供应商。
Groq & Mistral – 高性能推理。
Ollama – 本地自托管模型。

若你使用自定义代理（如 OneAPI、NewAPI 或兼容 OpenAI 的端点），只需输入基础 URL 与键。安装程序会自动将配置写入 ~/.openclaw/openclaw.json 与 ~/.openclaw/env。

6. 设置消息渠道

ClawdBot 可以通过 Telegram、Discord、WhatsApp、Slack、WeChat、iMessage（仅 macOS）和 Feishu 进行对话。安装程序为每个平台提供了详细指南。

用 BotFather 创建机器人。
复制 Bot Token。
通过 @userinfobot 找到你的 User ID。
在配置菜单中：选择 Telegram 并粘贴 token 与 ID。

Discord

在 Discord 创建应用 → Bot。
启用 Message Content Intent。
复制 Bot Token。
生成邀请 URL，至少包含 View Channels、Send Messages、Read Message History 权限。
将机器人加入服务器并获取频道 ID。
在菜单中：选择 Discord，粘贴 token 与频道 ID。

OpenClaw 使用 QR 码登录 WhatsApp Web 会话。无需 Business API。
运行配置对话框，扫描 QR 码完成登录。

⚠️ 重要：WhatsApp 登录一次只能在一台设备上，请确保 WhatsApp Web 未在其他设备上登录。

Feishu

在飞书开放平台注册一个应用。
添加 “机器人” 功能并授予所需权限。
开启事件订阅，使用长连接（不使用 webhook URL）。
在配置菜单提供 App ID 与 App Secret。

7. 管理服务

CLI openclaw 提供丰富的命令：

# 启动（后台）
openclaw gateway start

# 停止
openclaw gateway stop

# 重启
openclaw gateway restart

# 状态
openclaw gateway status

# 实时日志
openclaw logs --follow

# 配置编辑器
openclaw config

# 重新运行向导
openclaw onboard

# 备份数据
openclaw backup

Docker 部署

若你更喜欢容器隔离，仓库包含 Dockerfile 与 docker‑compose.yml。启动方式：

docker compose up -d

记得挂载 ~/.openclaw 目录，以便配置在重启后保留。

8. 安全提示

禁用危险命令 – 在配置文件中设置 security.enable_shell_commands: false 与 security.enable_file_access: false。
沙盒模式 – security.sandbox_mode: true 限制环境。
受限用户 – 在 channels.telegram.allowed_users 中仅添加值得信任的 ID。
定期轮换 API 密钥。
勿在仓库中存储密钥 – 使用环境变量。
使用专用 VM 或云实例，降低攻击面。

9. 常见问答

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 nodejs

Q: 为什么机器人没有响应？ - 验证 token 与 ID。 - 检查网络代理。 - 运行 openclaw doctor 进行诊断。

Q: 如何更新？ - npm update -g openclaw 或运行 ./config-menu.sh → 更新 OpenClaw。

Q: 如何备份？ - 手动：cp -r ~/.openclaw ~/openclaw_backup_$(date +%Y%m%d)。 - CLI：openclaw backup。

Q: 完全卸载？ - 停止服务：openclaw gateway stop。 - 卸载：npm uninstall -g openclaw。 - 删除配置：rm -rf ~/.openclaw。

10. 总结

ClawdBot 能将任意服务器或笔记本变成强大的多模型 AI 助手，消除配置难题。不论你想部署个人笔记助手、日程安排助手，还是测试新 LLM API 的实验平台，安装器都能提供干净、可复现的环境。通过 OpenClaw 构建，既能在本地轻松测试，又能无缝扩展到生产级部署。获取仓库，运行脚本，马上开启聊天之旅。

祝你玩得愉快，愿你的助手为你节省更多时间，专注真正重要的事！

原创文章: 查看原文

分享本文