夜雨聆风> **适用人群**：非计算机专业的科研工作者
> **目标**：在本地安装 AI 编程助手和自动化 Agent，让大模型协助代码编写、文献分析、数据整理等科研任务。
近年来，AI 辅助编程与科研的讨论热度很高，但许多公众号和营销号过度渲染其“无所不能”，内容又写得过于高深，反而让不少非计算机专业的科研人员望而却步。与此同时，国内一些编辑器中集成的 Agent 功能往往面向专业开发者，操作复杂，普通用户很难真正上手体验。
基于这一现状，我计划做一系列面向科研工作者的实用教程，分享我自己在实际工作中如何利用 AI 工具提升效率。今天是第一期，内容专注于最基础、最关键的一步——环境安装，并推荐几款顺手且易用的辅助软件，帮助大家零门槛迈出第一步。
## 目录
1. [前言](#1-前言)
2. [基础环境：安装 Node.js](#2-基础环境安装-nodejs)
3. [AI编程助手：Claude Code](#3-ai编程助手claude-code)
4. [自动化Agent：OpenClaw](#4-自动化agentopenclaw)
5. [进阶扩展：接入MiniMax M3模型与多模态能力](#5-进阶扩展接入minimax-m3模型与多模态能力)
6. [总结与后续预告](#6-总结与后续预告)
---
## 1. 前言
目前市面上宣传 AI 编程工具的文章常常过于高深，让非计算机专业的同学望而却步。本系列旨在用最通俗的步骤，帮您在自己的电脑上搭建实用的 AI 辅助环境。
**本篇为第一期**，聚焦 **Node.js 安装**、**Claude Code（命令行AI编程助手）** 和 **OpenClaw（多平台Agent）** 的部署，并介绍如何用国产或高性价比模型（如智谱、DeepSeek、MiniMax）驱动它们。
---
## 2. 基础环境：安装 Node.js
所有工具都基于 Node.js，请先完成安装。
### 2.1 下载安装包
- 访问官网：[https://nodejs.org/](https://nodejs.org/)
- 选择 **LTS（长期支持版）**，点击下载对应操作系统的 `.msi`（Windows）或 `.pkg`（macOS）安装包。
### 2.2 安装步骤（Windows 示例）
- 双击 `.msi` 文件，在安装向导中**务必勾选 “Add to PATH”**（自动配置环境变量）。
- 其余一路点击 `Next`，直至完成。
### 2.3 验证安装
打开命令提示符（Win+R 输入 `cmd` 回车，或在搜索栏输入 `cmd`），执行：
```bash
node -v # 显示版本号，如 v22.14.0
npm -v # 显示 npm 版本号，如 10.7.0
```
看到版本号即成功。
### 2.4 优化 npm（可选，建议）
为避免全局包占用系统盘空间，可自定义安装目录：
1. 在 Node.js 安装目录（如 `D:\nodejs`）下新建两个文件夹：`node_global` 和 `node_cache`。
2. 以**管理员身份**打开命令提示符，执行（路径请替换为自己的）：
```bash
npm config set prefix "D:\nodejs\node_global"
npm config set cache "D:\nodejs\node_cache"
```
3. 配置环境变量（右键“此电脑” → 属性 → 高级系统设置 → 环境变量）：
- 在 **用户变量** 的 `Path` 中，将默认的 npm 路径替换为 `node_global` 的路径。
- （可选）在 **系统变量** 中新建 `NODE_PATH`，值为 `node_global\node_modules`。
### 2.5 设置国内镜像源（加速下载）
在命令提示符中执行：
```bash
npm config set registry https://registry.npmmirror.com/
```
无报错即成功。
---
## 3. AI编程助手：Claude Code
Claude Code 是 Anthropic 推出的命令行 AI 编程工具，可在终端中辅助编写、调试代码。
### 3.1 系统要求
- **操作系统**：Linux（Ubuntu 20.04+）、macOS（11.0+）或 Windows（需 WSL2）。
- **Node.js**：18.0 及以上，推荐 22.x LTS。
- **Git**：2.38+（用于仓库分析）。
- **网络**：稳定互联网连接。
### 3.2 安装 Claude Code
在命令提示符中执行：
```bash
npm install -g @anthropic-ai/claude-code
```
安装后验证：
```bash
claude --version
```
显示版本号（如 `2.1.140`）即成功。
### 3.3 配置 API 连接（以智谱 AI 为例）
Claude Code 原生支持 Anthropic 的 API，但我们可以通过配置 Base URL 接入国内模型（如智谱 GLM、MiniMax）。
1. **获取 API Key**：在智谱开放平台（[https://open.bigmodel.cn](https://open.bigmodel.cn)）注册并创建 API Key，复制保存。
2. **编辑配置文件**（若文件不存在则新建）：
- Windows：`C:\Users\你的用户名\.claude\settings.json`
- macOS/Linux：`~/.claude/settings.json`
3. 写入以下内容（替换 `your_zhipu_api_key` 为您的实际 Key）：
```json
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "your_zhipu_api_key",
"ANTHROPIC_BASE_URL": "https://open.bigmodel.cn/api/anthropic",
"CLAUDE_CODE_AUTO_COMPACT_WINDOW": "1000000",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-4.7",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-5.2",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-5.2",
"API_TIMEOUT_MS": "3000000",
"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
},
"enabledPlugins": {
"glm-plan-deploy@zai-coding-plugins": true
}
}
```
> **注意**：若使用 MiniMax，则修改 `ANTHROPIC_BASE_URL` 为 `https://api.minimaxi.com/anthropic`，并更换相应模型名称。
4. **跳过首次引导**：编辑 `~/.claude.json`（或 `用户目录/.claude.json`），添加：
```json
{
"hasCompletedOnboarding": true
}
```
### 3.4 启动 Claude Code
在您的项目目录下打开终端，执行：
```bash
claude
```
首次运行会询问是否信任文件夹，选择 **Trust This Folder**，即可开始使用。
### 3.5 更新与版本查看
```bash
claude --version # 查看当前版本
claude update # 升级到最新版
```
---
## 4. 自动化Agent：OpenClaw
OpenClaw 是一款可运行在本地、与微信等平台集成的个人 AI 助手，能自动执行多种任务。
### 4.1 系统要求
- **操作系统**：macOS、Linux 或 Windows（推荐 WSL2）。
- **Node.js**：22.16 以上（官方安装脚本会自动检测并安装所需版本，无需手动操心）。
- **网络**：能访问 `openclaw.ai` 以下载脚本。
### 4.2 安装 OpenClaw
在命令提示符中执行：
```bash
npm install -g openclaw@latest
```
安装完成后验证：
```bash
openclaw --version
```
显示版本号（如 `2026.6.1`）即成功。
> **备选安装方式**（Windows PowerShell）：
> ```powershell
> iwr -useb https://openclaw.ai/install.ps1 | iex
> ```
### 4.3 准备 API Key（以 DeepSeek 为例，性价比高）
1. 访问 DeepSeek 官网：[https://www.deepseek.com/](https://www.deepseek.com/)，点击 **API 开放平台**。
2. 手机号注册并登录。
3. 进入 **API Keys** 页面，点击“创建新的 API Key”，随意命名，生成后**立即复制保存**（关闭后不可见）。
4. 前往“充值”页面，**先完成实名认证**，再充值少量金额（DeepSeek 价格低廉）。
### 4.4 配置 OpenClaw（onboard 引导）
执行以下命令，启动交互式配置：
```bash
openclaw onboard --install-daemon
```
按提示逐步操作：
- **允许匿名报告**：选择 `Yes`（左右箭头切换）。
- **配置方式**：默认 `quickstart`，直接回车。
- **选择模型**：按上下键选 `more`，然后选择 `DeepSeek`。
- **粘贴 API Key**：将之前复制的 Key 粘贴进去（右键粘贴），回车。
- **默认模型**：保持 `deepseek-v4-flash`，回车。
- **选择消息平台**：例如选 `weixin`（微信），等待依赖安装。
- **搜索引擎**：直接回车默认。
- **技能安装**：暂时不设置，按空格键勾选空选项，再回车。
完成后，会自动弹出一个**网关窗口**（Gateway），**请勿关闭**。
回到原命令行窗口，按回车继续，然后输入“你好”测试，若有回复则配置成功。
### 4.5 连接微信（可选）
若要 OpenClaw 通过微信与您交互，请执行：
```bash
openclaw channels login --channel openclaw-weixin
```
此时会弹出二维码（或链接），用微信扫码确认。
然后启动网关：
```bash
openclaw gateway run
```
之后即可在微信中向您的 OpenClaw 发送消息，它会自动回复。
> **注意**：每次使用前需确保网关窗口运行中（可后台保留）。
---
## 5. 进阶扩展：接入MiniMax M3模型与多模态能力
若您希望使用 MiniMax 的 M3 模型（支持思考、图像理解、网络搜索），可按以下步骤扩展。
### 5.1 在 OpenClaw 中配置 MiniMax
安装完成后，运行配置引导（若未自动开始）：
```bash
openclaw configure
```
- 选择 `Local (this machine)` 运行 Gateway。
- 选择 `Model` 模块 → 选择 `MiniMax`。
- 认证方式推荐 **OAuth（网页授权）**，会自动弹出浏览器登录并授权。
- 模型默认勾选 `MiniMax-M3` 并设为默认，直接确认即可。
完成后，输入 `openclaw tui` 打开终端界面，能对话即成功。
### 5.2 安装 MiniMax CLI（mmx）实现图像理解与搜索
MiniMax CLI 是多模态命令行工具，支持图像、视频、搜索等。安装后 OpenClaw 可通过 `mmx vision` 和 `mmx search` 扩展能力。
#### 5.2.1 安装 Node.js 18+（若未满足）
```bash
node -v
# 若低于18，推荐用 nvm 安装 LTS：
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
nvm install --lts
```
#### 5.2.2 全局安装 mmx-cli
```bash
npm install -g mmx-cli
```
验证：`mmx --version`
#### 5.2.3 登录（使用 API Key）
```bash
mmx auth login --api-key sk-xxxxx # 替换为您的 MiniMax API Key
```
> 若调用报 401，可能是 region 未匹配。手动指定：
> - 国内平台：`mmx config set --key region --value cn`
> - 海外平台：`mmx config set --key region --value global`
> 可用 `mmx auth status` 确认。
检查额度：`mmx quota`
#### 5.2.4 安装官方 SKILL（让 OpenClaw 自动调用）
```bash
npx skills add MiniMax-AI/cli -y -g
```
该 SKILL 会链接到 `~/.openclaw/skills/`，OpenClaw 下次启动即可识别。
#### 5.2.5 引导 OpenClaw 使用图像理解和搜索
在对话中提示 OpenClaw：
- **识图**：告知“图像理解优先使用 `mmx vision describe --image <路径>`”。
- **搜索**：告知“网络搜索使用 `mmx search query --q "关键词" --output json` 并解析 JSON 结果”。
之后 OpenClaw 就会自动调用这些命令完成任务。
---
## 6. 总结与后续预告
至此，您已完成所有基础环境搭建，并拥有了：
- **Claude Code**：终端中的 AI 编程助手，可协助写代码、查错。
- **OpenClaw**：可接入微信的自动化 Agent，执行日常任务、回答问题。
- **扩展能力**：通过 MiniMax M3 支持多模态和搜索，让助手更强大。
**后续系列**将分享：
- 如何自定义 OpenClaw 的技能（SKILL）。
- 结合本地知识库实现文献问答。
- 使用 Claude Code 辅助科研数据分析。
---
**注意事项**：
- API 调用均需消耗额度，请按需充值。
- 网关窗口需保持运行，可最小化但勿关闭。
- 若遇到网络问题，检查镜像源或代理设置。
欢迎关注本系列更新，让 AI 真正成为您的科研好帮手！
