Clawdbot 部署过程让不少新手头疼，从选择部署方式到配置连接，问题层出不穷。本文系统梳理了部署过程中的核心痛点，并提供了清晰的解决方案，帮助用户顺利搭建并使用个人 AI 助手，减少不必要的试错成本。
智能速览
选择云部署还是本地部署，取决于是否是苹果生态用户和对图形界面的需求。
Windows 系统安装时，需用管理员权限打开 PowerShell 来避免安装失败。
安装脚本提示权限不足时，在命令前添加 `sudo` 并输入密码即可解决。
飞书长连接配置失败，需先在 Cloudbot 中配置好 App ID 和 Secret。
无法连接 GitHub 通常是本地网络问题，需要自行排查网络连接。
聊天过程中无响应，输入 `/new` 命令可重新创建对话窗口并唤醒服务。
精华内容
为了让大家少走弯路，下面将针对几个最常见的问题进行详细拆解，从部署选择到具体排错，一步步带你攻克难关。
部署环境选择
选择云部署还是本地部署，关键看两点。首先是是否属于苹果生态用户。Cloudbot 内置了许多苹果专属的 Skills，如操作备忘录、提醒事项等，这些功能在云服务商的 Linux 环境下无法使用。因此，对于以 iPhone 为主力机的用户，更推荐购买一台 Mac mini 进行本地部署以获得完整体验。其次是是否需要图形化界面。云部署基于 Linux，主要通过命令行交互，如果缺乏代码基础，后续排错会比较困难。因此，对于习惯图形界面操作的新手，本地部署更为友好。此外，Windows 系统同样可以安装 Cloudbot，只需在安装时使用管理员权限运行 PowerShell 即可。
权限问题处理
安装过程中最常见的问题之一就是权限不足。当终端出现类似 “Need root access” 的提示时，意味着需要更高权限来执行脚本。解决方法非常简单，只需在原本的命令前加上 `sudo` 即可。例如，将 `npm install` 改为 `sudo npm install`。执行后，系统会提示输入密码，输入当前用户的登录密码后按回车，命令就能以管理员权限继续运行。很多用户卡在这一步，只需记住这个小技巧即可轻松解决。
飞书配置排错
配置飞书机器人时，提示“无法建立长连接”是一个高频问题。其根本原因在于操作顺序错误。正确的流程是：在飞书开放平台创建应用并获取 App ID 和 App Secret 后，应立刻打开终端，通过 `clawdbot config` 命令，将这两个参数配置到 Cloudbot 中。只有当 Cloudbot 与飞书应用建立起底层连接后，再回到飞书后台去开启事件订阅和长连接，才能成功。这个原理是，飞书平台需要向 Cloudbot 发送并接收一个验证信息来确认连接已建立，如果 Cloudbot 端未完成配置，自然无法响应，导致开启失败。
使用与网络问题
在使用过程中，可能会遇到聊着聊着机器人就没反应了。这通常是因为对话上下文过长导致模型“假死”。此时，无需重启服务，只需在聊天框内输入 `/new` 命令并回车，即可新建一个对话窗口，唤醒 Cloudbot。此操作不会丢失历史记录，因为所有对话都保存在本地。另一个常见问题是网络连接，尤其是在安装依赖时提示无法连接 GitHub，报错代码为 43。这基本可以断定是本地网络环境的问题，需要用户自行排查网络设置或寻找代理方案来解决与 GitHub 的连接问题。
掌握了这些常见问题的解决方法，Cloudbot 的部署和使用将变得顺畅许多。从环境选择到权限配置，再到具体功能的排错，每一步都有迹可循。希望这些经验能帮助更多人成功搭建自己的智能助手，探索更多自动化办公与生活的可能。
关键评论
有M1 Mac Pro用户因Node.js版本不符（需要v24）导致下载失败。
部分用户在接入iMessage后，新建对话时遇到无权限的问题。
有用户反映飞书机器人无法识别图片和文件，仅支持文字消息。
有教师群体期待Cloudbot能支持连接钉钉，以辅助管理学生作业。
