🦞 2026 最火开源 AI Agent · GitHub 24 万星

OpenClaw 小白教程

从零开始，手把手教你养一只属于自己的 AI 龙虾管家。发条消息就能帮你干活，不用写代码，会打字就行。

替你做事

聊天即操作

开源免费

本地运行

🤔 OpenClaw 到底是啥？一句话解释

OpenClaw = 住在你电脑里的 AI 管家。你用手机给它发消息，它就帮你在电脑上干活。

打个比方：

ChatGPT 就像一个很聪明但没有手的朋友 — 你问它什么它都能回答，但它不能帮你做任何事，只能"动嘴"
OpenClaw 就像一个又聪明又有手的机器人管家 — 不仅能回答问题，还能直接在你电脑上操作：整理文件、写文档、发邮件、做表格、甚至帮你写代码

具体能帮你做什么？

帮你处理文件 — "帮我把桌面上的文件按类型分类整理"
帮你写东西 — "帮我写一篇 800 字的读书笔记"
帮你上网查资料 — "帮我搜一下明天的天气预报"
帮你做定时任务 — "每天早上 7 点提醒我背单词"
记住你的一切 — 越用越懂你，不会忘记你之前说过的话

而且它是完全免费、开源的（GitHub 上 24 万星），数据都存在你自己电脑里，不用担心隐私问题。

🎮 用游戏来理解 OpenClaw

如果你玩过游戏，可以这样理解 OpenClaw 的各个部分：

OpenClaw 组件	游戏类比	白话解释
OpenClaw 本体	游戏角色的身体	跑在你电脑上的程序，负责接收指令、执行任务
AI 模型	角色的大脑/智力	让龙虾变聪明的"大脑"，比如 DeepSeek、通义千问
Skills 技能	角色的技能树	给龙虾"学"新本领，比如收发邮件、浏览网页
聊天平台	和角色对话的窗口	你通过飞书/钉钉/网页给龙虾发指令
记忆 Memory	角色的经验值	用得越多越懂你，会记住你的偏好和习惯

你发消息
"帮我整理文件"

→

飞书 / 钉钉 / 网页

→

🦞 OpenClaw
你的龙虾管家

→

AI 大脑
DeepSeek 等

🤷 我适合用 OpenClaw 吗？

你想要一个帮你干活的 AI 助手，而不只是聊天 → 适合！
你经常需要整理文件、写文档、查资料 → 很适合！
你是学生，想让 AI 帮你学习、做笔记、练英语 → 非常适合！
你只是想聊天解闷 → 直接用 ChatGPT/豆包就够了

✦

OpenClaw 能帮你做什么？

OpenClaw 的 slogan 是 "The AI that actually does things"（真正帮你做事的 AI）。不管你是学生、打工人还是自由职业者，它都能帮上忙。下面是一些真实的使用场景：

📚 学生党：学习助手

OpenClaw 可以当你的私人家教，帮你学习、做笔记、练英语。

飞书 — OpenClaw

你：帮我把课本第三章的重点整理成思维导图式的笔记，保存成 PDF 🦞 OpenClaw：好的，我来帮你整理。 📝 已生成"第三章核心知识点笔记.pdf" 包含： • 知识点层级结构（大标题→小标题→要点） • 每个知识点的一句话总结 • 易错点标注和记忆技巧文件已保存到桌面 ✅

你还可以说："帮我出 10 道这章的选择题测试一下"、"用英语跟我练口语对话"、"帮我解释一下这道数学题的解题思路"。

📱 在聊天软件里指挥 AI 干活

你在 Telegram / WhatsApp 里发一条消息，OpenClaw 就帮你在电脑上执行。

Telegram — OpenClaw

你：帮我看看桌面上有哪些 PDF 文件，把它们都移到"文档"文件夹里 🦞 OpenClaw：找到 7 个 PDF 文件： • 合同-2026.pdf • 发票-03月.pdf • 会议纪要.pdf ... 已全部移动到 ~/Documents/ 文件夹中 ✅

📧 邮件自动处理

连接邮箱后，OpenClaw 可以帮你自动分类、回复和总结邮件。

Telegram — OpenClaw

你：帮我看看今天有什么重要邮件，总结一下 🦞 OpenClaw：今天共收到 23 封邮件，其中重要的有 3 封： 1. 来自张经理：项目验收会议改到周五下午 3 点 2. 来自 HR：本月绩效考核表需要在周三前提交 3. 来自客户王总：询问报价单更新进度需要我帮你起草回复吗？

🌐 自动浏览网页

OpenClaw 内置浏览器自动化能力，可以帮你上网搜资料、填表单、下载文件。

Telegram — OpenClaw

你：帮我搜一下最近一周关于"AI Agent"的新闻，整理成一份简报 🦞 OpenClaw：正在搜索相关新闻... 📰 AI Agent 周报（2026.03.03 - 03.09） 1. OpenAI 发布新版 Agent SDK，支持多工具协作 2. 中国发布首个 AI Agent 管理政策征求意见稿 3. ... 完整简报已保存为 ai-weekly-report.md ✅

⏰ 定时任务和提醒

让 OpenClaw 定期帮你做事，或者到时间提醒你。

Telegram — OpenClaw

你：每天早上 9 点帮我看一下今天的天气预报和日历安排，发给我 🦞 OpenClaw：好的，已设置每日 9:00 的定时任务 ✅ 每天早上我会给你发送： • 今日天气预报 • 今日日历安排 • 待办事项提醒

