Windows / Mac 桌面 PC 客户端安装配置
系统要求
| 系统 | 版本要求 |
|---|---|
| Windows | Windows 10 及以上 |
| macOS | macOS 12(Monterey)及以上,Apple Silicon 和 Intel 均支持 |
| Linux | Ubuntu 22.04+ / Debian 11+ / Fedora 34+ 及其他主流发行版 |
安装方式
PC 客户端的安装路径比手机端复杂一些,因为它需要 Node.js 运行时和 git 等依赖组件。对于国内 Windows 用户来说,官方提供的一键安装包是最省心的选项——装完之后还需要配置模型和渠道接入。
完整流程分四块:
- 安装 PC 客户端本身
- 设置自主性(让它能自我更新、解决自身问题)
- 切换模型(国内用户推荐用 MiniMax、Kimi、GLM、DeepSeek 等有订阅套餐的模型)
- 接入飞书/钉钉等通讯渠道(可选但推荐)

国内用户特别说明
国内 Windows 用户安装时大概率会遇到几个问题:
- 官网命令有的电脑能跑通、有的不行——因为 Node.js、npm、git 的版本有要求
- 首次安装耗时较长(10 分钟左右),需要拉取依赖
- 模型选择:国内模型有 MiniMax、Kimi、GLM、Qwen 等,都有月付订阅套餐,比 API 按量收费性价比更高
如果安装过程中报错卡住,参考Windows 环境安装排障。
手机端与 PC 端联动
手机端和 PC 端登录同一个账号即可联动:
- 手机端发起指令,PC 端实际执行
- PC 端的执行结果和日志同步回手机端
- 两端共享记忆,但执行操作只在 PC 端进行(手机端不具备文件访问权限)
这是产品设计的核心工作流——手机端是调度台,PC 端是执行端。
命令行兼容模式
PC 客户端支持终端直接下发任务,这条路径适合和已有自动化脚本联动:
- 可以把 Sophclaw 作为已有脚本流水线中的一环
- 支持终端里写自动化任务,融入已有的批量处理工作流
- 适合需要高频重复调用 AI Agent 的场景
下一步
装好 PC 客户端后,建议先创建你的 Sophclaw 实例,然后配置模型。如果你的场景以开发任务为主,可以考虑SophCode Desktop。