独立完成部署+Skill开发+系统搭建：OpenClaw全栈实战手册

独立完成部署+Skill开发+系统搭建：OpenClaw全栈实战手册

掌握OpenClaw的核心在于三个独立能力的闭环：部署环境 → 开发Skill → 集成系统。本文将按照这个逻辑，从零开始完整走一遍。

一、部署阶段：搭建运行环境

1.1 部署方案选择

新手建议：先从本地部署开始，熟练后再上云。

1.2 Windows本地部署（全程命令可复制）

第一步：安装Node.js（以管理员身份运行PowerShell）

# 下载Node.js 22.x安装包iwr-useb https://npmmirror.com/mirrors/node/v22.10.0/node-v22.10.0-x64.msi-OutFile node-install.msiStart-Process.\node-install.msi-Wait# 验证安装node--version# 应显示v22.x.xnpm--version

第二步：配置国内镜像加速（解决下载慢问题）

npm configsetregistry https://registry.npmmirror.com

第三步：全局安装OpenClaw

npm install-g openclaw@latest

第四步：初始化配置

openclaw onboard

按提示完成：

• 选择大模型（推荐通义千问或Kimi）
• 输入API Key（从阿里云百炼或Kimi平台获取）
• 选择聊天载体（新手选TUI即可）

第五步：启动服务

openclaw gatewaystart

浏览器访问http://localhost:18789进入Web控制台。

1.3 阿里云一键部署（7×24小时运行）

喂饭级步骤：

1. 购买服务器：访问阿里云OpenClaw一键部署专题页面 → 选择OpenClaw(Moltbot)镜像 → 配置2vCPU+2GiB以上内存 → 地域选美国（弗吉尼亚）或中国香港

2. 放行端口：在防火墙配置中放行18789端口

3. 配置API Key：在阿里云百炼控制台创建API-Key → 回到服务器应用详情 → 单击"一键配置"输入API-Key

4. 获取访问地址：单击"打开网站页面"进入OpenClaw对话页面

1.4 验证部署成功

# 检查服务状态openclaw status# 测试对话openclaw chat--prompt"你好，请介绍一下自己"

二、Skill开发：从零构建专属技能

2.1 理解Skill的本质

Skill ≠ 插件，Skill = 给AI看的执行说明书

核心要点：

• 不需要写复杂代码，会写Markdown就能开发
• 一个文件夹 + 一个SKILL.md文件即可
• AI会按照你的说明书一步一步执行

2.2 Skill标准结构

~/.openclaw/workspace/skills/ └── 你的技能名/ └── SKILL.md

2.3 SKILL.md完整模板

--- name: 技能名称 description: > 一句话描述技能功能 Use when: 什么情况下触发 NOT for: 什么情况下不要触发（重要！） --- # 技能标题 ## When to Run - 触发条件1 - 触发条件2 ## Workflow 1. 第一步做什么 2. 第二步做什么 3. 第三步做什么 ## Output Format 明确指定输出格式

2.4 实战案例：每日简报Skill

场景：每天早上自动获取天气和热帖，生成简报。

创建目录和文件：

mkdir-p~/.openclaw/workspace/skills/daily-briefcd~/.openclaw/workspace/skills/daily-brieftouchSKILL.md

编写SKILL.md：

--- name: daily-brief description: > 每日早报，上海天气 + V2EX热帖 Use when: 用户需要今日简报，或早上8点定时执行 NOT for: 专业气象预报、长内容新闻 --- # Daily Brief ## When to Run - 每天早上8点（cron触发） - 用户说"今日简报""今天热点" ## Workflow 1. 获取上海天气： curl "https://wttr.in/Shanghai?format=3" 2. 获取V2EX热门前5条： curl https://www.v2ex.com/api/topics/hot.json 3. 提取标题与节点 4. 按指定格式整理输出 ## Output Format 📅 今日简报 🌤 天气：{天气结果} 🔥 V2EX热帖： 1. {标题}（{节点}） 2. {标题}（{节点}）

测试Skill：

openclaw gateway restart openclaw chat--prompt"使用daily-brief生成今日简报"

2.5 高级Skill：带脚本执行

当任务需要计算或复杂处理时，可添加脚本：

skills/ └──>## Workflow 1. 执行分析脚本： python scripts/analyze.py --input {数据文件} 2. 读取输出结果 3. 按格式整理返回

2.6 从ClawHub安装现成Skill

