ClawX 快速上手教程：从安装到第一次 AI 对话，新手只需 5 分钟-开发者社区

ClawX 快速上手教程：从安装到第一次 AI 对话，新手只需 5 分钟

【免费下载链接】ClawXClawX is a desktop app that provides a graphical interface for OpenClaw AI agents. It turns CLI-based AI orchestration into a desktop experience without using the terminal. China website is https://clawx.com.cn.项目地址: https://gitcode.com/gh_mirrors/cl/ClawX

ClawX是一个把 AI 智能体「搬进桌面」的开源客户端。它基于 OpenClaw AI 智能体运行时，将命令行式的 AI 编排变成纯粹的图形界面体验——不需要终端、不写配置文件、不折腾环境变量。这篇 ClawX 快速上手教程将带你完成安装、配置模型，并在 5 分钟内发出第一条 AI 对话消息。

为什么选择 ClawX：零命令行的 AI 智能体桌面客户端

很多 AI 智能体工具需要你在终端敲命令、手写 YAML 配置。ClawX 的设计哲学很简单：强大的技术值得拥有一个尊重用户时间的界面。

传统痛点	ClawX 的解法
复杂的命令行配置	一键安装 + 引导式设置向导
手动编辑配置文件	可视化设置界面，实时校验
进程管理繁琐	自动管理 Gateway 网关生命周期
多个 AI 供应商切换	统一的供应商配置面板

核心能力一览：智能聊天、多频道管理、定时任务自动化、可扩展技能系统、安全存储的供应商凭证。功能细节详见 docs/zh-CN/features.md。

第一步：系统要求与安装 ClawX（约 1 分钟）

系统要求

项目	最低要求
操作系统	macOS 11+ / Windows 10+ / Linux（Ubuntu 20.04+）
内存	4GB（推荐 8GB）
存储空间	1GB 可用空间

推荐：下载预构建版本

前往 Releases 发布页下载对应平台的安装包，双击安装即可，全程无需命令行。

进阶：从源码构建

如果你有 Node.js 22+ 和 pnpm 9+，也可以从源码启动：

git clone https://gitcode.com/gh_mirrors/cl/ClawX cd ClawX pnpm run init # 安装依赖并下载捆绑运行时 pnpm dev # 以开发模式启动

完整开发环境说明见 docs/zh-CN/development.md。

第二步：首次启动，跟着 4 步设置向导走

首次打开 ClawX，设置向导会自动启动，按顺序完成 4 步即可：

语言与区域：向导会预选你的系统语言，支持中文、英文、日文、俄文；
AI 供应商：填入 API Key，或通过 OAuth 完成浏览器/设备登录（支持 OpenAI、Anthropic、Z.AI / GLM 等）；
技能包：勾选常见场景的预配置技能，默认已内置pdf、xlsx、docx、pptx文档处理技能；
验证：进入主界面前先测试配置是否连通。

第三步：配置 AI 模型供应商

进入左侧导航的「模型」页面，这是 ClawX 快速上手的核心一步。点击「添加提供商」，选择你的 AI 供应商：

API Key 方式：如 OpenAI、DeepSeek、OpenRouter，粘贴密钥后 ClawX 会自动探测验证（兼容网关不可用时会自动降级为轻量探测）；
OAuth 登录：如 Minimax（CN），点击后通过浏览器完成设备登录；
凭证安全：所有密钥都存储在系统原生密钥链中，不明文落盘；
每个供应商可配置多个模型，标记一个为「默认」后，聊天输入框就会自动选中它。

第四步：发出你的第一次 AI 对话 🎉

配置完成后回到主界面，ClawX 会问你「我能为你做些什么？」。在输入框直接输入问题，回车发送即可：

几个新手实用技巧：

切换模型：输入框下方的gpt-5.5 ▾下拉框可即时切换供应商和模型；
@agent 路由：输入@agent名称可把消息直接发给指定智能体，它会切换到该智能体自己的对话上下文；
/技能卡片：输入框插入的技能会以/技能名卡片形式显示，点击可在右侧预览栏查看SKILL.md；
流式渲染：回复以流式 Markdown 实时输出，支持代码语法高亮、表格和 KaTeX 数学公式；
状态指示：输入框下方显示「gateway 已连接」，说明本地 AI 网关运行正常。

对话到这里，你就已经完成了 ClawX 快速上手的全部核心流程！

五、认识其余四大核心页面

ClawX 不止能聊天，以下 4 个页面覆盖了 AI 自动化最常用的场景：

🧩 技能（Skills）：给 AI 装插件

技能是 AI 能力的扩展单元。Skills 页面采用「本地优先」：扫描托管目录与 workspace 技能目录，无需依赖 Gateway 即可启用或停用，还能搜索安装市场技能：

⏰ 定时任务：让 AI 7×24 自动工作

可视化定义触发器与时间间隔，支持周期（每小时/每天/工作日/每周/自定义 cron）与单次执行两种模式，结果还能自动投递到外部频道：

📡 频道（Channels）：把 AI 接入 Telegram、微信等

每个频道独立运行、支持多账号，可在页面直接完成账号绑定 Agent 与默认账号切换，内置腾讯官方个人微信渠道插件：

⚙️ 设置：主题、语言与网关状态

「设置 → 通用」可切换浅色/深色/跟随系统主题、切换界面语言、开启开机自动启动；「网关」区块实时显示 AI 运行时的状态（running/重启/日志），底部状态栏也会显示端口号：

六、新手常见问题（FAQ）

Q1：状态栏一直显示 gateway 未连接怎么办？网关由 ClawX 自动拉起和监控（管理逻辑见 electron/gateway/manager.ts）。先进入「设置 → 网关」点击「重启」，并查看「日志」定位报错；若长时间无响应，ClawX 会在 3 分钟无验证活动后自动校验并重启自身拥有的 Gateway 进程。

Q2：网络环境需要通过代理访问外网？打开「设置 → 网关 → 代理」，填入如http://127.0.0.1:7890的代理地址和绕过规则即可，适用于 Electron 本体、OpenClaw Gateway 和 Telegram 等频道的联网请求。详见 docs/zh-CN/proxy-settings.md。

Q3：如何自定义高级参数？进入「设置 → 高级 → 开发者模式」，可覆盖 HTTP/HTTPS 代理、图像生成端点等高级配置，普通用户默认无需改动。