💻 写代码也不在话下

当然了，OpenClaw 也能帮你写代码、做网页、处理数据。

Telegram — OpenClaw

你：帮我写一个 Python 脚本，把 data.csv 里的数据做成柱状图 🦞 OpenClaw：已创建 chart.py 并执行完成 ✅ 📊 图表已保存为 output_chart.png 要我发送图片给你看看效果吗？

一句话总结：OpenClaw 就像一个 7x24 小时在线的机器人管家。你在手机上发条消息，它就在你电脑上帮你把事情办了。开源免费，数据都在你自己手里。不需要会写代码，会打字就能用。

命令行入门（完全小白必看）

安装 OpenClaw 需要用一小会儿命令行（也叫终端 / Terminal）。这可能是你第一次用，但真的非常简单。你只需要用它安装一次，以后日常使用都是在聊天软件/网页里操作的。

先深呼吸放松一下！命令行看起来黑乎乎的很吓人，但它其实特别"笨" — 你不输入东西它什么都不会做。就算你乱打一通也不会弄坏电脑。而且你只需要用它复制粘贴几条命令就行，根本不需要记住任何东西。

🤔 命令行是什么？30 秒看懂

你平时怎么操作电脑？用鼠标点来点去对吧。命令行就是另一种操作电脑的方式 — 用打字代替鼠标点击。

举个例子，同样是"打开桌面上的一个文件夹"：

操作	鼠标党的做法	命令行的做法
打开文件夹	双击文件夹图标	输入 `cd 文件夹名`
看看里面有啥	打开文件夹看一眼	输入 `ls`
新建文件夹	右键 → 新建文件夹	输入 `mkdir 文件夹名`

是不是没那么可怕？而且你只需要会复制粘贴就行，不需要手打。

📖 第一步：打开命令行（跟着做，10 秒搞定）

最快方式（3 秒）：

同时按下键盘上的 Command（⌘）键和空格键
屏幕中间会弹出一个搜索框
输入 Terminal（或者输"终端"也行）
按回车 → 一个黑/白色的窗口弹出来了，这就是命令行！

也可以打开 访达(Finder) → 应用程序 → 实用工具 → 双击 终端(Terminal)。

推荐方式：安装 Git Bash（OpenClaw 在 Windows 上推荐用这个）

去 git-scm.com/downloads 下载安装 Git for Windows
安装时一路点"Next"用默认设置就行
安装完后，在桌面右键 → 你会看到"Git Bash Here" → 点它就打开了

备选方式：在键盘上按 Win 键，输入 PowerShell，点击打开。

同时按下 Ctrl + Alt + T 就打开了。或者在应用菜单中搜索 "Terminal"。

⌨️ 你只需要记住的几个命令

命令	作用	举例
`cd 目录名`	进入某个文件夹	`cd ~/Desktop`
`ls`	查看当前文件夹里有什么	`ls`
`pwd`	显示当前路径	`pwd` → `/Users/zhangsan`

记住这三个就够了。安装好 OpenClaw 之后，日常使用是通过聊天软件，不需要再碰终端。

看到 $ 或 % 符号？ 那是命令行在跟你说"我准备好了，你可以输入了"。你不需要自己打这个符号，只打后面的内容就行。

怕输错？完全不用怕！

输错了 → 按 Ctrl + C 取消，重新来
屏幕乱了 → 输入 clear 清屏
卡住了 → 按 Ctrl + C 强制停止
想退出 → 输入 exit 或直接关掉窗口

命令行不会因为你输错而弄坏电脑。最坏的情况就是报错，然后你重新输就好了。放心大胆地试！

好消息：你只需要用命令行安装这一次。装好之后，日常使用 OpenClaw 都是在网页/聊天软件里操作的，再也不用碰命令行了（除非你想）。

准备工作

别被下面的列表吓到 — 大部分东西你已经有了，或者安装过程会自动帮你搞定。

📦 你需要准备的东西

项目	说明	怎么获得
电脑	macOS / Linux / Windows 都行	你正在用的就行
Node.js 22+	OpenClaw 依赖 Node.js 运行	见下方安装教程
AI 模型的 API Key	让 AI 工作的"钥匙"	DeepSeek / 通义千问 / 硅基流动等（详见下方配置 AI 模型章节）
聊天软件账号	用来和 OpenClaw 对话	飞书（推荐）/ 钉钉 / 微信 / Web UI

国内用户推荐方案：

AI 模型：选 通义千问 Qwen（有免费额度，最省心）或 DeepSeek（10 元用很久，性价比最高）
聊天平台：选飞书（设置简单）或钉钉（大部分人都有），也可以先用 Web UI（浏览器直接用，不需要任何额外配置）

没有翻墙工具也完全没问题！本教程的所有操作都基于国内可直接访问的服务，不需要 VPN 或代理。AI 模型用国产的（DeepSeek、通义千问），聊天平台用国内的（飞书、钉钉、微信），全程畅通无阻。

关于 Node.js 版本：OpenClaw 要求 Node.js v22 或以上（比 Claude Code 要求更高）。如果你之前装过旧版 Node.js，需要升级。

安装 OpenClaw

给纯小白的最短路径（3 步搞定）：

打开终端（上面教过了）
复制下面"一键脚本"里的那一条命令，粘贴到终端里，按回车
等 2-5 分钟，跟着弹出来的向导选就行

就这么简单。下面是详细说明，遇到问题再看。

