说实话，我第一次接触OpenClaw的时候，光是安装就折腾了一整天。网上那些教程，要么写得跟天书似的，要么直接丢给你一堆命令让你自己琢磨。作为一个过来人，我踩过的坑，就不想让你再踩一遍了。
今天这篇教程，我会手把手带你从零开始，把OpenClaw装好，然后跑起来第一个智能体。整个过程我尽量写得啰嗦一点，毕竟咱是“小白第一课”嘛。
准备工作：你的电脑需要什么
先看看你的电脑够不够格。别担心，要求真不高：
操作系统：Windows 10/11、macOS（Intel或M芯片都行）、或者任何一个Linux发行版
Python版本：3.9到3.11之间（这个特别重要，我之前用3.12死活装不上，折腾半天才发现是版本问题）
内存：至少4GB，8GB以上用起来更舒服
硬盘空间：留个10GB左右吧，模型文件还是挺占地方的
确认一下Python版本。打开终端（Windows用CMD或PowerShell，Mac/Linux直接用终端），输入：
python --version
或者有些系统要用：
python3 --version
如果显示的不是3.9、3.10或3.11，建议去python官网装一个对应版本。我用的3.10，一直挺稳的。
第一步：安装OpenClaw
- 创建虚拟环境（强烈建议）
这一步很多人跳过，但真的别偷懒。虚拟环境就像给你的项目建了个小隔间，东西不会跟系统里的其他Python包打架。
找个干净的地方，比如桌面或者文档文件夹
mkdir openclaw-test
cd openclaw-test
创建虚拟环境
python -m venv venv
激活虚拟环境（Windows）
venv\Scripts\activate
激活虚拟环境（Mac/Linux）
source venv/bin/activate
激活成功后，你会在终端前面看到(venv)这几个字，说明你已经在小隔间里了。
- 安装OpenClaw
直接用pip安装，这个简单：
pip install openclaw
第一次装可能会花个两三分钟，因为要拉一堆依赖包。这时候可以去泡杯茶，别干等着。
装完之后验证一下：
openclaw --version
如果显示了版本号，恭喜，安装成功了。如果提示“命令未找到”，别慌，大概率是虚拟环境没激活，或者pip安装路径没加进环境变量。
- 配置API密钥（这一步容易踩坑）
OpenClaw本身是个框架，要跑智能体，得连一个AI模型。我建议新手先用OpenAI的API，最省事。
去OpenAI官网注册个账号，申请一个API Key。申请的时候要绑卡，但新用户一般有5美元的试用额度，够你玩好一阵子了。
拿到Key之后，设置环境变量：
Windows（CMD）：
set OPENAI_API_KEY=sk-你的密钥
Windows（PowerShell）：
$env:OPENAI_API_KEY="sk-你的密钥"
Mac/Linux：
export OPENAI_API_KEY="sk-你的密钥"
注意：这个设置只在当前终端窗口有效，关掉就没了。想一劳永逸的话，可以把这行加到你的shell配置文件里（比如.bashrc或.zshrc），不过新手不着急折腾这个，先用着再说。
第二步：跑通第一个智能体
装好了，该上真家伙了。我们来创建一个最简单的智能体——让它帮你查天气。
- 创建智能体文件
在你刚才的openclaw-test文件夹里，新建一个文件，叫weather_agent.py，用记事本或者VS Code都行，把下面的代码贴进去：
from openclaw import Agent
from openclaw.tools import Tool
先写一个模拟查天气的工具
def check_weather(city: str) -> str:
"""
查询指定城市的天气
"""
# 这里简单模拟一下，实际可以接入真实天气API
weather_data = {
"北京": "晴天，温度25°C，微风",
"上海": "多云，温度28°C，湿度较大",
"广州": "雷阵雨，温度32°C，注意带伞",
"深圳": "晴天，温度30°C，适合出门",
}
return weather_data.get(city, f"抱歉，暂时查不到{city}的天气")
把函数包装成OpenClaw能识别的工具
weather_tool = Tool.from_function(check_weather)
创建智能体
agent = Agent(
name="天气助手",
instructions="你是一个贴心的天气助手。用户问你天气时，使用check_weather工具查询，然后用温柔的语气告诉用户。",
tools=[weather_tool],
model="gpt-3.5-turbo"# 用gpt-3.5就够用了，省钱
)
跑起来，进入对话模式
print("天气助手已启动！输入'退出'结束对话")
whileTrue:
user_input = input("\n你：")
if user_input == "退出":
break
response = agent.run(user_input)
print(f"助手：{response}")
- 运行你的智能体
确保虚拟环境还激活着，然后在终端里执行：
python weather_agent.py
如果一切顺利，你会看到“天气助手已启动！”的提示。试试输入“北京今天天气怎么样”，看看智能体怎么回答。
我第一次跑通的时候，看到它真的去调了那个函数，然后把结果组织成一段人话回复给我，说实话还挺有成就感的。
- 可能会遇到的问题
问题一：ImportError: No module named 'openclaw'
这说明你的Python环境里没装OpenClaw。检查一下虚拟环境有没有激活，如果激活了，重新执行pip install openclaw。
问题二：OpenAI API报错
最常见的原因是API Key没设置对，或者Key失效了。用echo $OPENAI_API_KEY（Mac/Linux）或者echo %OPENAI_API_KEY%（Windows）检查一下环境变量有没有值。
还有一个可能——你的网络访问不了OpenAI。这个看你在哪了，懂的都懂，解决方案就不展开了。
问题三：模型调用超时
可能是网络问题，也可能是OpenAI那边服务不稳定。重试几次，或者换个时间再试。
第三步：试试更复杂的玩法
第一个智能体跑通了，恭喜你，已经入门了。接下来可以试试加点料，让智能体更像那么回事。
加记忆功能
让智能体记住你之前说过的话：
from openclaw.memory import SimpleMemory
memory = SimpleMemory()
agent = Agent(
# ... 其他配置
memory=memory,
)
这样你连续问“那上海呢？”的时候，它就知道你在问天气。
加多个工具
再写一个查时间的工具，让智能体既能查天气又能查时间：
def get_current_time() -> str:
from datetime import datetime
return datetime.now().strftime("%Y年%m月%d日 %H:%M:%S")
time_tool = Tool.from_function(get_current_time)
agent = Agent(
# ...
tools=[weather_tool, time_tool],
)
智能体会根据你的问题，自动判断该用哪个工具。
最后说两句
从零到跑通第一个智能体，其实没那么难对吧？我当初卡在Python版本问题上整整两天，就是没人告诉我3.12不行。希望这篇教程帮你避开了我踩过的那些坑。
OpenClaw能做的事情远不止查天气，你可以让它帮你处理文档、写代码、分析数据……等你熟悉了基本用法，会发现这东西的想象力空间挺大的。
有什么问题欢迎在评论区留言，我看到就会回。下一篇我打算写怎么给智能体加上网页界面，让不是程序员的人也能用。想看的可以点个关注。
好了，去试试你的第一个智能体吧，祝玩得开心！
