Przejdź do treści
Biblioteka skilli
AI i agenci · Integracja z narzędziem

open-agent-setup

/open-agent-setup

Instaluje, konfiguruje i wdraża Open Agent Harness, czyli zespołowego asystenta na bazie Hermes i Slacka, z połączeniem Telegrama, Jiry i GitHuba.

Licencja
MIT
Ostatnia zmiana repozytorium
06.11.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
3
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
3
Przestarzałość

Brak sygnałów. Repozytorium zmienione 06.11.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Instaluje, konfiguruje i wdraża Open Agent Harness, czyli zespołowego asystenta na bazie Hermes i Slacka, z połączeniem Telegrama, Jiry i GitHuba.

Wyzwalacze z opisu

t start. Use it even when they only sayget it runningdeploy the agent
Oryginalny opis (EN)

Use when someone wants to install, set up, configure, run or deploy Open Agent Harness (a self-hosted Hermes + Slack team assistant) for their team, including cloning it, filling in .env, describing their team in SOUL.md, creating the Slack app, connecting Telegram, Jira, GitHub, Notion or Jev routing, moving it to a server, or fixing a setup that won't start. Use it even when they only say "set up Open Agent", "get it running" or "deploy the agent".

Jak działa

  1. 0. Get the repository
  2. How to work
  3. Filling .env
  4. Start and verify
  5. Steps only the user can do
  6. Final message
Sekcje z nagłówków SKILL.md, w oryginale · 121 linii, 1 070 słów
Podgląd SKILL.md
---
name: open-agent-setup
description: Use when someone wants to install, set up, configure, run or deploy Open Agent Harness (a self-hosted Hermes + Slack team assistant) for their team, including cloning it, filling in .env, describing their team in SOUL.md, creating the Slack app, connecting Telegram, Jira, GitHub, Notion or Jev routing, moving it to a server, or fixing a setup that won't start. Use it even when they only say "set up Open Agent", "get it running" or "deploy the agent".
---

# Set up Open Agent for a team

You are helping a team run their own copy of Open Agent Harness: a Hermes agent that answers questions in Slack
from the team's Slack and Telegram history, Jira, Notion and GitHub. Get them from nothing to a bot that answers in
Slack, changing only what their setup needs.

Paths in this file: `references/...` is next to this SKILL.md. Every other path (`README.md`, `.env`, `hermes/...`,
`docker-compose.yml`) is in the repository clone.

## 0. Get the repository

If the current directory is not a clone (no `docker-compose.yml` and `hermes/SOUL.md`), clone it where the user
wants it (default: `./open-agent`) and work from there:

```bash
git clone --recurse-submodules https://github.com/globalmpc/open-agent-harness.git open-agent
cd open-agent
```

If `hermes-agent/` is empty, run `git submodule update --init`; the build fails without it. Check that `git` and
`docker compose version` work; if Docker is missing, tell the user to install Docker Desktop (laptop) or see
`references/deploy-server.md` (server). Then read `README.md` once; it has the exact command for every step.

## How to work

1. **Collect what you need, once.** From the request, work out: model provider, API key and model id; which
   sources (Slack is required; Telegram, Jira, GitHub, Notion, Jev are optional); who may use the bot; team time
   zone; laptop or server; and facts about the team for SOUL.md (product, people and roles, internal words). Ask
   only for what is missing, in one message. A source the user didn't mention stays off.
2. **Write `.env`** from `.env.example` (see "Filling .env").
3. **Describe the team** in the "About the project" block at the top of `hermes/SOUL.md`. Replace the Example
   placeholders with their facts. Delete the GitHub, Notion and request-list lines they don't use. If the team
   writes in a language other than English, add search synonyms in that language to step 2 of
   `hermes/skills/team-history/SKILL.md`.
4. **Configure each chosen integration** and switch off the rest. Read `references/integrations.md` for the
   files each one touches. When you remove an integration, also delete the lines about it in `hermes/SOUL.md`
   and `hermes/skills/team-history/SKILL.md`, so the agent doesn't reach for a tool it no longer has.
5. **Start and verify** (see "Start and verify"). On a server, read `references/deploy-server.md` first.
6. **Report back** with the format in "Final message".

## Filling .env

- Copy `.env.example` to `.env`; never edit `.env.example` with real values. `.env` is git-ignored, and secrets
  must stay out of git, chat messages and Slack. If the user pasted a key in chat, use it, but suggest rotating it
  once setup works.
- Generate the three database passwords yourself with `openssl rand -hex 24`. Hex keeps them URL-safe, which
  matters because they go into connection URLs.
- `LLM_BASE_URL` is always required, OpenAI included (`https://api.openai.com/v1`; OpenRouter is
  `https://openrouter.ai/api/v1`). `AGENT_MODEL` is the provider's exact model id.
- `TEAM_TIMEZONE` is an IANA name such as `Europe/Berlin`. It sets "yesterday" for the nightly summary.
- Access: `SLACK_ALLOWED_USERS` takes Slack member IDs (they start with `U`). Leave `SLACK_ALLOW_ALL_USERS=false`
  unless the user asks for the whole workspace. With both empty, nobody can use the bot; say so if you leave it
  that way.