最简单的方式！一条命令搞定，会自动检测系统、安装 Node.js 和所有依赖。

打开终端，运行安装命令

bash

curl -fsSL https://openclaw.ai/install.sh | bash

PowerShell（以管理员身份运行）：

powershell

irm https://openclaw.ai/install.ps1 | iex

等待安装完成

脚本会自动安装 Node.js（如果没有的话）和 OpenClaw，通常需要 2-5 分钟。安装完成后会自动进入配置向导。

Terminal

$ curl -fsSL https://openclaw.ai/install.sh | bash Detecting system... macOS arm64 Installing Node.js 22... ✅ Installing OpenClaw v2026.3.2... ✅ 🦞 OpenClaw installed successfully! Starting onboard wizard...

如果你已经有 Node.js 22+，可以直接用 npm 安装。

先确认 Node.js 版本

bash

node -v # 必须是 v22.x.x 或更高

如果版本低于 22，需要先升级 Node.js：

bash — Mac (Homebrew)

brew install node@22

安装 OpenClaw

bash

npm install -g openclaw@latest

国内用户网速慢？加上淘宝镜像源：

bash

npm install -g openclaw@latest --registry=https://registry.npmmirror.com

启动配置向导

bash

openclaw onboard --install-daemon

这条命令做了什么？

openclaw onboard — 启动交互式配置向导
--install-daemon — 同时安装后台服务，让 OpenClaw 开机自动运行

适合有服务器（VPS）的用户，或者想在 Docker 容器中隔离运行的用户。需要先安装 Docker。

克隆仓库并运行安装脚本

bash

git clone https://github.com/openclaw/openclaw.git
cd openclaw
./docker-setup.sh

或使用预构建镜像

bash

export OPENCLAW_IMAGE="ghcr.io/openclaw/openclaw:latest"
./docker-setup.sh

国内用户如果拉取 GitHub 镜像慢，可以使用汉化版 Docker 镜像：

bash — 汉化版

docker pull 1186258278/openclaw-zh:latest

验证安装成功

bash

openclaw --version

Terminal

$ openclaw --version v2026.3.2 ← 看到版本号就说明安装成功了！

安装遇到问题？

EACCES: permission denied — 在命令前加 sudo，或配置 npm 权限
command not found — 关闭终端重新打开，或检查 npm 全局路径是否在 PATH 中
sharp 安装失败 — 运行 SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest
有其他问题 — 运行 openclaw doctor --fix 自动诊断修复

配置向导（最重要！）

安装完成后会自动进入 openclaw onboard 配置向导。这是一个交互式的问答流程 — 它问你问题，你选答案，就像填问卷一样简单。跟着走就行，选错了也没关系，以后随时可以重新配。

小白最快通关路线：风险提示选 Yes → 安装模式选 QuickStart → AI 模型选 Qwen（不需要 API Key）→ 聊天平台选 None → Skills 跳过 → 完成！全程 1 分钟。

接受风险提示

OpenClaw 会提醒你它有权限操作你的电脑文件。阅读后选择 Yes 继续。

选择安装模式

新手直接选 QuickStart（快速启动），它会用推荐的默认配置。

选择 AI 模型

这一步选择给 OpenClaw "装哪个大脑"。国内推荐：

模型	特点	价格
DeepSeek	国内直连，性价比最高	极便宜（几毛钱/天）
通义千问 Qwen	阿里出品，中文理解好，有免费额度	有免费额度
Kimi (Moonshot)	长文本处理专家	中等
Claude / GPT	能力最强，但需要翻墙或代理	较贵

新手推荐：选 Qwen（通义千问）最省心。选了之后会跳转到登录页面，授权一下就行，不需要自己去申请 API Key。选 DeepSeek 最便宜但需要自己去 DeepSeek 平台注册获取 API Key。

输入 API Key

根据你选的模型，输入对应的 API Key。向导会提示你去哪里获取。

选择聊天平台

选择你想通过哪个聊天软件和 OpenClaw 对话（国内用户推荐）：

飞书（Lark） — 国内推荐，Bot 设置简单
钉钉（DingTalk） — 大部分人都有，企业常用
None — 先跳过也行！后面可以直接用浏览器打开 Web UI 使用，完全不需要配聊天软件

小白建议：如果你不想折腾聊天平台配置，直接选 None。安装完成后用浏览器访问 http://localhost:18789 就能用了，和网页版 ChatGPT 一样方便。等熟悉了再去配飞书/钉钉也不迟。

配置技能（Skills）

用空格键勾选你需要的技能。不确定的话直接跳过，后面随时可以加。

完成！

向导结束后，OpenClaw 会自动启动 Gateway 服务在后台运行。你现在可以去聊天软件里给它发消息了！

第一次运行

🎉 恭喜你成功养了一只 AI 龙虾！

打开浏览器，访问 http://localhost:18789（或者打开你配置好的聊天软件），试着发句话：

Telegram — OpenClaw Bot

你：你好！自我介绍一下 🦞 OpenClaw：你好！我是 OpenClaw，你的 AI 私人助手 🦞 我运行在你的电脑上，可以帮你： • 管理文件和文件夹 • 执行终端命令 • 浏览网页和搜索信息 • 处理邮件和日程 • 写代码和处理数据 • 定时执行任务有什么需要帮忙的吗？

看到回复就说明一切配置正确，你的龙虾管家已经上线了！

🎯 接下来可以试试这些指令