# 安装clawhub工具npminstall-gclawhub# 搜索可用技能clawhub search 关键词# 安装技能clawhubinstall技能名称# 查看已安装技能clawhub list

三、系统搭建：打通外部平台

3.1 整体架构

用户(钉钉/飞书) → 消息平台API → 中间件 → OpenClaw网关 → 执行任务 → 返回结果

3.2 对接飞书（完整代码）

第一步：在飞书开放平台创建应用

1. 登录飞书开放平台，创建企业自建应用
2. 获取App ID和App Secret
3. 开启机器人能力
4. 配置事件订阅地址：http://你的服务器IP:8080/webhook
5. 添加事件：im.message.receive_v1（接收消息）

第二步：编写中间件（Python Flask）

# app.pyfromflaskimportFlask,requestimportrequestsimportjsonimporthmacimporthashlibimportos app=Flask(__name__)OPENCLAW_URL="http://localhost:18789/api/v1/chat"FEISHU_APP_SECRET=os.getenv("FEISHU_APP_SECRET")defverify_signature(request):"""验证飞书签名"""timestamp=request.headers.get('X-Lark-Request-Timestamp')nonce=request.headers.get('X-Lark-Request-Nonce')signature=request.headers.get('X-Lark-Signature')# 构造签名字符串sign_str=f"{timestamp}{nonce}{FEISHU_APP_SECRET}"expected_sign=hashlib.sha256(sign_str.encode()).hexdigest()returnhmac.compare_digest(signature,expected_sign)@app.route('/webhook',methods=['POST'])defwebhook():# 验证签名ifnotverify_signature(request):return{"code":1,"msg":"invalid signature"},401data=request.json event=data.get("event",{})message=event.get("message",{})# 提取用户消息内容content=json.loads(message.get("content","{}"))user_message=content.get("text","")# 转发给OpenClaw处理try:response=requests.post(OPENCLAW_URL,json={"message":user_message,"session_id":message.get("sender_id")},timeout=30)reply=response.json().get("reply","处理失败，请稍后重试")exceptExceptionase:reply=f"处理异常：{str(e)}"# 返回消息（飞书要求立即返回）return{"code":0,"msg":"success"}if__name__=='__main__':app.run(host='0.0.0.0',port=8080)

第三步：启动中间件

# 安装依赖pipinstallflask requests# 设置环境变量exportFEISHU_APP_SECRET="你的应用Secret"# 启动服务python app.py

第四步：内网穿透（如服务器无公网IP）

# 使用Cloudflare Tunnelcloudflared tunnel--urlhttp://localhost:8080# 获得公网地址，填入飞书事件订阅配置

3.3 对接钉钉（简化版）

钉钉配置流程与飞书类似，核心差异在于签名算法和消息格式：

# 钉钉签名验证defverify_dingtalk_signature(timestamp,nonce,signature,token):sign_str=f"{timestamp}\n{token}\n{nonce}"expected=hashlib.sha256(sign_str.encode()).hexdigest()returnsignature==expected

四、完整闭环：测试与发布

4.1 本地测试流程

# 1. 重启网关加载新技能openclaw gateway restart# 2. 检查技能是否加载openclaw skills list# 3. 测试技能openclaw chat--prompt"执行我的技能"# 4. 查看实时日志openclaw logs--follow

4.2 常见问题排查

4.3 发布到ClawHub

# 登录ClawHubclawhub login# 打包技能clawhub pack ./skills/你的技能名# 发布clawhub publish

五、进阶能力扩展

5.1 定时任务配置

# 添加cron定时任务（每天早上8点执行简报）crontab-e# 添加一行：08* * * openclaw chat--prompt"执行daily-brief"--sessionmorning-brief

5.2 多Agent协同

OpenClaw支持创建多个Agent分配不同角色：

# 创建项目经理Agentopenclaw agent create pm--role"项目经理"# 创建开发Agentopenclaw agent create dev--role"开发工程师"# 分配任务openclaw agent assign pm"分析需求文档，分配给dev执行"

5.3 长期记忆配置

在~/.openclaw/MEMORY.md中写入背景信息，OpenClaw会持续学习：

# 我的工作偏好 - 日报格式：使用表格，包含任务、进度、问题 - 代码风格：Python使用black格式化 - 常用路径：工作文件存放在D:\work

六、总结：能力自检清单

完成以上全部能力，你就具备了独立部署+Skill开发+系统搭建的完整技能栈，可以真正把OpenClaw变成专属的数字员工。