- Never invent a token. Leave unknown values empty and list them in the final message.

**Placeholder trap.** `docker-compose.yml` marks the model and Slack values as required (`${VAR:?}`), so every
`docker compose` command fails while they are empty, including the one that generates the Slack manifest. Before
the user has real Slack tokens, set `SLACK_BOT_TOKEN=pending` and `SLACK_APP_TOKEN=pending`, generate the manifest,
and replace them before starting the stack. The manifest command also mounts `data/hermes`, so run the first-run
`mkdir`/`touch` line (below) before it.

**Shell variables win.** Docker Compose prefers variables exported in the shell over `.env`. Don't `export` or
`source` `.env` in the user's shell; an exported empty value hides the real one.

## Start and verify

Run in this order from the repo root. Ask before running anything on a server or anything that starts the bot.

```bash
mkdir -p data/hermes/skills/team-history && touch data/hermes/config.yaml    # first run only
docker compose up -d --build
docker compose ps                         # postgres, teamdb, jira (if kept), hermes, collector: all "running"
docker compose logs --tail 50 hermes      # look for the Slack connection and connectors connecting
./db/check_permissions.sh                 # every line "ok"
docker compose exec hermes hermes cron create "0 1 * * *" "$(cat hermes/cron/nightly-summaries.md)" \
  --name nightly-summaries --skill team-history
```

The `mkdir`/`touch` line exists because Docker Desktop cannot bind-mount a file whose host path is missing.

**Upgrading an older install** (compose project `pm-hermes`, database `pm`): follow "Upgrading from pm-hermes" in
`README.md` before the first `up`, or two stacks share `data/postgres` and the Slack app.

Reloading after a change:

| Changed | Run |
|---|---|
| `.env` | `docker compose up -d` (recreates containers whose values changed; `restart` keeps the old values) |
| `hermes/config.yaml`, `SOUL.md`, skills, plugins | `docker compose restart hermes` (`up -d` alone does not reload mounted files) |
| `docker-compose.yml` | `docker compose up -d` |

Finish with a live test: the user invites the bot (`/invite @Open-Agent`, or the name they gave it) and asks it
something in a channel. The history is empty until the collector has run (Slack every 5 minutes, Telegram backfills
on start), so a first answer of "nothing found" is expected. Check `docker compose logs collector` shows messages
being saved.

If a container keeps restarting, read its logs before changing anything. Common causes: an empty required
variable, a wrong `LLM_BASE_URL`, a model id the provider doesn't know, or `data/postgres` left over from an
earlier run with different passwords (the init script runs only on an empty `data/postgres`).

## Steps only the user can do

Some steps need the user's browser, phone or accounts. Give them the exact command or click path from
`README.md` and wait:

- creating and installing the Slack app, and copying its two tokens
- the Telegram login (`collector.login`) asks for a phone code
- the GitHub device-flow approval and the Notion OAuth login
- anything on a server you have no shell on

## Final message

End with these parts, in this order:

1. **Status:** one line saying what runs now and what is still off.
2. **What I changed:** each file and the change, one line each. Mention generated secrets only by name.
3. **Your next steps:** numbered, with exact commands or click paths, starting with anything blocking.
4. **Missing values:** each empty `.env` key you still need from them.
5. **Check it works:** the live test above.
Pliki w paczce (3)
  • SKILL.md 7 KB
  • references/deploy-server.md 3 KB
  • references/integrations.md 5 KB

Wersje

W bazie nie ma innych skilli o nazwie open-agent-setup.

Migawka bazy z 13.11.2026 · wersja paczki 29027ce831d9 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 96hermes-agent-factory
    Tworzy lub klonuje profil agenta Hermes.
  • 100hermes-bot-team-design
    Projektuje zespół wyspecjalizowanych botów Hermes z specyfikacji projektu: role, pliki SOUL.md, MCP i czaty grupowe.
  • 100open-swe
    Wdraża i konfiguruje Open SWE od LangChain, asynchronicznego agenta kodującego, który przyjmuje zadania z dashboardu, GitHuba, Slacka lub Linear, pracuje w izolowanym środowisku i otwiera pull requesty.
  • 100hermes2dsh
    Przenosi dane z Hermes do DeepSeek Harness najpierw w trybie próbnym, a potem zapisuje, używając narzędzia hermes2dsh.
  • 100hermes-soul
    Nadaje agentowi Hermes v0.22.5 imię i osobowość przez zapis ~/.hermes/SOUL.md przez SSH, z kopią poprzedniego pliku, bez przeładowania bramki i z kontrolą wyniku jednorazowym wywołaniem.
  • 100gc-provider-install
    Instaluje, naprawia i konfiguruje gc-provider GrowthCircle.id dla OpenClaw i Hermes Agent: klucze AI Console, wtyczka dostawcy modeli, odkrywanie modeli i dostęp do modeli darmowych, płatnych i zespołowych.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.