不知道跟龙虾说什么？试试复制下面这些发给它：

试试文件操作："帮我看看桌面上有哪些文件"
试试写东西："帮我写一首关于春天的诗，保存到桌面"
试试查信息："今天是几号星期几？"
试试做任务："帮我创建一个叫 test 的文件夹，里面放一个 hello.txt 文件，内容写'你好世界'"
试试学习助手："用简单的语言给我解释一下什么是光合作用"

基本上你能想到的，都可以试着让它帮你做。它做不到的会告诉你，不会假装能做。

🌐 也可以用 Web 界面

OpenClaw 还提供了一个 Web 管理界面，在浏览器中打开：

浏览器地址栏
http://localhost:18789

首次访问需要用 Token 认证（在终端安装完成时会显示 Token URL）。

如果收不到回复，请检查：

OpenClaw Gateway 是否在运行（终端输入 openclaw gateway status）
API Key 是否正确且有余额
聊天平台是否配置成功（Telegram Bot Token 等）

接入聊天平台

OpenClaw 支持多种聊天平台。国内用户不需要翻墙，下面的方案都可以直接用。

最简单的方式：先用 Web UI！OpenClaw 安装完成后自带一个网页界面，在浏览器打开 http://localhost:18789 就能直接对话，不需要配任何聊天平台。等你用熟了，再考虑接入飞书/钉钉，这样出门在外也能用手机控制 AI。

Web UI 是 OpenClaw 自带的网页界面，不需要任何额外配置，安装完就能用。

打开浏览器

在浏览器地址栏输入：

浏览器地址栏
http://localhost:18789

输入 Token 认证

首次访问需要输入 Token。这个 Token 在你安装 OpenClaw 完成时会在终端里显示，类似这样：

终端输出示例
Web UI: http://localhost:18789?token=abc123def456

直接点击那个带 ?token=xxx 的完整链接，或者手动复制 token 粘贴到页面上。

开始对话

进入后就是一个聊天界面，和网页版 ChatGPT 差不多。直接打字发消息就行！

想在手机上用？如果你的电脑和手机在同一个 WiFi 下，可以用手机浏览器访问 http://电脑内网IP:18789。电脑的内网 IP 可以在终端输入 ifconfig | grep "inet "（Mac/Linux）查看，通常是 192.168.x.x 开头的。

飞书（Lark）适合国内用户。需要在飞书开放平台创建一个"机器人应用"。下面是保姆级教程：

注册飞书开放平台

打开 open.feishu.cn，用你的飞书账号登录。如果还没有飞书账号，先去 feishu.cn 注册一个（手机号就能注册，免费的）。

创建应用

登录后，点击 "创建企业自建应用"：

应用名称：随便写，比如 我的AI助手
应用描述：随便写，比如 OpenClaw AI Agent
创建完成后，你会看到 App ID 和 App Secret，把它们复制保存好

开启机器人能力

在应用详情页面，左侧菜单找到 "添加应用能力"，点击 "机器人" 开启。

配置到 OpenClaw

bash
# 配置飞书 App ID
openclaw config set 'channels.lark.appId' '你的App ID'

# 配置飞书 App Secret
openclaw config set 'channels.lark.appSecret' '你的App Secret'

# 重启让配置生效
openclaw gateway restart

发布应用并测试

回到飞书开放平台，点击 "版本管理与发布"，创建一个版本并发布。发布后在飞书里搜索你的机器人名字，就可以发消息对话了！

钉钉（DingTalk）适合大部分国内用户，几乎人人都有钉钉账号。

进入钉钉开放平台

打开 open.dingtalk.com，用钉钉账号登录。

创建机器人应用

点击 "应用开发" → "企业内部开发" → "创建应用"：

应用名称：比如 AI助手
创建后获取 AppKey 和 AppSecret
在 "消息推送" 设置中，开启消息接收地址

配置到 OpenClaw

bash

# 配置钉钉
openclaw config set 'channels.dingtalk.appKey' '你的AppKey'
openclaw config set 'channels.dingtalk.appSecret' '你的AppSecret'

# 重启
openclaw gateway restart

测试

在钉钉里搜索你创建的机器人名字，发送一条消息测试。

微信是国内最常用的聊天工具，但接入方式相对复杂一些。

注意：微信官方没有开放个人聊天机器人接口，OpenClaw 通过 Web 微信协议接入。这种方式有封号风险（微信可能检测到自动化行为），建议使用小号。

在 onboard 向导中选择 WeChat

向导会显示一个二维码，用你的微信小号扫码登录即可绑定。

发消息测试

用你的大号给小号发消息，小号（OpenClaw）会自动回复。也可以把小号拉进群聊，在群里 @它来使用。

替代方案：如果不想冒微信封号风险，可以用企业微信（有官方机器人 API），或者直接用 Web UI + 飞书/钉钉的方案。

OpenClaw 还支持这些平台（部分需要翻墙）：Telegram、WhatsApp、Discord、Slack、Signal、iMessage、Microsoft Teams、LINE 等 20+ 个平台。详情见官方文档。

技能（Skills）

Skills 是 OpenClaw 的"超能力模块"。还记得前面的游戏类比吗？Skills 就是技能树 — 每学一个新技能，龙虾就多一项本领。

🧩 什么是 Skill？

Skill 就像手机里的 App。OpenClaw 本身是操作系统，Skill 是安装在上面的应用程序。

