ClawX 完整安装指南（Windows/macOS/Linux）

（三）Linux 平台安装教程

1. 下载安装包：访问 GitHub Releases 页面，找到 ClawX-<版本号>.AppImage 下载。
2. 赋予执行权限并安装：
   • 右键点击 AppImage 文件，选择'属性'，切换到'权限'选项卡，勾选'允许作为程序执行文件'。
   • 双击该 AppImage 文件，即可直接运行 ClawX。
3. 创建桌面快捷方式（可选）：运行后，点击界面右上角的菜单，选择'创建桌面快捷方式'。

三、首次配置：3 步搞定

安装完成后，进入 ClawX 的核心配置环节。

第一步：设置向导初始化

1. 语言与区域：默认简体中文，直接点击'下一步'。
2. 环境检查：软件会自动检查系统依赖，如有缺失，会提示'一键修复'。
3. AI 服务商配置：选择你准备好的 AI 服务商。

第二步：获取并配置 API Key

1. 注册账号：访问 SiliconFlow 官网或其他服务商官网注册登录。
2. 创建 API Key：在个人中心创建密钥，复制保存。
3. 在 ClawX 中配置：在'AI 服务商'下拉框中选择对应服务商，粘贴密钥，点击'测试连接'。

第三步：选择技能包并完成初始化

1. 技能包选择：新手推荐勾选'办公自动化 + 信息检索'或'自媒体创作 + 热点监控'。
2. 完成初始化：点击'完成'，软件会自动加载技能包。

四、首次上手：打造第一个 AI 任务

任务 1：聊天式指令

1. 打开 ClawX 主界面，在聊天框中输入：'帮我把桌面的下载文件夹里的文件，按类型分类到文档、图片、视频、安装包四个文件夹中'。
2. 点击发送按钮，等待 AI 响应。

任务 2：可视化定时任务

1. 点击顶部的'自动化'按钮，进入定时任务管理页面。
2. 点击'新建定时任务'，输入任务名称。
3. 设置执行时间：勾选'每天'，设置时间为'09:00'。
4. 设置任务内容：在'任务指令'中输入搜索新闻并整理的指令。
5. 设置推送方式：勾选'ClawX 内通知'或绑定其他工具。
6. 点击'保存'，任务自动生效。

五、进阶设置：多频道分工协作

1. 新建频道：点击左侧频道列表的'+'号，输入频道名称。
2. 为频道配置专属技能：进入频道设置，勾选特定技能（如文案生成、网页监控等）。
3. 分工执行任务：在不同频道输入不同指令，AI 会根据频道配置专注处理。

六、安全设置

1. 备份重要文件：在让 AI 处理文件前，务必备份重要数据。
2. 限制软件权限：
   • Windows 用户：取消'以管理员身份运行此程序'。
   • macOS 用户：在'隐私与安全性'中只允许访问需要处理的文件夹。
3. 开启操作确认模式：在安全设置中勾选'删除、修改、发送类操作需人工确认'。
4. 仅安装官方可信插件：只安装官方认证的插件。

七、常见问题排查

问题 1：ClawX 启动后卡在'加载运行时'界面

解决方案：

1. 关闭 ClawX，重新启动。
2. 手动删除运行时缓存：
   • Windows：删除 C:\Users\<用户名>\AppData\Roaming\ClawX\runtime
   • macOS：删除 ~/Library/Application Support/ClawX/runtime
   • Linux：删除 ~/.config/ClawX/runtime
3. 重新启动 ClawX。

问题 2：API Key 测试连接失败

解决方案：

1. 检查密钥是否复制完整，有无多余空格。
2. 登录服务商官网，检查密钥是否过期。
3. 更换服务商排除问题。

问题 3：定时任务不执行

解决方案：

1. 检查 ClawX 是否在后台运行。
2. 进入'自动化'页面，检查任务的时间设置是否正确。
3. 重启 ClawX，重新保存任务。

问题 4：AI 无法整理文件，提示'权限不足'

解决方案：

• Windows：给 ClawX 安装目录赋予'读写'权限。
• macOS：在'隐私与安全性'中勾选 ClawX 需要访问的文件夹。
• Linux：执行 chmod -R 755 ~/.config/ClawX。

问题 5：ClawX 界面卡顿，无响应

解决方案：

1. 关闭暂时不用的频道。
2. 升级电脑内存。
3. 重启 ClawX。

问题 6：Linux 平台双击 AppImage 无法运行

解决方案：

1. 右键点击文件，勾选'允许作为程序执行文件'。
2. 终端执行 ./ClawX-<版本号>.AppImage --no-sandbox。
3. 若提示缺少依赖，执行 sudo apt install libnss3 libgtk-3-0 libxss1。

问题 7：macOS 平台 ClawX 无法联网

解决方案：进入'系统设置'→'网络'→'防火墙'，勾选'允许 ClawX 传入连接'。