OpenClaw 完整使用教程:从零配置到高级技能开发
本文介绍了OpenClaw的安装部署及常见问题解决方法。建议使用WSL安装OpenClaw,安装成功后通过"openclaw gateway start"命令启动网关访问页面。针对首次登录需要获取网关令牌的问题,文章提供了详细解决方案,并展示了成功连接智谱大模型进行对话的示例。整个过程图文并茂,指导用户完成从安装到使用的完整流程。
·
一、部署安装
建议使用 WSL来安装OpenClaw。

安装成功后使用启动网关来在线访问openclaw页面:
openclaw gateway start
二、启动上遇到的问题
1、打开提示需要获取网关令牌才能登录

解决方案:

已经成功使用智谱大模型对上话了,而且得到了回复。
2、帮我在桌面新建一个测试.txt文件

查看桌面也是确实帮我新建了一个测试.txt的文件,openclaw成功接管了我的电脑能干活了!!!
三、Skills技能的使用
1、简单信息回复


openclaw已经直接读取到了我的skills技能配置了。


已经成功调用到了skills技能,并且回复了我skills文件中的回复。
2、移动文件案例


init.py文件:内容可以为空,也可以如下(打包写法):
# skills/move_docs/__init__.py
move_docs.py文件的代码:
import os
import shutil
from openclaw import skill # 假设的 SDK
@skill(
name="move_docs_to_test_folder",
description="将用户桌面上的所有 Word 文档(.docx 和 .doc)移动到桌面上的“测试文件夹”中。如果“测试文件夹”不存在,会自动创建。",
parameters={
# 可以留空,因为桌面路径通常是固定的,也可以让用户自定义
}
)
def move_docs_to_test_folder() -> str:
# 获取用户桌面的路径(兼容 Windows / Linux / Mac)
desktop = os.path.join(os.path.expanduser("~"), "Desktop")
# 如果中文系统可能叫“桌面”,做一下兼容
if not os.path.exists(desktop):
desktop = os.path.join(os.path.expanduser("~"), "桌面")
if not os.path.exists(desktop):
return "❌ 找不到桌面路径,请确认系统桌面位置。"
test_folder = os.path.join(desktop, "测试文件夹")
os.makedirs(test_folder, exist_ok=True) # 创建文件夹(如果不存在)
moved_count = 0
errors = []
# 遍历桌面上的文件
for filename in os.listdir(desktop):
if filename.lower().endswith(('.docx', '.doc')):
source = os.path.join(desktop, filename)
# 只处理文件,跳过文件夹
if os.path.isfile(source):
destination = os.path.join(test_folder, filename)
try:
# 如果目标位置已有同名文件,可以重命名或跳过
if os.path.exists(destination):
base, ext = os.path.splitext(filename)
counter = 1
while os.path.exists(os.path.join(test_folder, f"{base}_{counter}{ext}")):
counter += 1
destination = os.path.join(test_folder, f"{base}_{counter}{ext}")
shutil.move(source, destination)
moved_count += 1
except Exception as e:
errors.append(f"{filename}: {str(e)}")
if moved_count == 0:
return "桌面没有找到 .docx 或 .doc 文件。"
result = f"✅ 已成功移动 {moved_count} 个 Word 文件到“测试文件夹”。"
if errors:
result += f"\n⚠️ 但以下文件移动失败:{'; '.join(errors)}"
return result
skill.md功能描述文件:
---
name: move_docs_to_test_folder
description: 将桌面上的所有 Word 文档(.docx, .doc)移动到“测试文件夹”中
parameters: {}
returns: string (执行结果描述)
---
# 技能说明
自动查找用户桌面上的 .docx 和 .doc 文件,将它们移动到桌面上的“测试文件夹”。
如果文件夹不存在则自动创建,有重名文件时会自动重命名避免覆盖。
## 调用方式
用户可以说:“帮我把桌面上的 Word 文档移到测试文件夹里”。
## 参数
无(桌面路径自动获取)。
## 返回示例
“✅ 已成功移动 3 个 Word 文件到‘测试文件夹’。”
更多推荐




所有评论(0)