邮件 Skill — 让 OpenClaw 能收发和管理邮件
日历 Skill — 让 OpenClaw 能查看和管理你的日程
浏览器 Skill — 让 OpenClaw 能自动浏览网页
文件管理 Skill — 让 OpenClaw 能操作你的文件
代码 Skill — 让 OpenClaw 能写代码和执行脚本

📦 怎么安装 Skill？

你可以在 skills.sh 上搜索你想要的技能，或者直接让 OpenClaw 帮你安装：

Telegram — OpenClaw

你：帮我安装一个天气查询的技能 🦞 OpenClaw：已安装 weather-skill ✅ 现在你可以问我天气了！试试发"今天北京天气怎么样"

也可以用命令行管理：

bash

# 查看已安装的技能
openclaw skills

# 安装新技能
openclaw skills install weather-skill

安全提醒：只从可信来源安装 Skill。第三方 Skill 有可能包含恶意代码。安装前建议查看 Skill 的源代码和社区评价。

配置 AI 模型（重点！）

OpenClaw 本身只是一个"身体"，它需要一个 AI 大脑才能工作。你需要给它接一个"大脑"，也就是 AI 大模型。

🤔 先搞懂：什么是 API Key？

你可以把 API Key 理解为一把"钥匙"。AI 大模型（比如 DeepSeek、通义千问）运行在云端服务器上，你需要一把钥匙才能用它。这把钥匙就是 API Key —— 一串像密码一样的字符串。

流程是这样的：

你发消息

→

OpenClaw
带着你的 API Key

→

AI 模型服务器
验证钥匙，返回回答

所以你需要做两件事：1) 去 AI 平台注册获取 API Key；2) 把 API Key 填到 OpenClaw 的配置里。下面手把手教你。

适合谁？先想免费试试、不想花钱、或者对隐私要求极高的用户。以下所有方案国内都能直接用，不需要翻墙。

选项 1：通义千问 Qwen — 新手首选，注册就送免费额度

阿里云的通义千问（Qwen）提供了免费的 API 调用额度。注册就送，个人日常使用完全够用。不需要装任何东西，云端运行，效果很好，国内直连，速度快。

免费额度有多少？新用户注册通常会送 100 万～数百万 Token 的免费额度（具体以平台最新活动为准）。日常聊天使用的话，够你免费用好几个月。

打开阿里云百炼平台

在浏览器中打开：bailian.console.aliyun.com

如果你有支付宝或淘宝账号，可以直接扫码登录，不需要额外注册。没有的话用手机号注册一个阿里云账号也很快。

开通百炼服务

首次登录会提示你"开通百炼大模型服务"，点同意并开通就行（免费开通，不会扣钱）。

创建 API Key

开通后，在页面左上角或左侧菜单找到 "API-KEY 管理"（也可能叫"API Key"），点进去：

点 "创建新的 API-KEY"
系统会生成一串以 sk- 开头的字符串，这就是你的 API Key
重要：复制保存好！这个 Key 只会显示一次，关掉页面就看不到了。建议先粘贴到记事本里

API Key 是你的"密码"，不要泄露给别人！谁拿到这个 Key 就能用你的额度调用 AI。不要发到群里、不要截图发朋友圈。

把 API Key 配置到 OpenClaw

回到终端，输入下面的命令。注意把 sk-你的API Key 替换成你刚才复制的那串真实的 Key：

bash

openclaw config set 'models.providers.qwen' --json '{
  "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1",
  "apiKey": "sk-你的API Key",
  "models": {
    "default": "qwen-plus"
  }
}'

逐行解释这个命令：

baseUrl — AI 模型服务器的地址，这里是阿里云的地址，不要改
apiKey — 你刚才在阿里云创建的那串 Key，替换成你自己的
default — 使用哪个模型，qwen-plus 是性价比最高的选择

重启 OpenClaw 并测试

bash

openclaw gateway restart

然后去 Web UI（http://localhost:18789）或者聊天软件里发一条消息，收到回复就说明配置成功了！

通义千问有哪些模型可以选？

模型名	特点	建议
`qwen-turbo`	速度最快，便宜	简单对话、快速回复
`qwen-plus`	速度和效果兼顾	推荐！日常使用首选
`qwen-max`	效果最好，速度较慢	处理复杂任务时用

想换模型？把上面命令里的 qwen-plus 改成别的模型名就行。

选项 2：硅基流动 SiliconFlow — 多种免费模型随便用

硅基流动（SiliconFlow）是国内的 AI 模型聚合平台，注册就送额度，而且有些模型永久免费。一个账号就能用 DeepSeek、Qwen、Llama 等多种模型。国内直连，不需要翻墙。

注册账号

打开 cloud.siliconflow.cn，用手机号注册，非常简单。注册完成后会自动赠送免费额度。

创建 API Key

登录后，在左侧菜单找到 "API 密钥"，点 "新建 API 密钥"，复制保存好生成的 Key。

配置到 OpenClaw

bash

openclaw config set 'models.providers.siliconflow' --json '{
  "baseUrl": "https://api.siliconflow.cn/v1",
  "apiKey": "sk-你的SiliconFlow API Key",
  "models": {
    "default": "deepseek-ai/DeepSeek-V3"
  }
}'

重启并测试

bash

openclaw gateway restart

硅基流动上有哪些免费/便宜模型？

模型名	说明	价格
`deepseek-ai/DeepSeek-V3`	DeepSeek 最新版，中文效果好	极便宜
`Qwen/Qwen2.5-7B-Instruct`	通义千问 7B 版	免费
`THUDM/glm-4-9b-chat`	智谱 GLM-4	免费

