1. 项目概述
OpenClaw是一款基于Node.js开发的AI助手工具，它能够通过命令行界面与多种大语言模型进行交互。作为一个Mac用户，你可能已经厌倦了在各种网页和应用之间切换来使用不同的AI服务。OpenClaw的出现解决了这个问题，它整合了包括Kimi、千问、MiniMax等在内的多个国产大模型供应商，让你可以在终端中直接调用这些强大的AI能力。
2. 环境准备
2.1 Node.js安装
OpenClaw运行需要Node.js环境支持，建议安装Node.js 22或更高版本。以下是详细安装步骤：
- 访问Node.js官网下载页面（https://nodejs.org/zh-cn/download）
- 选择"MacOS Installer(.pkg)"下载最新LTS版本
- 双击下载的.pkg文件开始安装
- 在安装向导中保持默认设置，一路点击"继续"直到安装完成
安装完成后，我们需要验证Node.js和npm是否安装成功。打开终端（可以通过Spotlight搜索"终端"或前往应用程序>实用工具>终端），依次输入以下命令：
node -v npm -v如果安装成功，终端会显示类似这样的版本号：
v22.1.0 10.7.0注意：如果你之前安装过旧版本的Node.js，建议先卸载旧版本再安装新版本，以避免可能的冲突。
2.2 Git安装检查
虽然OpenClaw安装过程中会自动提示安装Git（如果尚未安装），但为了确保安装过程顺利，我们可以提前检查Git是否已安装：
git --version如果显示版本号（如git version 2.39.3），说明Git已安装。如果没有安装，系统会提示你安装Xcode命令行工具，按照提示操作即可。
3. OpenClaw安装与配置
3.1 基础安装
在终端中执行以下命令进行全局安装：
npm install -g openclaw@latest这个命令会从npm仓库下载最新版的OpenClaw并安装到全局环境中。安装过程可能需要几分钟时间，取决于你的网络速度。
安装完成后，可以通过以下命令验证是否安装成功：
openclaw --version3.2 后台服务安装（可选）
如果你希望OpenClaw在后台长期运行并且开机自动启动，可以安装为守护进程：
openclaw onboard --install-daemon这个命令会创建一个后台服务，即使关闭终端窗口，OpenClaw也会继续运行。要停止后台服务，可以使用：
openclaw onboard --stop-daemon4. 初始设置向导
4.1 启动设置
执行以下命令开始初始设置：
openclaw onboard你会看到一个欢迎界面和风险提示，使用键盘方向键选择"Yes"并按回车继续。
4.2 快速开始
在设置向导中，选择"QuickStart"选项进入快速配置模式。这里会引导你完成最基本的配置，包括：
- 模型供应商选择
- API密钥配置
- 基础功能设置
4.3 模型供应商配置
OpenClaw支持多个国产大模型供应商，包括：
- Kimi（Moonshot AI）
- 千问（通义千问）
- MiniMax
- 其他主流国产模型
以Kimi为例进行配置：
- 访问Kimi官网（https://platform.moonshot.cn/）并注册账号
- 完成身份验证（可能需要手机号验证）
- 在控制台创建新的API Key
- 复制生成的API Key
回到OpenClaw设置界面：
- 选择"Moonshot AI(Kimi K2.5)"
- 选择"Kimi Api key(.cn)"
- 粘贴之前复制的API Key
- 按回车确认
提示：Kimi新用户默认有15元免费额度，足够进行初步测试和体验。
5. 高级功能配置
5.1 消息通道设置（可选）
OpenClaw支持将AI响应推送到多种消息通道，如企业微信、Slack等。初次设置可以先跳过这部分，后续再通过配置文件添加。
5.2 Skills安装
Skills是OpenClaw的功能扩展模块，可以为AI添加特定能力。初次设置时可以选择跳过，等熟悉基础功能后再根据需要安装特定Skills。
5.3 长期记忆配置
建议启用"会话级长期记忆"功能，这样AI能记住之前的对话上下文，提供更连贯的交互体验。在设置向导中选择启用此功能即可。
6. 使用OpenClaw
6.1 对话模式选择
安装完成后，OpenClaw提供两种主要对话模式：
- TUI（文本用户界面）：在终端内直接与AI交互
- Web界面：通过浏览器访问本地服务与AI交互
初次使用建议选择TUI模式，体验更原生的命令行交互。
6.2 首次对话
进入对话界面后，OpenClaw会自动发送一条欢迎消息"Wake up, my friend"，你会立即看到AI的回复。这表明所有配置都已正确完成，可以开始使用了。
6.3 基本命令
在TUI界面中，你可以使用以下基本命令：
/help：查看帮助信息/model：切换使用的AI模型/exit：退出对话界面/clear：清空当前对话历史
7. 常见问题与解决
7.1 安装问题
问题1：npm install命令执行失败，提示权限不足
解决：在命令前加上sudo，或使用nvm管理Node.js环境：
sudo npm install -g openclaw@latest或者更好的解决方案是修复npm的权限：
mkdir ~/.npm-global npm config set prefix '~/.npm-global'然后将以下内容添加到你的shell配置文件（如~/.zshrc或~/.bashrc）：
export PATH=~/.npm-global/bin:$PATH问题2：安装过程中卡住不动
解决：可能是网络问题，尝试切换npm源：
npm config set registry https://registry.npmmirror.com然后重新运行安装命令。
7.2 运行问题
问题1：openclaw命令找不到
解决：可能是Node.js全局安装路径不在系统PATH中。尝试以下方法：
- 找出npm全局安装路径：
npm config get prefix- 确保该路径在系统的PATH环境变量中
问题2：API Key无效或请求失败
解决：
- 确认API Key是否正确复制，前后没有多余空格
- 检查对应平台的控制台，确认API Key是否已启用
- 尝试重新生成API Key并配置
7.3 性能优化
如果发现响应速度慢，可以尝试：
- 选择离你地理位置更近的模型供应商
- 检查网络连接，确保没有代理设置干扰
- 在OpenClaw配置中使用更轻量级的模型版本
8. 进阶使用技巧
8.1 自定义配置文件
OpenClaw的配置文件通常位于~/.openclaw/config.json，你可以手动编辑这个文件来调整各种设置，如：
- 默认模型
- 温度参数（控制回答的创造性）
- 最大token数（控制回答长度）
- 代理设置
修改配置文件后需要重启OpenClaw使更改生效。
8.2 快捷键使用
在TUI界面中，可以使用以下快捷键提高效率：
Ctrl + L：清屏Ctrl + C：中断当前生成↑/↓：浏览历史命令Tab：自动补全命令
8.3 对话历史管理
OpenClaw会自动保存对话历史，位置通常在~/.openclaw/history/。你可以：
- 查看历史对话记录
- 导出特定对话为Markdown或文本格式
- 删除不需要的历史记录
9. 安全注意事项
- API Key是敏感信息，不要分享或上传到公开仓库
- 定期轮换API Key，特别是发现异常使用时
- 如果不再使用OpenClaw，记得在模型供应商的控制台中撤销API Key
- 注意OpenClaw的权限设置，特别是当配置了消息推送功能时
10. 卸载OpenClaw
如果需要卸载OpenClaw，可以执行以下步骤：
- 停止所有OpenClaw进程：
openclaw onboard --stop-daemon- 卸载全局包：
npm uninstall -g openclaw- 删除配置文件和历史记录（可选）：
rm -rf ~/.openclaw11. 实际使用体验分享
在实际使用OpenClaw几周后，我发现以下几个特别有用的场景：
- 快速查询：在终端中直接提问获取信息，比打开浏览器搜索更快
- 代码辅助：让AI解释或生成代码片段，特别适合学习新语言或框架时
- 内容草拟：快速生成邮件、文档的初稿，然后进行人工润色
- 语言学习：与AI进行外语对话练习，随时纠正语法错误
一个实用技巧是：为常用查询创建别名（alias）。例如，在shell配置文件中添加：
alias ask='openclaw ask -q'然后就可以直接在终端中使用：
ask "如何用Python读取CSV文件"这大大提高了使用效率。另一个建议是：定期检查各模型供应商的剩余额度，避免突然无法使用。可以在配置文件中设置多个API Key，当主Key额度用尽时自动切换备用Key。
