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