Loading... # OpenClaw + CherryIN 零基础保姆级教程 # 一、概述 ## 1. 简介 ### A. 是什么 OpenClaw 是一个开源的 AI Agent 框架，可以让 AI 模型控制电脑执行各种任务，包括写代码、操作文件、执行命令等。CherryIN 是一个 AI 模型聚合平台，提供多家大模型的统一接入服务。 ### B. 为什么学 - OpenClaw 开源一周 Stars 数已超过 12 万，生态活跃 - CherryIN 聚合多家模型，包括 DeepSeek v3.2、Kimi K2.5 等最新模型 - 打造专属 AI Agent，彻底解放生产力 ### C. 学完能做什么 - 独立配置 OpenClaw + CherryIN 环境 - 使用 AI Agent 自动化执行电脑操作任务 - 切换使用多种 AI 模型完成不同场景需求 ## 2. 前置知识 ### A. 必备技能 - 基本命令行操作能力 - 了解 JSON 配置文件格式 ### B. 推荐知识 - 虚拟机基础概念（推荐在虚拟机中测试） - Node.js 和 npm 基础 # 二、环境准备 ## 1. 系统要求 - 操作系统：Windows / macOS / Linux - 网络环境：稳定的互联网连接 - Node.js：22 以上版本（推荐 24） - 时间：约 20 分钟 ## 2. 安装 Node.js macOS / Linux 用户推荐使用 nvm 安装： ```bash # 下载并安装 nvm curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash # 加载 nvm（避免重启终端） \. "$HOME/.nvm/nvm.sh" # 安装 Node.js 24 nvm install 24 # 验证安装 node -v npm -v ``` Windows 用户推荐使用 WSL 环境，或直接下载 Node.js 安装包。 ## 3. 安装 OpenClaw Node.js 装好后，一行命令搞定： ```bash npm install -g openclaw@latest ``` 或使用 pnpm： ```bash pnpm add -g openclaw@latest ``` ## 4. 验证安装 ```bash node -v openclaw --version ``` 能正常显示版本号即说明安装成功。 # 三、核心概念 ## 1. 基本术语 - OpenClaw：AI Agent 框架，提供模型调用和电脑控制能力 - CherryIN：AI 模型聚合平台，提供统一 API 接口 - Provider：模型供应商，CherryIN 是其中一个供应商 - Agent：智能代理，可以理解并执行用户指令 ## 2. 工作原理 ```mermaid graph LR A[用户] --> B[OpenClaw] B --> C{模型路由} C --> D[CherryIN] D --> E[各大模型] E --> D D --> B B --> F[电脑操作] F --> G[文件/命令/应用] ```   ## 3. 架构图 OpenClaw 采用插件化架构，支持多种模型供应商： - 配置文件：~/.openclaw/openclaw.json - WebUI：浏览器界面交互 - Daemon：后台服务进程 # 四、快速上手 ## 1. 初始化 OpenClaw 执行初始化命令： ```bash openclaw onboard --install-daemon ``` 安装完成后会自动弹出配置页面。如果没有弹出，可手动执行： ```bash openclaw onboard ``` ## 2. 安全风险确认 因为 OpenClaw 可以控制电脑，会有安全提示。接受即可。 **强烈建议**：在虚拟机中使用，避免影响主力机。 ## 3. 配置向导步骤 ### A. 跳过 Provider 设置 暂时不设置 Provider，后续通过配置文件接入 CherryIN。 ### B. 跳过通知设置 IM 通知需要额外配置，先确保基础功能可用。 ### C. 选择 WebUI 模式 选择 WebUI 模式，方便在浏览器中操作。 ### D. 成功标志 控制台输出访问地址，如 http://localhost:3000 ## 4. 注册 CherryIN 访问 CherryIN 官网：https://open.cherryin.ai/ **建议**：使用邮箱登录，比 GitHub 登录更稳定。 充值后可体验全部模型，包括免费的 DeepSeek v3.2 和各家最新模型。 ## 5. 获取 API 令牌 ### A. 创建令牌 进入「令牌管理」，创建新令牌，如 Openclaw-Agent ### B. 复制令牌 保存 sk- 开头的令牌，后续配置需要使用 # 五、配置模型接入 ## 1. 找到配置文件 OpenClaw 配置文件路径： ```bash ~/.openclaw/openclaw.json ``` ~ 表示用户主目录： - Linux：/home/用户名 - macOS：/Users/用户名 - Windows：C:\Users\用户名 ## 2. 添加 CherryIN 配置 打开配置文件，添加以下内容（替换 sk-xxxxx 为自己的令牌）： ```json { "models": { "mode": "merge", "providers": { "cherryin": { "baseUrl": "https://open.cherryin.cc/v1/", "apiKey": "sk-xxxxx", "auth": "api-key", "api": "openai-completions", "headers": {}, "models": [ { "id": "agent/kimi-k2.5", "name": "Kimi K2.5", "api": "openai-completions" }, { "id": "anthropic/claude-opus-4.5", "name": "Claude Opus 4.5", "api": "openai-completions" }, { "id": "anthropic/claude-sonnet-4.5", "name": "Claude Sonnet 4.5", "api": "openai-completions" } ] } } }, "agents": { "defaults": { "model": { "primary": "cherryin/agent/kimi-k2.5" }, "models": { "cherryin/agent/kimi-k2.5": {}, "cherryin/anthropic/claude-opus-4.5": {}, "cherryin/anthropic/claude-sonnet-4.5": {} }, "compaction": { "mode": "safeguard" }, "maxConcurrent": 4, "subagents": { "maxConcurrent": 8 } } } } ``` **模型 ID 说明**：可访问 CherryIN 价格页面查看所有可用模型。 ## 3. 保存并验证 保存文件后无需重启服务，配置即时生效。 # 六、开始使用 ## 1. 创建新对话 在 WebUI 中执行： ``` /new ``` ## 2. 切换模型 使用 /model 命令切换模型： ``` /model cherryin/agent/kimi-k2.5 ``` **模型路径格式**：Provider/ModelID - 供应商 ID：cherryin - 模型 ID：agent/kimi-k2.5 - 完整路径：cherryin/agent/kimi-k2.5 ## 3. 发送消息测试 发送测试消息，如「你好，介绍一下你自己」。 ## 4. 成功标志 AI 正常回复消息，说明配置成功。 # 七、进阶内容 ## 1. 通过 WebUI 配置 如果不习惯编辑配置文件，可通过 WebUI 配置： ### A. 进入配置页面 在 WebUI 中找到 Config 配置入口 ### B. 添加 Provider 配置供应商信息，包括端点和 API Key ### C. 添加模型 新建模型，填写模型 ID（从 CherryIN 价格页获取） ### D. 保存重载 **重要**：点击 Save + Reload 使配置生效 ## 2. 支持的模型 CherryIN 支持的模型包括但不限于： - DeepSeek v3.2（免费） - Kimi K2.5 - Claude Opus 4.5 - Claude Sonnet 4.5 - GPT-4 系列 - 其他各家最新模型 ## 3. 注意事项 ### A. 模型兼容性 确保选择支持 openai-completions 的模型 ### B. 配置重载 修改配置后必须保存重载才能生效 ### C. 安全建议 在虚拟机中测试，避免影响主力机 # 八、常见问题 ## 1. 安装问题 - Node.js 版本过低：使用 nvm 安装 22 以上版本 - npm 权限问题：Linux/macOS 使用 sudo 或配置 npm 全局路径 ## 2. 配置问题 - JSON 格式错误：使用 JSON 验证工具检查语法 - 模型路径错误：确认 Provider 和 Model ID 正确 ## 3. 使用问题 - 模型无响应：检查 API Key 是否有效 - 配置未生效：确认已点击 Save + Reload *** ## 参考资料 1. [OpenClaw + CherryIN 零基础保姆级教程 - Cherry Studio](https://mp.weixin.qq.com/s/skYQ6eWNFz8GtbMX87hOZw) 2. [CherryIN 官网](https://open.cherryin.ai/) 最后修改：2026 年 01 月 31 日 © 允许规范转载 赞 如果觉得我的文章对你有用，请随意赞赏