具体哪些模型免费以平台最新列表为准，登录后在"模型广场"可以看到。

选项 3：Ollama — 在自己电脑上跑 AI（完全离线）

Ollama 让你在自己电脑上运行开源大模型，完全免费、完全离线、数据不出本地。适合对隐私要求极高、或者网络条件不好的用户。

硬件要求比较高！本地跑 AI 需要较好的电脑配置：

8GB 内存 — 勉强能跑 7B 小模型，效果一般，回复慢
16GB 内存 — 可以跑 7B-14B 模型，效果还行
32GB+ 内存 — 可以跑 32B 模型，效果很好
有 Apple M 系列芯片（MacBook Air M1/M2/M3/M4）或 NVIDIA 显卡 会快很多

如果你的电脑配置不高，建议用上面的通义千问或硅基流动方案（云端运行，对电脑没要求）。

安装 Ollama

去 ollama.com/download 下载 Mac 版安装包（.dmg 文件），双击打开，把 Ollama 拖到"应用程序"文件夹即可。

安装完成后，在启动台（Launchpad）里打开 Ollama，它会在菜单栏出现一个小图标，说明已经在后台运行了。

bash

curl -fsSL https://ollama.com/install.sh | sh

去 ollama.com/download 下载 Windows 版安装包（.exe 文件），双击运行安装。

下载一个 AI 模型

打开终端，运行以下命令下载模型（第一次需要下载几个 GB 的文件，耐心等待）：

bash — 选一个运行即可

# 推荐：通义千问 7B（4.7GB，中文效果好，8GB 内存就能跑）
ollama pull qwen2.5:7b

# 电脑好的话试试 14B 版本（9GB，效果更好，需要 16GB 内存）
ollama pull qwen2.5:14b

下载完成后可以先试试效果：输入 ollama run qwen2.5:7b，然后直接打字对话。输入 /bye 退出。

配置 OpenClaw 使用 Ollama

Ollama 安装后会在你电脑本地启动一个 API 服务（地址是 http://localhost:11434），OpenClaw 可以直接连上去用：

bash

openclaw config set 'models.providers.ollama' --json '{
  "baseUrl": "http://localhost:11434/v1",
  "apiKey": "ollama",
  "models": {
    "default": "qwen2.5:7b"
  }
}'

apiKey 这里随便填什么都行（本地运行不需要密钥），但不能留空，所以写个 ollama 占位。

重启并测试

bash

# 确认 Ollama 在运行（应该能看到你下载的模型）
ollama list

# 重启 OpenClaw
openclaw gateway restart

去 Web UI 发条消息试试，能收到回复就说明成功了！本地模型回复速度取决于你的电脑配置，可能需要等几秒到几十秒。

总结：免费方案怎么选？

最省心，什么都不懂就选这个 → 通义千问（支付宝登录就行）
想免费试多种模型 → 硅基流动（一个平台用多种模型）
不想联网、隐私第一 → Ollama（需要电脑配置好）

适合谁？愿意花一点小钱换更好的效果，或者需要长期稳定使用的用户。以下前两个方案国内直连，不需要翻墙。

选项 1：DeepSeek — 国内首选，10 元用很久

DeepSeek 是国内最火的 AI 模型之一，效果很好，价格极低（日常聊天大概几毛钱一天），国内直连，速度快。

注册 DeepSeek 开放平台

在浏览器打开 platform.deepseek.com，用手机号注册一个账号。

充值

登录后点击左侧 "充值"，最低充 10 元。支持支付宝/微信支付。10 元正常使用的话能用好几个月。

创建 API Key

点击左侧菜单的 "API Keys"，然后点 "创建 API Key"：

名称随便写，比如 openclaw
创建后会显示一串以 sk- 开头的字符串
立刻复制保存！关掉就看不到了

配置到 OpenClaw

把下面命令里的 sk-你的API Key 替换成你刚才复制的 Key，然后在终端运行：

bash

openclaw config set 'models.providers.deepseek' --json '{
  "baseUrl": "https://api.deepseek.com",
  "apiKey": "sk-你的API Key",
  "models": {
    "default": "deepseek-chat",
    "reasoning": "deepseek-reasoner"
  }
}'

两个模型的区别：

deepseek-chat — 日常对话用，速度快，便宜
deepseek-reasoner — 遇到数学、逻辑、编程等需要深度思考的问题时用，效果更好但更贵

重启并测试

bash

openclaw gateway restart

发消息测试，收到回复就成功了！

常见问题：

报错 "Insufficient Balance" → 余额不足，去充值
报错 "Invalid API Key" → Key 复制错了，重新复制粘贴
模型名不要改！必须写 deepseek-chat，不要自己编名字

选项 2：其他国产 AI 模型

除了 DeepSeek 和通义千问，国内还有很多优秀的 AI 模型可以选择，都能国内直连：

平台	模型	特点	注册地址
智谱 AI	GLM-4	清华出品，综合能力强	open.bigmodel.cn
月之暗面	Kimi / Moonshot	长文本专家，能处理超长文档	platform.moonshot.cn
百度	文心一言 ERNIE	百度出品，中文理解好	百度智能云
零一万物	Yi	李开复创办，性价比高	platform.lingyiwanwu.com

这些平台的配置方法都一样，只需要替换 baseUrl、apiKey 和模型名。比如智谱 AI：

