前言

在AI工具日新月异的今天,一个真正属于自己的本地AI助手正成为越来越多人的刚需。相比云端AI服务,本地部署的OpenClaw不仅能保护你的隐私数据,还能让你免费获得2000万Tokens的使用额度,打造专属于你的智能工作流。

如果你希望:

  • 在本地拥有一个长期可用的AI助理

  • 避免网络波动带来的影响

  • 深度定制AI工作流

  • 打造稳定高效的生产力工具

那么这篇教程就是为你准备的。接下来,我将以Windows系统为例,手把手带你完成OpenClaw中文版的完整部署。

OpenClaw 是什么?为什么我要折腾它?

简单说,OpenClaw 是一个本地优先的开源 AI 助手框架。它和 ChatGPT 最大的不同是:

  1. 完全本地运行(除了大模型推理,你可以选择本地或云端)

  2. 能连接你的真实数字生活(邮件、日历、文件、笔记等)

  3. 可编程的技能体系(像给手机装 App 一样给它装功能)

  4. 多模态交互(语音、图像、文件都能处理)

我在用了两年 ChatGPT Plus 后,决定试试 OpenClaw。原因很简单:我想要一个真正懂我上下文的 AI,而不是每次都要从头解释的对话机器人。

准备工作

在开始部署前,请确保准备好以下资源:

  1. OpenClaw中文版资源

    • OpenClaw官网(https://openclaw.ai/)

    • OpenClaw中文版GitHub(https://github.com/jiulingyun/openclaw-cn)

    • OpenClaw中文社区(https://clawd.org.cn/)

  2. Windows电脑

    注:如果你没有合适的电脑,可以考虑Windows云主机

    • Windows 10/11系统

    • 8GB以上内存

    • 至少10GB可用空间

  3. AI模型API

    • 本教程使用硅基流动的免费API

    • 新用户可获得2000万Tokens免费额度

    • 你也可以使用OpenAI、Anthropic、智谱AI等其他服务


第一部分:获取2000万免费Tokens

1.1 注册硅基流动账号

我们首先获取免费的AI模型API,硅基流动为新用户提供2000万Tokens的免费额度:

  1. 打开 硅基流动官网(https://cloud.siliconflow.cn/i/EWsFjxva)

  2. 点击注册,创建新账号 

  3. 使用我的邀请码:EWsFjxva(双方都能额外获得Tokens)

1.2 完成实名认证

注册成功后,需要完成实名认证才能领取免费Tokens:

  1. 登录后点击右上角个人中心

  2. 选择认证 → 支付宝扫码认证

  3. 按照提示完成认证(快速且安全)

1.3 创建API密钥

认证通过后,创建你的API密钥:

  1. 进入API密钥管理页面

  2. 点击新建密钥

  3. 复制生成的API密钥(保存好,下一步需要)

注:硅基流动支持多种模型,包括DeepSeek、Qwen、Llama等主流模型。


第二部分:Windows环境部署

2.1 安装Node.js环境

OpenClaw基于Node.js开发,首先需要安装Node.js:

  1. 访问 Node.js官网(https://nodejs.org/zh-cn/download)

  2. 下载 Node.js 22.x LTS 版本(必须≥22.x)

  3. 运行安装程序,务必勾选以下选项

    • ✅ 自动安装必要工具

    • ✅ 添加到PATH环境变量

安装过程中会自动安装npm包管理器。

2.2 验证安装

安装完成后,验证Node.js和npm是否安装成功:

  1. 管理员身份打开PowerShell或CMD

  2. 输入以下命令验证:

# 验证Node.js版本(应为v22.x.x)
node-v

# 验证npm版本(应为10.x.x或更高)
npm-v

图片

如果提示"命令不存在",可能是环境变量问题,重启电脑或手动添加PATH。

2.3 解决权限问题(如遇到)

如果遇到权限问题,执行以下命令:

# 以管理员身份运行PowerShell,执行:
Set-ExecutionPolicyRemoteSigned-ScopeCurrentUser

第三部分:安装OpenClaw中文版

3.1 一键安装脚本

打开管理员权限的PowerShell,OpenClaw 中文社区(https://clawd.org.cn/)  执行一键安装脚本:

图片


iwr -useb https://clawd.org.cn/install.ps1 -OutFile install.ps1; ./install.ps1 -Registry https://registry.npmmirror.com

图片

3.2 初始化配置向导

安装完成后,运行初始化向导:

# 启动配置向导
openclaw-cn onboard --install-daemon

向导会引导你完成以下配置:

  1. 安全风险确认 → 输入"yes"同意

  2. 快速开始选项 → 选择"快速开始"

  3. 模型提供商选择 → 选择"硅基流动(SiliconFlow)"

  4. API密钥输入 → 粘贴刚才复制的API密钥

  5. 模型选择 → 建议选择:

    siliconflow/deepseek-ai/DeepSeek-V3.2

    或使用默认的Qwen2.5-32B模型

  6. 通讯方式配置 → 暂时跳过(后续单独配置)

  7. 技能管理器 → 选择"npm"

  8. 启用钩子 → 暂时跳过

3.3 启动OpenClaw服务

配置完成后,启动OpenClaw服务: 

# 启动网关服务
openclaw-cn gateway

# 或指定端口启动(避免端口冲突)
openclaw-cn gateway --port18789

服务启动后,会自动打开浏览器访问 http://localhost:18789(或你指定的端口)。

3.4 验证安装成功

在浏览器中访问OpenClaw仪表盘,看到以下界面说明安装成功:

  • ✅ 状态显示"已连接"

    图片

  • ✅ 可以正常对话聊天

    图片

  • ✅ 仪表盘功能完整显示



第四部分:常用命令与维护

4.1 日常管理命令

# 查看网关状态
openclaw-cn gateway status

# 启动网关(默认端口)
openclaw-cn gateway

# 指定端口启动
openclaw-cn gateway --port 18789

# 重启网关(应用新配置)
openclaw-cn gateway restart

# 停止网关
openclaw-cn gateway stop

# 查看实时日志
openclaw-cn logs --follow

4.2 配置管理命令

# 重新运行配置向导
openclaw-cn onboard --install-daemon

# 查看当前配置
openclaw-cn config get

# 更换模型
openclaw-cn config setdefaultModel=硅基流动模型ID

# 添加新技能
openclaw-cn skills install <技能名称>

4.3 问题排查命令

# 查看详细日志
openclaw-cn logs --verbose

# 检查网络连接
openclaw-cn doctor

# 重置配置(谨慎使用)
openclaw-cn reset --config

# 更新到最新版本
openclaw-cn update

第五部分:常见问题与解决方案

问题1:安装过程卡住或报错

可能原因:网络连接问题或依赖包下载失败

解决方案

# 1. 设置npm国内镜像
npm config set registry https://registry.npmmirror.com

# 2. 清理缓存重试
npm cache clean --force

# 3. 安装Windows Build Tools
npm install --global windows-build-tools

问题2:服务启动后网页打不开

可能原因:端口被占用或防火墙阻止

解决方案

# 1. 检查端口占用
netstat -ano | findstr :18789

# 2. 换端口启动
openclaw-cn gateway --port 18789

# 3. 关闭防火墙或添加例外
# 控制面板 → Windows Defender防火墙 → 允许应用通过防火墙

问题3:模型响应慢或无响应

可能原因:API密钥错误或额度用尽

解决方案

  1. 检查API密钥是否正确

  2. 登录硅基流动查看剩余Tokens

  3. 更换备用模型或API服务

  4. 检查网络代理设置


写在最后

🎉 恭喜你!部署完成

至此,你已经成功在Windows上部署了OpenClaw中文版,并获得了2000万免费Tokens,还配置了飞书对接。现在你可以:

  1. 在浏览器中访问 http://localhost:18789 使用Web界面

  2. 探索51技能,安装需要的功能插件

  3. 自定义工作流,打造专属AI助理

💡 进阶建议

  1. 定期备份配置:重要的配置可以导出备份

  2. 关注更新:OpenClaw中文版会持续更新,关注GitHub和社区

  3. 参与社区:遇到问题可以在中文社区提问

  4. 贡献技能:如果你有编程基础,可以尝试开发自己的技能

📚 学习资源

  • OpenClaw官方文档

  • OpenClaw中文版GitHub

  • 硅基流动使用指南

🔄 持续优化

部署只是开始,真正的价值在于持续使用和优化。建议:

  1. 第一周:熟悉基本功能,尝试常用技能

  2. 第二周:配置工作流,提高使用效率

  3. 第三周:探索高级功能,定制个人需求

  4. 长期:关注更新,迭代优化


特别提醒:本教程基于2026年3月版本编写,软件可能会有更新。如有疑问,欢迎在评论区交流讨论。

祝使用愉快! 🚀

如果觉得本教程有帮助,欢迎分享给更多需要的人。

Logo

AtomGit 是由开放原子开源基金会联合 CSDN 等生态伙伴共同推出的新一代开源与人工智能协作平台。平台坚持“开放、中立、公益”的理念,把代码托管、模型共享、数据集托管、智能体开发体验和算力服务整合在一起,为开发者提供从开发、训练到部署的一站式体验。

更多推荐