乐于分享
好东西不私藏

5 分钟上手 OpenClaw:AI 助手部署完全指南

5 分钟上手 OpenClaw:AI 助手部署完全指南

痛点场景

上周有个做电商的朋友找我,说想给公司部署个 AI 助手,结果折腾了整整一周还没跑通。

你有没有遇到过这种情况:

  • 想试试 AI 助手,但看到一堆代码和配置文件就头大
  • 好不容易装好了,结果 API 配置不对,根本用不了
  • 好不容易能用了,发现只能回答问题,干不了实际工作

说实话,这不是你技术问题。是大部分 AI 助手工具的设计思路就有问题——把简单的事情搞复杂了。

关键认知: OpenClaw 的核心价值不是"又一个 AI 聊天工具",而是"能真正帮你干活的智能助手"。部署不应该超过 5 分钟。

核心思路

OpenClaw 的部署逻辑其实就三步:装环境→配 API→连通道。

别被那些专业术语吓到。我按最笨的方式给你拆解,保证你能跟上。

步骤 1:安装 OpenClaw

打开终端(Windows 用户用 PowerShell),执行一条命令:

git clone https://github.com/easyclaw/OpenClaw.git
cd OpenClaw
npm install

操作要点:

  • 确保你安装了 Node.js(v18 以上),没有的话去 nodejs.org 下载安装
  • 如果下载慢,可以用国内镜像:npm install --registry=https://registry.npmmirror.com
  • 整个过程大概 2-3 分钟,取决于你的网速

注意事项: 如果报"权限错误",在命令前加 sudo(Mac/Linux)或用管理员身份运行 PowerShell(Windows)。

看到 added XXX packages 的提示,说明安装成功。

步骤 2:配置大模型 API

OpenClaw 本身是个框架,需要接大模型才能工作。国内最稳定的是阿里云通义千问。

具体操作:

  1. 打开 https://dashscope.console.aliyun.com/[1]
  2. 注册/登录账号(新用户送 100 万 token 额度)
  3. 进入"API-KEY 管理",创建一个 API Key
  4. 复制这个 Key,等下要用

然后在 OpenClaw 目录下创建配置文件:

# Linux/Mac
cp .env.example .env
nano .env

# Windows
copy .env.example .env
notepad .env

把内容改成这样:

DASHSCOPE_API_KEY=你的 API_KEY
MODEL_NAME=qwen-plus

参数说明:

  • DASHSCOPE_API_KEY:刚才复制的 API Key
  • MODEL_NAME:模型名称,qwen-plus 是性价比最高的选择(0.008 元/千 token)

验证方法: 执行 echo $DASHSCOPE_API_KEY(Windows 用 echo %DASHSCOPE_API_KEY%),能看到你刚才填的 Key 就说明配置对了。

步骤 3:连接飞书机器人(可选但推荐)

如果你想让 OpenClaw 在飞书里随叫随到,需要配置飞书机器人。

具体操作:

  1. 打开飞书,进入你要添加机器人的群
  2. 右上角"..."→"添加机器人"→"自定义机器人"
  3. 给机器人起个名字(比如"OpenClaw 助手")
  4. 复制 Webhook 地址,长这样:https://open.feishu.cn/open-apis/bot/v2/hook/xxxxx

然后在 .env 文件里加上:

FEISHU_WEBHOOK_URL=你的 Webhook 地址

常见问题:

  • Q:一定要用飞书吗?A:不是。飞书只是最方便的通道,你也可以用企业微信、钉钉,或者直接命令行使用
  • Q:没有飞书怎么办?A:跳过这步,OpenClaw 可以直接在终端运行,功能不受影响

步骤 4:启动并测试

配置完成,启动 OpenClaw:

npm start

看到 OpenClaw 已就绪 的提示,说明一切正常。

测试一下:

在对话框输入:

今天北京天气怎么样?

如果 OpenClaw 能正常回答,恭喜你,部署成功!

进阶测试:

帮我查一下最近 7 天的 AI 行业热点,整理成表格

这个命令会测试 OpenClaw 的联网搜索和信息整理能力。如果能返回结构化的结果,说明你的配置完全正确。

总结

回顾要点:

  1. 安装 OpenClaw 只需要 git clone + npm install 两条命令
  2. API 配置最关键,通义千问新用户有免费额度
  3. 飞书机器人是可选的,但能大幅提升使用体验

行动建议: 现在就打开终端,执行第一步。5 分钟后,你将拥有一个随叫随到的智能助手。


部署过程中遇到问题?评论区说说你卡在哪一步。 觉得有用?分享给那个一直想试试 AI 助手的朋友。

引用链接

[1]https://dashscope.console.aliyun.com/