LocoAgent

LocoAgent 是一个由 AI 驱动的社交媒体智能体，通过真实的浏览器自动化技术自主操作社交媒体账户。它将由 LLM 驱动的智能体循环与 agent-browser CLI 相结合，从而感知、决策并操作实时网页——执行诸如点赞帖子、撰写回复、关注用户以及发布内容等任务。

核心优势：

• 真实浏览器，真实会话 — 通过 Chrome CDP 使用您真实的登录 Cookie 进行操作，而非 API 劫持。
• 平台技能系统 — 注入完整的平台操作手册（如 X.com 拥有 32 种以上操作），使智能体能够一次性完成复杂任务。
• 工作流引擎 — 纯浏览器自动化流水线，无需 LLM 介入即可运行，由智能体作为监督者进行控制。
• 操作日志 — 会话间的持久化去重机制，防止重复操作。
• 多模型供应商支持 — 支持任何与 OpenAI 兼容的 API（OpenRouter、DeepSeek、Ollama 等）。

---

安装

前置要求

要求	版本	备注
Bun	最新版	运行时和包管理器
Node.js	>= 18	部分依赖项必需
agent-browser	最新版	浏览器自动化 CLI
Git	任意版本	用于上下文功能

设置

git clone https://github.com/LocoreMind/locoagent.git
cd locoagent
bun install

配置

在项目根目录下创建一个 .env 文件（启动时会自动加载）：

# LLM Provider (pick one)

# Option A: OpenRouter (access 200+ models)
CLAUDE_CODE_USE_OPENAI=1        # Enable OpenAI-compatible provider
OPENAI_API_KEY=sk-or-v1-...
OPENAI_BASE_URL=https://openrouter.ai/api/v1
OPENAI_MODEL=anthropic/claude-sonnet-4.5

# Option B: DeepSeek (with thinking mode support)
CLAUDE_CODE_USE_OPENAI=1
OPENAI_API_KEY=sk-...
OPENAI_BASE_URL=https://api.deepseek.com
OPENAI_MODEL=deepseek-v4-flash

# Option C: Anthropic direct (omit CLAUDE_CODE_USE_OPENAI)
ANTHROPIC_API_KEY=sk-ant-...

# Agent behavior
SKIP_PERMISSIONS=1               # Required for non-interactive/automated mode

运行

# Interactive mode
bun start

# Single query (headless)
bun start -p "open X.com and like the first post about AI agents"

# With specific model
bun start --model anthropic/claude-sonnet-4.5

---

模型供应商

LocoAgent 通过内置的转换适配器支持任何与 OpenAI 兼容的 API。系统的其余部分与具体的供应商无关。

供应商	Base URL	备注
OpenRouter	https://openrouter.ai/api/v1	访问 200 多种模型
DeepSeek	https://api.deepseek.com	完全支持思维模式 (reasoning_content)
OpenAI	https://api.openai.com/v1	GPT-4o, o1 等
Ollama	http://localhost:11434/v1	本地模型
LM Studio	http://localhost:1234/v1	本地模型
Anthropic	(native SDK)	仅需设置 ANTHROPIC_API_KEY
AWS Bedrock	(native SDK)	使用 AWS 凭证
Google Vertex AI	(native SDK)	使用 GCP 凭证

---

浏览器自动化

LocoAgent 使用 agent-browser CLI 通过 CDP (Chrome DevTools Protocol) 控制真实的 Chrome 浏览器。

为什么选择 Chrome CDP？

社交媒体平台会检测并封禁无头浏览器及基于 API 的自动化行为。LocoAgent 通过克隆您真实的 Chrome 配置文件进行操作——拥有相同的 Cookie、相同的登录会话和相同的浏览器指纹。

设置

# One-time: copy Chrome profile + launch with CDP
bun run setup-chrome

# agent-browser connects to the running Chrome
agent-browser connect 9222

智能体如何使用它

agent-browser open https://x.com/home        # Navigate
agent-browser snapshot -i                      # Perceive: get interactive elements with @ref IDs
agent-browser click @e5                        # Act: click a like button
agent-browser fill @e3 "Great research!"       # Act: type in a reply box
agent-browser screenshot result.png            # Verify: capture result

完整的 agent-browser CLI 参考手册已嵌入智能体的系统提示词中，因此它原生知晓所有命令。

---

平台技能

技能是通过斜杠命令按需加载的操作手册。每项技能都会将完整的手册注入智能体的上下文，使其能够一次性执行组合任务。

可用技能

平台	命令	操作数量	描述
X.com	/x-com	32+	浏览、互动、发帖、社交图谱、个人资料、导航、列表等

使用方法

# Interactive: load skill then give task
> /x-com open home timeline, like first 3 posts about AI, reply to the best one

# Headless
bun start -p "/x-com like 5 posts about 'large language models', then follow the authors"

添加新平台

mkdir -p skills/linkedin

创建 skills/linkedin/SKILL.md：

---
descri