bash — 智谱 AI 配置示例

openclaw config set 'models.providers.zhipu' --json '{
  "baseUrl": "https://open.bigmodel.cn/api/paas/v4",
  "apiKey": "你的智谱API Key",
  "models": {
    "default": "glm-4-flash"
  }
}'

每个平台的 baseUrl 和模型名请以各平台官方文档为准。

选项 3：国外模型 — Claude / GPT（需要翻墙）

以下内容需要翻墙才能操作。如果你没有翻墙工具，请跳过这部分，用上面的国产模型方案就好。国产模型的效果已经非常好了！

如果你有翻墙条件，想用 Claude（Anthropic）或 GPT（OpenAI）这些国外顶级模型，有两种方式：

方式 A：直接用官方 API（需翻墙 + 外币信用卡）

去 console.anthropic.com 注册并获取 API Key。

bash

openclaw config set 'models.providers.anthropic' --json '{
  "baseUrl": "https://api.anthropic.com",
  "apiKey": "sk-ant-你的API Key",
  "models": {
    "default": "claude-sonnet-4-20250514"
  }
}'

去 platform.openai.com 注册并获取 API Key。

bash

openclaw config set 'models.providers.openai' --json '{
  "baseUrl": "https://api.openai.com/v1",
  "apiKey": "sk-你的API Key",
  "models": {
    "default": "gpt-4o"
  }
}'

方式 B：通过第三方 API 代理（不需翻墙，但需要注意安全）

国内有些第三方服务商帮你转发请求到 OpenAI/Anthropic 的服务器，让你不翻墙也能用 Claude 和 GPT。

安全提醒：你的对话内容会经过代理服务器，存在数据泄露风险。请选择口碑好、运营时间长的代理，不要用来聊敏感内容。

配置方法和上面一样，只是把 baseUrl 改成代理给你的地址：

bash — 第三方代理模板

openclaw config set 'models.providers.proxy' --json '{
  "baseUrl": "https://api.你的代理域名.com",
  "apiKey": "代理给你的API Key",
  "models": {
    "default": "代理支持的模型名"
  }
}'

如果你已经在用第三方代理跑 Claude Code，同样的 API Key 和 Base URL 通常也可以直接用在 OpenClaw 上。

总结：付费方案怎么选？

国内、追求性价比 → DeepSeek（10 元用几个月）
国内、想试更多模型 → 智谱 / Kimi / 硅基流动
能翻墙、想用最强模型 → Claude / GPT 官方 API
不能翻墙、但想用 Claude / GPT → 第三方 API 代理

🔧 配置完成后别忘了重启

无论选哪种方案，改完配置都要重启 OpenClaw 才能生效：

bash

openclaw gateway restart

然后去 Web UI（http://localhost:18789）发一条消息测试，收到回复就说明配置成功了！

可以同时配置多个模型吗？可以！你可以配多个 provider，然后在对话中切换。比如日常用 DeepSeek 省钱，遇到复杂问题切换到通义千问 Max 处理。

配置出问题了？排查清单：

确认 API Key 是否正确 — 重新去平台复制一遍，注意不要多复制空格
确认 baseUrl 是否正确 — 每个平台的地址不一样，不要搞混
确认模型名是否正确 — 要用平台官方提供的模型名，不要自己编
确认账户有余额 — 付费平台需要先充值
运行诊断命令 — openclaw doctor --fix 可以帮你自动排查问题

常用命令

以下是管理 OpenClaw 的常用终端命令：

命令	功能	使用场景
`openclaw onboard`	运行配置向导	首次安装或重新配置
`openclaw gateway start`	启动后台服务	手动启动 OpenClaw
`openclaw gateway stop`	停止后台服务	需要暂停 OpenClaw 时
`openclaw gateway restart`	重启后台服务	修改配置后需要重启
`openclaw gateway status`	查看运行状态	检查 OpenClaw 是否正常运行
`openclaw config`	查看/修改配置	修改 API Key、模型等设置
`openclaw skills`	管理技能	查看、安装、删除技能
`openclaw doctor --fix`	诊断并修复问题	出问题时排查原因
`openclaw --version`	查看版本号	确认安装的版本
`openclaw update`	更新到最新版	想用新功能时

Docker 部署（进阶）

如果你有一台服务器（VPS/云主机），可以把 OpenClaw 部署到服务器上，这样即使你的电脑关了，AI 助手也在 24 小时运行。

🐳 为什么用 Docker？

环境隔离 — 不会影响服务器上的其他程序
一键部署 — 不需要手动安装各种依赖
安全性更好 — OpenClaw 运行在容器沙盒中

📋 系统要求

项目	最低要求	推荐配置
内存	2 GB	4 GB
磁盘	10 GB	20 GB
Docker	Docker Engine + Compose v2	最新版

🚀 快速部署步骤

bash — 在服务器上执行
# 1. 克隆仓库
git clone https://github.com/openclaw/openclaw.git
cd openclaw

# 2. 运行安装脚本（会自动拉镜像、配置、启动）
./docker-setup.sh

# 3. 进入容器完成配置向导
docker exec -it openclaw openclaw onboard

配置完成后，OpenClaw 的 Web UI 默认在 http://服务器IP:18789 上运行。

安全提醒：如果服务器有公网 IP，请务必配置防火墙规则，限制 18789 端口的访问。不要把 OpenClaw 的 Web UI 直接暴露在公网上。

安全注意事项

