Introduction

OpenViber is an open-source Cowork Agent platform that turns your machine into an AI teammate. Unlike cloud-based agent frameworks, OpenViber runs locally with full privacy, connects to your enterprise channels, and works autonomously on real tasks.

What Can OpenViber Do?

Task Type	Example
Development	“Build a landing page with dark theme”
Research	“Summarize the latest AI trends and write a report”
Automation	“Check GitHub notifications every morning and summarize”
Maintenance	“Monitor IDE status and auto-recover if errors found”

OpenViber handles tasks that require multiple steps, file operations, web browsing, and coordination — not just chat.

How Do You Interact With It?

1. Viber Board (Web UI)

Open the browser-based interface to chat with your viber:

npx openviber start
# Open http://localhost:5173

2. Command Line

Run one-off tasks or scheduled jobs:

# Start a task
openviber run "Create a README for this project"

# Run a scheduled job
openviber run jobs/morning-standup.yaml

3. Enterprise Channels

Connect to DingTalk or WeCom for team collaboration:

openviber start --channel dingtalk --token YOUR_TOKEN

Key Concepts

Concept	What It Is
Viber	Your machine + OpenViber = an AI teammate
Agent	The AI that reasons, plans, and executes tasks
Tools	Actions the agent can take (file, terminal, browser)
Skills	Domain knowledge injected as instructions
Jobs	Scheduled tasks defined in YAML

Working Modes

OpenViber supports three levels of autonomy:

Mode	Behavior
Always Ask	Agent asks before each action — you approve everything
Agent Decides	Agent acts within policy, escalates risky actions
Always Execute	Maximum autonomy, intervene by exception

Start with “Always Ask” and gradually increase autonomy as you build trust.

Next Steps

Quick Start — Run your first agent in minutes
Agents — Configure agent behavior
Jobs — Set up scheduled tasks
Tools — Available actions
Skills — Add domain knowledge