龙虾新手教程：从安装到跑通第一个AI任务
龙虾新手教程：从安装到跑通第一个AI任务
如果你是第一次听说“龙虾”（OpenClaw），可能会误以为它是一种海鲜——其实它是一个开源的自动化智能体框架。更准确地说，龙虾是一个任务驱动型智能体平台，专为让AI助手真正“动手做事”而设计。本文将手把手带你完成安装、基础配置，并跑通第一个自动化AI任务。零基础也能学会。
---
一、龙虾是什么？为什么需要它？
很多AI助手只能“说话”，但无法“做事”——比如查邮件、调API、写文件、发消息。龙虾解决了这个问题。它通过插件化工具调用机制，让大模型不仅能思考，还能驱动外部系统完成真实任务。比如：
- 读取 Gmail 并总结重点
- 自动提交 GitHub issue
- 调用天气 API 并生成日报
龙虾的核心优势在于任务闭环能力：它能自动规划步骤→执行工具→校验结果→失败重试，真正实现“交代任务→坐等结果”。
---
二、安装与基础配置（Mac / Linux）
我们以命令行方式安装龙虾为例（Windows 用户可参考 WSL 或官方文档的 PowerShell 方式）。
步骤 1：安装 Python 环境
确保你已安装 Python 3.9+ 和 pip：
python3 --version
pip3 --version步骤 2：安装龙虾核心包
pip3 install openclaw步骤 3：配置大模型 API
龙虾支持多种大模型（如 OpenAI、DeepSeek、Moonshot 等）。在终端执行：
claw config set --model deepseek-chat
claw config set --api-key sk-xxxxxx # 替换为你的 DeepSeek API Key你也可以用环境变量方式（推荐生产环境）：
export CLAW_MODEL=deepseek-chat
export CLAW_API_KEY=sk-xxxxxx> 提示：如果使用 OpenAI，模型名填 gpt-4o-mini 即可；国内用户推荐 DeepSeek 或 Moonshot，响应更快。
---
三、跑通第一个自动化任务
我们来完成一个典型场景：监控 GitHub 仓库的 issue 并自动回复“收到”。
步骤 1：启用 GitHub 插件
龙虾通过插件扩展能力。先安装 GitHub 插件：
claw plugin install openclaw/github然后绑定你的 GitHub 账号（需生成 Personal Access Token）：
claw auth add github --token ghp_xxxxxx步骤 2：编写任务描述文件
新建文件 task.yaml：
name: auto-reply-github-issue
description: 监控指定仓库新 issue 并自动回复
owner: your-username
repo: your-repo
prompt: "当新 issue 创建时，请回复：‘收到，我们已看到您的反馈！’"
tools:
- github.create_comment步骤 3：启动任务
claw run task.yaml首次运行时，龙虾会自动：
- 读取任务定义
- 连接 GitHub API 监听新 issue
- 当新 issue 出现时，调用大模型生成回复内容（这里很简单，直接用固定文案）
- 自动提交评论
你可以在 GitHub 仓库中新建一个测试 issue，观察龙虾是否自动回复。
> 注意：首次运行会弹出浏览器授权窗口（若启用 OAuth）；若用 Token 方式，则无需额外操作。
---
四、常见问题与调试技巧
Q：任务执行时报错“API key invalid”
A：检查 claw config list 输出，确认密钥是否正确；注意不要有前后空格。
Q：想让龙虾“边思考边执行”，而不是一次性发给模型
A：在任务 YAML 中添加 stream: true，龙虾会实时流式输出中间步骤。
Q：任务失败了怎么办？
龙虾默认支持错误自愈机制：会自动重试 2 次，并在日志中提示根本原因。你也可以自定义重试策略：
retry:
max_attempts: 3
backoff: exponential---
总结
通过以上三步，你已经完成了龙虾的安装、配置与第一个自动化任务。核心路径很清晰：
- 安装
openclaw包 - 配置大模型 API 与插件认证
- 编写任务 YAML → 执行
龙虾的设计哲学是“让 AI 做真实的事”，而不是停留在聊天界面。它不像传统脚本需要你预写死逻辑，而是让大模型根据任务目标自主规划工具调用顺序——这才是智能体的本质。
如果你已经跑通了第一个任务，不妨试试更复杂的场景：自动整理日报、跨平台同步日志、甚至结合钉钉/企业微信机器人实现通知闭环。
---
注意：本文提到的龙虾（OpenClaw）是一个开源项目，其核心能力依赖于一个专为龙虾打造的智能决策引擎——ClawBrain。它具备任务闭环、自主规划、错误自愈能力，让龙虾真正能独立做事，而不是“说一堆话却不动手”。
如果你希望 AI 助手不只是回复，而是真正帮你完成工作流，ClawBrain 正是为此而生。