AGB Python SDK

AGB Cloud SDK 为开发者提供 AI 原生、跨平台的沙箱环境，包含多模态云端运行时与专家 Agent。

---

🔥 Moltbot（原 Clawdbot）快速部署

你可以使用 AGB SDK 在几分钟内启动预构建的 Moltbot 云桌面，并在桌面浏览器中打开 Moltbot 控制台。

• Cookbook (Discord): docs/examples/openclaw/openclaw_discord_config_example.py — 创建会话，运行 openclaw 配置（Bailian/Discord），并获取云桌面 URL。
• Cookbook (Slack): docs/examples/openclaw/openclaw_slack_config_example.py — 创建会话，运行 openclaw 配置（Bailian/Slack），并获取云桌面 URL。
• Cookbook (Telegram): docs/examples/openclaw/openclaw_telegram_config_example.py — 创建会话，运行 openclaw 配置（Bailian/Telegram），并获取云桌面 URL。
• 云桌面 URL: 示例代码会打印 session.resource_url 并暂停，方便你进行手动探索。
• Moltbot 控制台: 在云桌面内打开 http://127.0.0.1:18789。

---

AGB Cloud SDK 提供用于与 AGB 云服务交互的客户端库。

功能特性

• 在 AGB 云环境中创建和管理会话
• 支持文件系统、命令执行和代码执行模块
• 具备 AI 驱动的自然语言操作能力的浏览器自动化
• 支持同步策略的持久化上下文管理

🎯 场景化功能

• Computer Use - Linux 计算机控制（鼠标、键盘、窗口、应用程序、屏幕）
• Browser Use - Web 自动化、网页抓取及浏览器控制
• CodeSpace - 代码执行和开发环境

安装

# Python
pip install agbcloud-sdk

# TypeScript
npm install agbcloud-sdk

快速开始

Python

from agb import AGB
from agb.session_params import CreateSessionParams

# 使用你的 API key 初始化 AGB
agb = AGB(api_key="your-api-key")

# 创建会话
params = CreateSessionParams(
    image_id="agb-code-space-1",
)
result = agb.create(params)

if result.success:
    session = result.session

    # 执行 Python 代码
    code_result = session.code.run("print('Hello AGB!')", "python")
    print(code_result.result)

    # 执行 Shell 命令
    cmd_result = session.command.execute("ls -la")
    print(cmd_result.output)

    # 操作文件
    session.file.write("/tmp/test.txt", "Hello World!")
    file_result = session.file.read("/tmp/test.txt")
    print(file_result.content)

    # 清理资源
    agb.delete(session)
else:
    print(f"Failed to create session: {result.error_message}")

TypeScript

import { AGB, CreateSessionParams } from "agbcloud-sdk";

// 使用你的 API key 初始化 AGB
const agb = new AGB({ apiKey: "your-api-key" });

// 创建会话
const params = new CreateSessionParams({ imageId: "agb-code-space-1" });
const result = await agb.create(params);

if (result.success && result.session) {
  const session = result.session;

  // 执行 Python 代码
  const codeResult = await session.code.run("print('Hello AGB!')", "python");
  console.log(codeResult.results[0]?.text);

  // 执行 Shell 命令
  const cmdResult = await session.command.execute("ls -la");
  console.log(cmdResult.stdout);

  // 操作文件
  await session.file.writeFile("/tmp/test.txt", "Hello World!");
  const fileResult = await session.file.readFile("/tmp/test.txt");
  console.log(fileResult.content);

  // 清理资源
  await agb.delete(session);
} else {
  console.error(`Failed to create session: {result.errorMessage}`);
}

文档

获取完整的文档、指南和示例，请访问：

📚 完整文档

• 快速入门指南 - 通过基础示例快速上手
• 用户指南 - 全面的指南和教程
• API 参考 - 详细的 API 文档
• 示例 - 实际使用场景示例

开发指南

Python

cd python
python -m venv .venv
source .venv/bin/activate  # Windows 下使用: .venv\Scripts\activate
pip install -e ".[dev,test]"

TypeScript

cd typescript
npm install
npm run build
npm test

获取帮助

• GitHub Issues

联系方式

欢迎访问我们的产品官网并加入我们的社区！

• AGB 产品官网: https://agb.cloud/
• AGB 控制台: https://agb.cloud/console/overview
• Discord 社区: 加入 Discord

许可证

本项目采用 Apache License 2.0 许可证 - 详情请参阅 LICENSE 文件。