OpenClaw(小龙虾AI)是一款支持自然语言指令的本地AI自动化工具,可实现跨应用的桌面操作自动化,如文件整理、浏览器控制、办公软件操作等。其核心是无需编码,通过启动Gateway服务并连接AI模型来解析和执行用户指令。

###一、Windows系统一键部署流程

步骤 关键操作 说明与注意事项
1. 下载与解压 获取专属部署包(如OpenClaw-2.7.1-Windows.zip),使用WinRAR或7-Zip解压至纯英文路径(如D:\OpenClaw)。 路径含中文可能导致运行异常;解压前建议临时关闭Windows Defender或第三方杀毒软件,防止核心文件被误删。
2. 绕过系统拦截 首次运行start.bat时,若出现Windows SmartScreen拦截,点击“更多信息” -> “仍要运行”。 此为微软对未签名应用的标准提示,OpenClaw为开源工具,可安全运行。
3. 自动环境配置 脚本自动安装所需依赖(如.NET运行时)并启动Gateway服务。 全程无需手动配置Python、Node.js等环境,实现零代码部署。
4. 验证服务状态 观察命令行窗口,出现“Gateway started on port...”即表示服务启动成功。 默认服务端口为`
3000,可通过浏览器访问http://localhost:3000`查看Web UI(若配置)。    

二、浏览器自动化专项配置

浏览器自动化是OpenClaw的核心应用场景,主要通过Chrome DevTools Protocol (CDP)实现。以下是两种主流配置模式:

1. OpenClaw托管模式(推荐)
此模式下,OpenClaw自动启动并管理浏览器实例。

# 配置文件示例:~/.openclaw/openclaw.json或项目config目录下
browser:
  type: "chrome"
  # 使用OpenClaw自带的用户数据目录,避免干扰现有Chrome
  profile_path: "./openclaw"
  # 启用远程调试,端口可自定义
  remote_debugging_port: 9222 # 可选:启用无头模式进行后台操作 headless: false

启动后,通过自然语言如“打开百度并搜索OpenClaw”即可控制浏览器。

2. 复用已登录Chrome模式
适用于需要操作已保存登录状态的浏览器(如已登录企业邮箱、内部系统)。

# 首先,手动启动Chrome并开启远程调试
# Windows命令示例:
"C:\Program Files\Google\Chrome\Application\chrome.exe" --remote-debugging-port=9222 --user-data-dir="C:\path\to\your\profile"

# 随后,在OpenClaw配置中指向该端口
browser:
  type: "chrome"
  # 配置为连接已存在的浏览器实例 reuse_existing: true
  remote_debugging_port: 9222 profile_path: "C:\path\to\your\profile" # 与启动命令中的路径一致

此方法可实现多实例并发操作,但需注意端口冲突问题。

三、与AI模型(如Claude)集成配置

通过与大型语言模型(LLM)集成,OpenClaw能更精准地理解复杂指令。以下以集成Claude(GLM-5)为例:

1. 环境变量配置
在系统或OpenClaw启动环境中设置API密钥:

# Linux/macOS (在~/.bashrc或启动脚本中)
export ANTHROPIC_AUTH_TOKEN="your_anthropic_api_key_here"
# 或使用国内GLM模型
export GLM_API_KEY="your_glm_api_key_here"

# Windows (在start.bat或系统环境变量中设置)
set ANTHROPIC_AUTH_TOKEN=your_anthropic_api_key_here

2. 技能(Skill)模块加载
OpenClaw通过Skill扩展功能。将自定义或下载的Skill(如document_auto_process)放入skills目录,并在配置中启用:

{
  "skills": {
    "enabled": ["web_browser", "file_operator", "document_auto_process"],
    "skill_directories": ["./skills", "~/.openclaw/skills"]
  }
}

3. 实现定时自动化任务示例
结合Claude的代码生成能力,可创建定时任务脚本:

#示例:每日自动爬取新闻并生成摘要报告
import schedule
import time
from openclaw_client import OpenClawClientfrom anthropic import Anthropic

def daily_news_summary():
    # 1. 使用OpenClaw打开新闻网站并爬取内容 claw = OpenClawClient(base_url="http://localhost:3000")
    claw.execute("打开百度新闻,提取今日科技板块头条新闻标题和链接")
 news_data = claw.get_last_result()
 # 2. 调用Claude API生成摘要
    client = Anthropic(api_key=os.environ["ANTHROPIC_AUTH_TOKEN"])
    response = client.messages.create(
        model="claude-3-5-sonnet-20241022",
        max_tokens=1000,
        messages=[{"role": "user", "content": f"请总结以下新闻:{news_data}"}]
    )
    summary = response.content[0].text # 3. 使用OpenClaw将摘要写入Word文档 claw.execute(f"在D:/Reports目录创建名为'每日新闻摘要_{time.strftime('%Y%m%d')}.docx'的文档,并写入内容:{summary}")
    print("每日新闻摘要报告已生成")

# 设置每天上午9点执行
schedule.every().day.at("09:00").do(daily_news_summary)

while True:
    schedule.run_pending()
    time.sleep(60)

此流程实现了从信息采集、AI分析到文档生成的全自动化。

四、常见问题与解决方案

问题现象 可能原因 解决方案
启动时报“权限被拒绝”或文件缺失 杀毒软件拦截或误删核心文件。 将OpenClaw安装目录添加到杀毒软件信任列表;或临时关闭实时防护后重新解压。
Gateway服务启动失败,端口被占用 端口`  
3000`或其他指定端口已被其他程序占用。 修改配置文件中gateway.port为其他空闲端口(如`  
3001),或使用命令netstat -ano`查找并结束占用进程。    
连接AI模型超时或失败 网络问题、API密钥错误或模型服务不可用。 检查网络连接;验证环境变量中API密钥是否正确;尝试使用备用模型或配置OAuth故障转移机制。
浏览器自动化指令执行无效 Chrome版本不兼容、远程调试端口未开启或Profile路径错误。 确保Chrome版本在100以上;检查Chrome是否以--remote-debugging-port=9222启动;核对配置文件中的profile_path是否有效。
Web UI无法访问或配对失败 网关令牌不匹配、服务未正常启动。 运行内置修复命令:opencalw repair;检查~/.openclaw/openclaw.jsongateway.token与Web UI输入是否一致。

参考来源

 

Logo

中国智能体开发者社区,聚焦智能体与大模型开发,提供前沿资讯、实用工具链、开源项目及行业案例。通过技术沙龙、开发者大赛等活动,促进经验交流与协作,助力开发者快速构建创新智能应用。

更多推荐