乐于分享
好东西不私藏

动手部署 OpenClaw

动手部署 OpenClaw

2.1 找台机器:本机 or 云服务器?

第一步,你得有台机器。

两个选择:

选项 A:本机(推荐新手)
– 优点:零成本、调试方便、出问题好排查
– 缺点:需要保持开机才能随时响应消息
– 适合:学习、测试、个人使用

选项 B:云服务器(推荐生产环境)
– 优点:24 小时在线、公网 IP、稳定可靠
– 缺点:要花钱(入门配置约 50-100 元/月)
– 适合:长期运营、团队协作、对外服务

我的建议:先用本机跑通,再考虑上云。

这一章我们默认你用本机(Mac/Windows/Linux 都支持),云服务器只是多了个 SSH 登录的步骤,后面都一样。


2.2 安装 OpenClaw:三条命令搞定

OpenClaw 的安装比你想的简单。

Mac 用户:

curl -fsSL https://easyclaw.com/install.sh | bash

Linux 用户:

curl -fsSL https://easyclaw.com/install.sh | bash

Windows 用户:
用 PowerShell 管理员模式运行:

iwr https://easyclaw.com/install.ps1 -useb | iex

等一下,别急着回车。

安装脚本会做三件事:
1. 检查依赖(Node.js、Git 等)
2. 下载 EasyClaw 主程序
3. 初始化你的第一个 workspace

如果你看到类似这样的输出,说明成功了:

✓ EasyClaw installed successfully
✓ Workspace created at ~/.easyclaw/workspace-default
✓ Run 'easyclaw --help' to get started

常见坑 1:权限报错

Error: Permission denied

解决:Mac/Linux 在命令前加 sudo,Windows 用管理员 PowerShell。

常见坑 2:网络超时

curl: (28) Failed to connect...

解决:换个网络环境,或者手动下载安装包。


2.3 配置模型:DeepSeek 最便宜,先用起来

装好只是第一步,接下来要让 AI 有”脑子”。

OpenClaw 支持几十个模型提供商,新手我建议从 DeepSeek开始——便宜、好用、中文能力强。

步骤 1:获取 API Key
1. 访问 https://platform.deepseek.com
2. 注册/登录账号
3. 进入「API Keys」页面
4. 点击「创建密钥」
5. 复制你的 sk-xxxxx 密钥(只出现一次,别弄丢了)

步骤 2:配置到 OpenClaw

easyclaw config set model.provider deepseek
easyclaw config set model.api_key sk-xxxxx

步骤 3:验证配置

easyclaw status

看到 model: deepseek.deepseek-v4-flash就说明配好了。

成本算笔账:
– DeepSeek-V4-Flash:约 0.5 元/百万 tokens
– 一次对话约 1000-2000 tokens
– 10 块钱能聊几百次

常见坑 3:API Key 无效

Error: Invalid API key

检查:
– 有没有复制完整(sk- 开头)
– 有没有多余空格
– 账号余额是否充足


2.4 接入渠道:微信/飞书/Telegram 选哪个?

模型配好了,现在要让 AI 能”说话”——也就是接入聊天渠道。

三个主流选择:

渠道
难度
成本
推荐场景
飞书
⭐⭐
免费
个人/团队内部使用
Telegram
⭐⭐
免费
海外用户、技术圈
微信
⭐⭐⭐⭐
需公众号
国内大众用户

新手建议:先用飞书练手。

飞书机器人 10 分钟就能配好,而且完全免费。微信需要公众号 + 服务器备案,适合后面再搞。

飞书机器人配置步骤:

1访问飞书开放平台:https://open.feishu.cn
2创建企业应用 → 选择「机器人」
3获取 App ID 和 App Secret
4配置事件订阅(消息接收地址)
5在 OpenClaw 中配置:
easyclaw config set channel.feishu.app_id cli_xxxxx
easyclaw config set channel.feishu.app_secret xxxxxxx
easyclaw gateway start

验证:在飞书里@你的机器人,看它会不会回复。

常见坑 4:收不到消息
检查:
– 事件订阅 URL 是否正确
– 网关是否启动(easyclaw gateway status
– 机器人是否已添加到群里


2.5 第一次对话

配置完成,现在来真的。

打开你接入的渠道(飞书/微信/Telegram),跟你的 AI 聊几句。

测试对话示例:

你:你好,介绍一下你自己
AI:你好!我是你的微信公众号运营专家,擅长...

你:帮我写个标题,主题是 AI 会不会取代程序员
AI:给你 5 个选项:1) 《程序员已死?AI 写代码比我们快 10 倍》...

2.6 踩坑记录:我遇到的 5 个报错

这一节是纯干货,都是我真实遇到的。

坑 1:网关启动失败

Error: Port 3000 already in use

解决:lsof -i :3000找到占用进程,kill -9 <PID>杀掉,或者改配置换个端口。

坑 2:模型调用超时

Error: Request timeout after 30s

解决:网络问题,检查代理;或者换更小的模型(DeepSeek-V4-Flash 比 Pro 快)。

坑 3:飞书消息收不到

No events received

解决:开放平台的事件订阅 URL 要填对,格式是 https://你的域名/feishu/events,而且必须 HTTPS。

坑 4:微信推送失败

Error: Invalid media_id

解决:图片上传有时效性(3 小时),超时了要重新上传;或者检查图片格式(微信只认 JPG/PNG)。

坑 5:配置改了不生效

Config updated but behavior unchanged

解决:改配置后要重启网关:easyclaw gateway restart


2.7 小结:跑通比完美重要

第二章到此结束。

不要追求一次性配到完美——先跑通,再迭代。后面章节我们会基于这个基础,一步步加功能、调风格、做优化。

下一章预告:第三章《让 AI 说人话:风格调教与人格设定》