OpenClaw的文档分散、社区讨论大多是英文,中文新手入门容易卡在各种奇怪的地方。这篇教程从零开始,把安装、中文设置、Skills配置讲清楚,尽量做到跟着走就能用起来。
一、环境准备
在安装OpenClaw之前,需要确保你的电脑有以下环境:
Python 3.10及以上版本
打开终端(Windows用CMD或PowerShell),运行:
python --version
如果显示 Python 3.10.x 或更高版本,说明已经满足要求。如果没有Python,去 python.org 下载安装包,安装时记得勾选「Add Python to PATH」。
Git
运行 git --version 检查。没有的话去 git-scm.com 下载安装。
Node.js(部分Skills需要)
运行 node --version,建议安装18.x以上版本。
二、安装OpenClaw
方法一:通过pip安装(推荐新手)
pip install openclaw
安装完成后,验证一下:
openclaw --version
能看到版本号说明安装成功。
方法二:从GitHub源码安装
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pip install -e .
源码安装适合想跟进最新功能、或者想自己修改代码的用户。
常见安装报错
报错:pip: command not found
说明Python没有正确添加到PATH,重新安装Python时注意勾选PATH选项。
报错:error: Microsoft Visual C++ 14.0 is required(Windows)
需要安装Visual C++ Build Tools,去微软官网搜索下载即可。
报错:SSL证书错误
可以临时用 pip install openclaw --trusted-host pypi.org --trusted-host files.pythonhosted.org 绕过,但建议检查系统网络设置。
三、配置模型后端
OpenClaw本身不带AI模型,需要你配置一个后端。最常用的是OpenAI和Claude。
配置OpenAI
在终端运行:
openclaw config set model openai
openclaw config set openai_api_key sk-你的APIKey
或者直接编辑配置文件,位置在 ~/.openclaw/config.yaml:
model:
provider: openai
model_name: gpt-4o
api_key: sk-你的APIKey
配置Claude(Anthropic)
model:
provider: anthropic
model_name: claude-opus-4-5
api_key: sk-ant-你的APIKey
建议在 Anthropic Console 生成专用的API Key,不要把主账号的Key到处用。
四、中文界面设置
OpenClaw默认是英文界面,切换中文需要两步。
第一步:设置语言
打开配置文件 ~/.openclaw/config.yaml,添加或修改:
locale: zh_CN
保存后重启OpenClaw。
第二步:安装中文语言包
如果界面还有部分没有翻译,运行:
openclaw lang install zh_CN
社区维护的中文翻译不是100%完整,部分技术术语仍然是英文,这是正常现象。
中文输入法问题
在某些系统上,OpenClaw的文字输入框和输入法有冲突,尤其是Windows上。如果遇到中文无法输入的问题,可以尝试:
- 先在记事本输入好中文,复制粘贴到OpenClaw
- 或者在 config.yaml 中设置
input_method_compat: true
五、Skills配置
Skills是OpenClaw的插件系统,每个Skill针对特定软件或场景提供增强能力。
查看可用Skills
openclaw skills list
这会列出官方仓库里的所有可用Skills,包括名称、版本、描述。
安装Skill
以「浏览器控制」Skill为例:
openclaw skills install browser-control
安装完成后会提示是否需要额外配置(比如填写API Key或者路径)。
常用Skills推荐
browser-control:控制Chrome/Edge浏览器,访问网页、提取信息、填写表单。新手必装。
file-manager:文件批量操作,重命名、移动、整理目录结构。
office-suite:操控Word、Excel、PowerPoint,适合办公自动化。需要本地安装Office或WPS。
email-helper:支持Outlook和常见邮件客户端,自动发邮件、整理收件箱。
clipboard-manager:增强剪贴板功能,在多步骤任务中传递数据。
Skill配置示例
每个Skill有自己的配置文件,在 ~/.openclaw/skills/[skill名]/config.yaml。
以 browser-control 为例:
browser: chrome
chrome_path: /usr/bin/google-chrome
headless: false # true表示后台运行不显示浏览器窗口
screenshot_interval: 1.5 # 截图频率(秒),值越小越快但越耗资源
六、第一个任务:搜索并整理信息
环境配置好后,试一个简单任务感受一下:
打开终端,启动OpenClaw:
openclaw run
在提示符后输入任务描述(支持中文):
打开浏览器,搜索「2025年AI Agent趋势」,把前5个结果的标题和链接整理成一个表格,保存到桌面的result.txt
OpenClaw会开始执行,你可以在屏幕上看到它的操作过程。第一次跑可能会慢,因为它需要截图、分析、操作,每一步都要调用模型。
七、进阶使用建议
写清楚任务描述:OpenClaw对任务描述的质量很敏感。「帮我查一下」不如「打开Chrome,访问xxx网站,找到最新的价格信息,截图保存到桌面」。
用任务文件而不是手打:复杂任务建议写成 .yaml 任务文件,这样可以复用和分享:
task:
name: 每日价格监控
steps:
- open_browser: https://example.com/price
- extract: "商品价格"
- save_to: ~/price_log.txt
控制截图频率:如果任务运行慢,适当提高 screenshot_interval(比如从1秒改到2秒),能减少模型调用次数,节省费用。
关注token消耗:Computer Use类任务每一步都要截图+分析,token消耗比普通对话高很多。建议先在小任务上测试,估算一下费用再跑批量任务。
总结
OpenClaw的核心价值在于灵活性和可定制性,但这也意味着上手有一定门槛。按照这篇教程走完一遍之后,你应该能跑起来一个基本可用的环境。
后续深入的方向:自定义Skill开发、多步骤任务编排、接入本地模型(降低API成本)。
有任何安装或配置上的具体问题,欢迎在评论里描述你的报错信息,尽量帮你解决 ![]()