OpenClaw 非常强大，但能力越大，风险越大。请注意以下安全事项：

⚠️ 必须知道的风险

文件操作风险 — OpenClaw 可以读写你电脑上的文件，操作不当可能导致数据丢失
第三方 Skill 风险 — 社区提交的 Skill 可能包含恶意代码，Cisco 安全团队已发现过数据泄露的案例
上下文压缩风险 — 对话过长时 AI 可能"忘记"安全规则，曾有用户报告 OpenClaw 自动删除了邮件
API Key 泄露风险 — 你的配置文件中包含 API Key 等敏感信息

🛡️ 安全最佳实践

使用 Docker 沙盒 — 在容器中运行 OpenClaw，限制它对主机的访问
只安装可信的 Skill — 优先使用官方推荐或高星标的 Skill
定期检查操作日志 — 看看 OpenClaw 做了什么
重要数据先备份 — 在让 OpenClaw 操作重要文件之前，先做好备份
不要给太高权限 — 避免用 root / 管理员权限运行 OpenClaw
设置操作审批 — 让 OpenClaw 在执行危险操作前先征求你的同意

常见问题

Q：我完全不会编程，能用 OpenClaw 吗？ ▼

完全可以！OpenClaw 的日常使用就是发消息聊天，和用微信一样简单。你说"帮我整理桌面文件"，它就去帮你整理。不需要写任何代码。唯一需要用到命令行的就是安装那一次，跟着教程复制粘贴就行。

Q：我是初中生/高中生，可以用来干嘛？ ▼

太多了！比如：

学习助手：帮你整理笔记、出练习题、解释难题、翻译英语
写作帮手：帮你改作文、写读书笔记、做 PPT 大纲
学编程：让它教你写 Python 小游戏，边玩边学
做小项目：帮你做个人网页、小工具、数据分析
定时提醒：每天提醒你背单词、做作业

而且这些全都免费。用通义千问的免费额度就够日常学习用好几个月。

Q：OpenClaw 和 Clawdbot / Moltbot 是什么关系？ ▼

它们是同一个项目的不同名字。开发者 Peter Steinberger 最初把项目命名为 Clawdbot（龙虾谐音 Claude），后来因为 Anthropic 的商标投诉，先改名为 Moltbot（龙虾脱壳之意），最终定名为 OpenClaw。所以你看到网上提到这三个名字，说的都是同一个东西。

Q：OpenClaw 是免费的吗？ ▼

OpenClaw 本身是完全免费开源的。但你需要自己付 AI 模型的 API 调用费用。比如用 DeepSeek 的话，大概几毛钱一天；用 GPT-4 或 Claude 的话就贵一些。选择通义千问 Qwen 还有免费额度可以用。

Q：关掉电脑后 OpenClaw 还能用吗？ ▼

如果 OpenClaw 安装在你的个人电脑上，关机后就不能用了。如果你想 24 小时运行，有两种方案：

买一台便宜的 Mac Mini 或树莓派，专门跑 OpenClaw
租一台云服务器（VPS），用 Docker 部署

Q：OpenClaw 安全吗？我的数据会不会泄露？ ▼

OpenClaw 本身运行在你自己的设备上，数据不会传到 OpenClaw 的服务器（因为它没有中心服务器）。但有两个注意点：

你和 AI 的对话内容会发送到 AI 模型提供商（如 DeepSeek、OpenAI），这和你直接用 ChatGPT 是一样的
第三方 Skill 可能有安全风险，请只安装可信来源的 Skill

建议用 Docker 沙盒运行，并定期检查操作日志。

Q：onboard 向导出错了怎么办？ ▼

可以重新运行向导：

bash
openclaw onboard

或者运行诊断工具：

bash
openclaw doctor --fix

Q：Moltbook 是什么？ ▼

Moltbook 是一个 OpenClaw Agent 自己创建的"AI 社交网络"。上面全是 AI 机器人在发帖、评论、互相点赞，人类只能围观不能参与。它一度病毒式传播，累计注册了 160 万个 AI Bot，产生了 750 万条 AI 生成的帖子。这个现象本身就展示了 OpenClaw 的强大能力。

Q：如何更新 OpenClaw？ ▼

bash
openclaw update

或者用 npm 重新安装最新版：

bash
npm install -g openclaw@latest

术语表（看不懂的词看这里）

术语	白话解释
AI Agent	能"做事"的 AI，不只是聊天。OpenClaw 就是一个 AI Agent
Gateway	网关，OpenClaw 的后台服务程序。它负责接收你的消息、调用 AI、执行任务
Skill	技能模块，像手机里的 App。给 OpenClaw 安装 Skill 就是让它多一项能力
Channel	频道 / 渠道，指你和 OpenClaw 对话的平台（Telegram、WhatsApp 等）
Onboard	配置向导，首次安装后引导你完成所有设置的交互式流程
Daemon	守护进程，让 OpenClaw 在后台持续运行，不需要你一直开着终端
API Key	一串密码字符串，证明"你有权使用这个 AI 模型"
Docker	容器化技术，可以把 OpenClaw 放在一个"虚拟盒子"里运行，更安全
Token	AI 处理文本的计费单位。1 个中文字 ≈ 2-3 个 Token
Bot	机器人账号，在 Telegram 等平台上代表 OpenClaw 的虚拟角色
开源	代码公开，任何人都可以免费使用、查看和修改
npm	Node.js 的包管理器，用来安装 JavaScript 项目（包括 OpenClaw）