OpenClaw 安装配置指南一、概述1. 简介A. 是什么OpenClaw 是一个开源的个人 AI 助手平台，支持多平台集成（WhatsApp、Telegram、Discord 等）和任务自动化。B. 为什么使用支持多聊天平台统一管理提供 WebSocket Gateway 实现实时通信支持代理管理和会话持久化开源免费，可自主部署C. 学完能做什么在 Linux 环境中安装 OpenClaw配置和管理聊天频道运行和监控 Gateway 服务使用控制面板管理 AI 代理2. 前置知识A. 必备技能基本 Linux 命令操作了解 Node.js 和 npm 基本概念B. 推荐知识了解 WebSocket 基本原理熟悉 JSON 配置文件二、环境准备1. 系统要求操作系统：Linux（Kali、Ubuntu、Debian 等）Node.js：v22.12.0 或更高版本构建工具：gcc、make、g++、python3内存：至少 2GB 可用磁盘：至少 500MB 可用空间2. 安装步骤检查 Node.js 版本node --version检查构建工具make --version gcc --version检查 npm（通过 corepack）node /usr/share/nodejs/corepack/dist/npm.js --version3. 验证安装确保所有前置条件满足后再继续。三、核心概念1. 基本术语Gateway（网关）：WebSocket 服务器，处理通道和代理之间的通信Agent（代理）：AI 智能体，处理用户消息和任务Channel（通道）：连接的聊天平台（Telegram、Discord 等）Session（会话）：用户与代理之间的对话历史Credentials（凭证）：第三方服务的认证信息2. 工作原理graph TB Client[用户客户端 Telegram/Discord] --> Channel[通道模块] Channel --> Gateway[WebSocket 网关] Gateway --> Agent[AI 代理] Agent --> Gateway Gateway --> Channel Channel --> Client Gateway --> Control[控制面板 http://127.0.0.1:18789] Agent --> Session[(会话存储)] Channel --> Cred[(凭证存储)]四、快速上手1. 安装 OpenClaw官方安装脚本（推荐）curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash替代方案：用户级安装当 npm 通过 corepack 提供且没有系统级权限时使用：# 创建用户级 npm 目录 mkdir -p ~/.npm-global # 设置环境变量 export npm_config_prefix="$HOME/.npm-global" export PATH="$npm_config_prefix/bin:$PATH" # 使用 corepack npm 安装 npm_config_prefix="$HOME/.npm-global" PATH="$npm_config_prefix/bin:$PATH" \ node /usr/share/nodejs/corepack/dist/npm.js install -g openclaw@latest2. 验证安装# 检查可执行文件 ls -la ~/.npm-global/bin/openclaw # 查看版本 ~/.npm-global/bin/openclaw --version # 检查已安装包 ~/.npm-global/bin/node /usr/share/nodejs/corepack/dist/npm.js list -g openclaw预期输出：可执行文件：~/.npm-global/bin/openclaw版本：2026.2.26（或更新版本）3. 初始化配置首次使用前需要运行配置向导：~/.npm-global/bin/openclaw onboard或使用交互式设置向导：~/.npm-global/bin/openclaw configure配置完成后，配置文件位于：主配置：~/.openclaw/openclaw.json工作空间：~/.openclaw/workspace凭证：~/.openclaw/credentials日志：~/.openclaw/logs/五、启动服务1. 启动 Gateway~/.npm-global/bin/openclaw gateway默认配置：WebSocket 地址：ws://127.0.0.1:18789控制面板：http://127.0.0.1:18789/2. 检查服务状态# 健康检查 ~/.npm-global/bin/openclaw health # 查看详细状态 ~/.npm-global/bin/openclaw status正常输出示例：Gateway: local · ws://127.0.0.1:18789 · reachable 62ms Telegram: ok (@your_bot_name)3. 访问控制面板浏览器访问：http://127.0.0.1:18789/六、常用命令1. 核心命令命令说明openclaw gateway启动 WebSocket 网关openclaw status查看系统状态openclaw health健康检查openclaw configure交互式配置向导openclaw onboard初始化配置向导openclaw channels管理聊天通道openclaw agents管理代理openclaw message发送消息2. 通道管理# 登录 Telegram 通道 ~/.npm-global/bin/openclaw channels login --channel telegram # 查看通道状态 ~/.npm-global/bin/openclaw channels list # 登录 Discord ~/.npm-global/bin/openclaw channels login --channel discord3. 日志查看# 实时查看网关日志 ~/.npm-global/bin/openclaw logs --follow # 查看指定行数的日志 ~/.npm-global/bin/openclaw logs --lines 100七、常见问题1. 安装问题npm command not found问题：官方脚本无法找到 npm 命令解决方案：使用用户级安装方案mkdir -p ~/.npm-global export npm_config_prefix="$HOME/.npm-global" export PATH="$npm_config_prefix/bin:$PATH"原生模块编译失败问题：sharp、canvas 等原生模块编译失败解决方案：安装构建依赖sudo apt-get update sudo apt-get install -y build-essential python3 python3-dev2. 运行问题Gateway 无法连接问题：ECONNREFUSED 127.0.0.1:18789解决方案：检查 Gateway 是否运行~/.npm-global/bin/openclaw gateway凭证目录权限警告问题：credentials 目录权限过于宽松解决方案：收紧权限chmod 700 ~/.openclaw/credentials3. 配置问题如何设置自定义端口编辑 ~/.openclaw/openclaw.json，修改 gateway.port 字段如何启用 dev 模式~/.npm-global/bin/openclaw --dev gatewaydev 模式使用独立的配置和状态目录（~/.openclaw-dev/）八、安全建议1. 基本安全措施使用强密码保护控制面板不要在公共网络暴露 Gateway 端口定期备份配置和会话数据设置凭证目录权限为 7002. 网络安全使用反向代理时配置 trustedProxies启用 HTTPS 访问控制面板限制聊天机器人的访问权限3. 运行安全检查# 运行安全审计 ~/.npm-global/bin/openclaw security audit # 运行系统健康检查 ~/.npm-global/bin/openclaw doctor参考资料OpenClaw 官方文档OpenClaw GitHub 仓库OpenClaw 安装指南
ClawdBot 自托管 AI 助手技术分析一、新闻概述1. 标题ClawdBot 中文俱乐部 Discord 社区发布：自托管个人 AI 助手解决方案2. 发布时间2026 年 1 月 24 日3. 来源DiscordHunt 平台二、核心内容1. 事件摘要A. 主要内容ClawdBot 是一个自托管的个人 AI 助手项目，支持清理邮箱、发送邮件、管理日历、航班值机等实际任务。项目同时发布了中文社区 Discord 服务器，为中文用户提供交流和学习平台。B. 核心亮点真正能"干活"的 AI 助手，不仅仅是聊天机器人支持多平台接入：WhatsApp、Telegram、Discord、Slack、Signal、iMessage开源自托管，用户完全掌控数据和隐私基于 Claude 大模型，具备强大的理解和执行能力2. 关键信息A. 项目定位自托管 AI Agent 框架，面向个人生产力自动化场景B. 社区数据Discord 服务器：ClawdBot 中文俱乐部成员数量：577 人在线人数：90 人30 天增长：+106 人评分：5.0（2 人评价）C. 涉及技术AI 大模型：Claude（Anthropic）通信平台：多消息应用集成自动化：浏览器自动化、任务编排3. 背景介绍A. 前置背景随着 Claude、ChatGPT 等大模型的普及，AI 助手从简单的聊天对话向实际任务执行演进。市场上大多数 AI 助手仍停留在对话层面，无法直接操作用户的实际应用和服务。B. 相关上下文ClawdBot 属于"AI Agent"赛道，代表了大模型从"对话"向"行动"的演进方向。与 OpenAI 的 Agent 产品、AutoGPT 等项目类似，但更注重个人场景的实用性和自托管隐私保护。三、详细报道1. 主要内容A. 功能特性ClawdBot 的核心功能涵盖个人数字生活的多个方面：邮箱管理：自动清理收件箱、分类邮件、发送回复日程安排：管理日历事件、设置提醒、协调会议时间旅行服务：自动办理航班值机、查询航班信息任务自动化：通过浏览器自动化完成各种重复性任务多平台接入：统一接入多个消息平台，无需切换应用B. 技术特点graph TB subgraph 用户 A[消息平台] end subgraph ClawdBot B[消息接入层] C[任务理解层 Claude LLM] D[任务编排层] E[执行引擎层] end subgraph 外部服务 F[邮箱服务] G[日历服务] H[浏览器自动化] I[其他 API] end A -->|WhatsApp/Telegram/Discord等| B B --> C C -->|任务解析| D D -->|指令分发| E E -->|操作| F E -->|操作| G E -->|自动化| H E -->|调用| I自托管部署：用户可在本地或云端自行部署，完全掌控数据模块化设计：支持集成各种工具和服务浏览器自动化：通过浏览器控制完成网页操作可扩展工作流：用户可自定义自动化流程C. 中文社区定位ClawdBot 中文俱乐部是一个面向中文用户的交流社区，聚焦于：分享 ClawdBot 使用经验、工作流和自动化案例探索个人 AI 助手在邮箱、日程、任务自动化等方面的潜力交流本地和云端部署与配置经验研究 ClawdBot 源代码和各类集成玩法讨论 AI agent、自动化、开发相关话题2. 技术细节A. 系统架构ClawdBot 采用分层架构设计：接入层：处理多个消息平台的协议适配理解层：使用 Claude LLM 解析用户意图编排层：将复杂任务分解为可执行步骤执行层：通过浏览器自动化和 API 调用完成任务B. 工作流程sequenceDiagram participant U as 用户 participant M as 消息平台 participant C as ClawdBot participant L as Claude LLM participant E as 执行引擎 participant S as 外部服务 U->>M: 发送指令 M->>C: 转发消息 C->>L: 解析意图 L-->>C: 返回任务计划 C->>E: 执行任务 E->>S: 调用服务API S-->>E: 返回结果 E-->>C: 执行完成 C->>M: 返回结果 M->>U: 显示给用户C. 技术栈推测基于项目特性，推测其技术栈包括：后端框架：Python（常见于 AI 项目）LLM 集成：Anthropic Claude API浏览器自动化：Playwright 或 Selenium消息平台 SDK：各平台的官方 SDK任务编排：可能使用 LangChain 或自研框架3. 数据与事实A. 社区增长趋势根据页面数据显示，ClawdBot 中文俱乐部在 30 天内增长了 106 名成员，增长稳定。B. 用户评价当前仅有 2 人评价，评分 5.0，说明项目处于早期阶段，用户基数较小但满意度高。四、影响分析1. 行业影响A. 技术趋势ClawdBot 代表了 AI 助手的下一阶段发展方向：从"对话"到"行动"。这与 OpenAI、Google 等巨头的方向一致，但 ClawdBot 更强调自托管和隐私保护。B. 开源生态作为开源项目，ClawdBot 为个人 AI 助手领域提供了一个可参考的实现方案，有助于推动 AI Agent 技术的普及和发展。2. 用户影响A. 现有用户对于已关注 AI Agent 技术的用户，ClawdBot 提供了一个可实际部署的解决方案，降低技术门槛。B. 潜在用户对于希望提升个人生产力、自动化日常任务的用户，ClawdBot 提供了一个无需依赖大公司产品的替代方案。C. 部署门槛自托管意味着用户需要一定的技术能力（服务器部署、环境配置等），中文社区的存在有助于降低这一门槛。3. 技术趋势A. AI Agent 普及化ClawdBot 等项目的出现，标志着 AI Agent 技术正在从研究领域走向实用化、普及化。B. 隐私保护需求自托管模式反映了用户对 AI 数据隐私的关注，这是对云端 AI 服务的重要补充。C. 多平台集成趋势统一接入多个消息平台，符合用户希望在一个入口完成多种操作的需求。五、各方反应1. 官方信息ClawdBot 是一个开源项目已建立中文 Discord 社区进行用户支持和交流2. 社区反馈A. 正面评价真正能"干活"的 AI 助手定位自托管保障数据隐私开源可定制B. 关注点部署复杂度与各平台 API 的稳定性Claude API 的使用成本六、相关链接1. 官方资源ClawdBot 中文俱乐部 Discord 服务器ClawdBot GitHub 仓库（需进一步确认）2. 相关项目Claude Developers Discord 社区（54,243 成员）Friends of the Crustacean 社区（9,405 成员）参考资料ClawdBot 中文俱乐部 - DiscordHunt