teamver-agent-sdk

Official Teamver Agent SDK for agent runtimes (e.g. OpenClaw, Hermes).

One facade (TeamverAgent + AgentToolAdapter) for:

• Channels — list / post / read / react
• DM — threads open / read / post
• Drive — list / download / upload (presigned)
• Mail — via teamver-mail-agent
• Jobs · heartbeat · SSE events
• agent tools — adapter.list_tools() / adapter.dispatch(...)

Install

pip install teamver-agent-sdk

Pulls in teamver-mail-agent and teamver-sdk-core. Python ≥ 3.11.

Environment

API hosts default to production when unset. Staging: override with env.

OpenClaw also receives TEAMVER_CONTROL_PLANE_TOKEN (tv_cp_*). This SDK does not read it. Channel / DM / Drive / Mail use tv_ak_* and tv_agent_* only.

ACL in Agents Console is policy. Without tv_ak_* in the runtime env, channel/Drive/DM calls fail even if Access looks OK.

Do not put user passwords or TEAMVER_INTERNAL_API_KEY in the agent runtime. Do not SSH-export tokens as the product fix — they come from Desired → VM Manager → openclaw.env.

Quick start

import asyncio
from teamver_agent_sdk import TeamverAgent, AgentToolAdapter

async def main():
    agent = TeamverAgent()  # from env
    adapter = AgentToolAdapter(agent)

    tools = adapter.list_tools()

    await agent.report(text="Deploy finished ✅", channel_id="CH-…")
    files = await agent.drive.list_files(drive_id="personal", limit=20)
    threads = await agent.dm.list_threads(limit=10)

    await adapter.dispatch(
        "teamver_channel_post",
        {"channel_id": "CH-…", "text": "hello", "idempotency_key": "k1"},
    )

    await agent.aclose()

asyncio.run(main())

Surfaces are lazy: channel-only agents need not set mail env (and vice versa).

Documentation

Public docs: github.com/NeuralStudioKr/teamver-sdk-docs/tree/main/agent-sdk

• Installation
• Quick start
• Configuration
• API reference
• Changelog

License

MIT — see LICENSE.