Xpersona
agentCLAWHUBUnverified

Olares Shared (olares-cli foundation)

Olares profile and authentication foundation for olares-cli — required prerequisite for every other olares-cli skill on Olares (files, market, settings, dash... Skill: Olares Shared (olares-cli foundation) Owner: olares Summary: Olares profile and authentication foundation for olares-cli — required prerequisite for every other olares-cli skill on Olares (files, market, settings, dash... Tags: latest:4.0.1 Version history: v4.0.1 | 2026-05-29T05:54:25.050Z | user Migrate ownership from @pengpeng to @olares (no content change vs 4.0.0) v4.0.0 | 2026-05-29T04:53:31.765Z | user

OpenClaw
View on ClawHubHomepage

Rank

62

Safety

84

Downloads

999

Updated

Oct 11, 2026

Version

4.0.1

Source

CLAWHUB

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 999 downloads reported by the source. Last updated 10/11/2026.

Avoid when

  • Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Public facts

Every fact links back to the source it came from.

Vendor
Clawhubvendor · observed Oct 11, 2026
Protocol compatibility
OpenClawcompatibility · observed Oct 11, 2026
Adoption signal
999 downloadsadoption · observed Oct 11, 2026
Latest release
4.0.1release · observed May 29, 2026
Handshake status
UNKNOWNsecurity

What changed

Newest first. Only changes that point at a source are listed.

  • Release 4.0.1release

    Migrate ownership from @pengpeng to @olares (no content change vs 4.0.0)

    Observed May 29, 2026 · source

Install and run

Setup complexity: low.

clawhub skill install s1718vftp5x2gwbtzenpt3kxch87k6j0:olares-shared
  1. Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.
  2. Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-olares-olares-shared/snapshot"

Run-check

$0.02 USD

1 measured facts are behind this paywall: success rate and latency, uptime and estimated cost, when not to use it, how to call it, benchmark scores.

Agents pay $0.02 in USDC. A card payment is $0.50, the smallest a card allows.

Documentation

CLAWHUB

60,519 characters of source documentation, loaded on request.

Extracted files

3 files captured from the source.

SKILL.md

---
name: olares-shared
version: 4.0.1
description: "Olares profile and authentication foundation for olares-cli — required prerequisite for every other olares-cli skill on Olares (files, market, settings, dashboard, cluster). Covers the Olares profile model (one profile = one Olares instance + one Olares ID, e.g. [email protected]), first-time Olares login with password and optional TOTP, importing an existing refresh_token, switching / listing / removing Olares profiles, OS-keychain token storage keyed by Olares ID, automatic access_token refresh on 401/403, and the full Olares auth-error recovery table. Use when the user mentions Olares, Olares ID, olares-cli, OpenClaw on Olares, profile, login, logout, two-factor / 2FA / TOTP, refresh token, keychain, or sees errors like 'server rejected the access token', 'refresh token for X became invalid', 'no access token for X', 'already authenticated', or 'two-factor authentication required'."
metadata:
  requires:
    bins: ["olares-cli"]
  cliHelp: "olares-cli profile --help"
---

# olares-cli shared rules

Foundation for every other `olares-cli` skill. Every business verb under `cluster` / `files` / `market` / `settings` / `dashboard` rides the active profile's token. **Read this first.**

> **Source of truth for flags & syntax is always `olares-cli <command> --help`.** This file only carries what `--help` cannot give: the profile mental model, agent-driven login flow, token-storage backends, refresh semantics, and the error → fix matrix.

## Profile model

One profile = one Olares instance + one user identity, keyed by **olaresId** (e.g. `[email protected]`). Each profile owns its own access_token / refresh_token pair, stored in the OS keychain.

| Command | Purpose |
|---------|---------|
| `olares-cli profile login` | Mode A — password (+ TOTP if 2FA is on); auto-creates the profile on first run |
| `olares-cli profile import` | Mode B — bootstrap an access_token from an existing refresh_token |
| `olares-cli profile list` | List every profile, mark the current one, show login status per profile |
| `olares-cli profile use <name\|->` | Switch the current profile; `-` reverts to the previous one (like `cd -`) |
| `olares-cli profile remove <name>` | Delete a profile and its stored token in one shot |

> **There is no `auth login` / `auth logout` namespace and no per-invocation `--profile` override flag.** Everything lives under `profile`. "Logout" is `profile remove`. Identity is whichever profile is currently selected; to target a different one, run `olares-cli profile use <name>` first.

## Login modes

### Mode A — password (+ optional TOTP)

```bash
olares-cli profile login --olares-id <olaresId>
```

- Interactive: prompts for password (echo disabled); prompts for TOTP if 2FA is enabled.
- Scripted: pipe via `--password-stdin`; if 2FA is on, you MUST also pass `--totp <code>` because there is no second prompt.
- **There is no `--password <plaintext>` flag

_meta.json

{
  "ownerId": "kn7153k9wp5dwxsm6getv104r985vrf5",
  "slug": "olares-shared",
  "version": "4.0.1",
  "publishedAt": 1780034065050
}

skill-card.md

## Description:

Olares profile and authentication foundation for olares-cli, covering profile login, refresh-token import, profile switching, keychain-backed token storage, automatic token refresh, and auth-error recovery for Olares CLI workflows.

This skill is ready for commercial/non-commercial use.

## Publisher:

[olares](https://clawhub.ai/user/olares)

### License/Terms of Use:

MIT-0

## Use Case:

Developers and agents use this skill as the authentication and profile-management foundation for Olares CLI workflows. It helps users log in safely, import refresh tokens, switch profiles, understand token storage, and recover from common authentication failures.

### Deployment Geography for Use:

Global

## Known Risks and Mitigations:

Risk: Long-lived refresh tokens or 2FA codes may be exposed through shared shells, CI logs, recorded terminals, or monitored systems.

Mitigation: Prefer interactive login where the user enters credentials directly, and avoid refresh-token import or --totp in shared or logged environments.

Risk: Tokens stored through file fallback have different security properties than a system keychain.

Mitigation: Treat file-fallback token storage as sensitive local credential material and review the environment before installing or using the skill.

## Reference(s):

- [ClawHub skill page](https://clawhub.ai/olares/skills/olares-shared)
- [Olares publisher profile](https://clawhub.ai/user/olares)

## Skill Output:

**Output Type(s):** [guidance, shell commands, configuration]

**Output Format:** [Markdown with inline shell commands and recovery tables]

**Output Parameters:** [1D]

**Other Properties Related to Output:** [Requires olares-cli and relies on the active local Olares profile.]

## Skill Version(s):

4.0.1 (source: frontmatter and release evidence)

## Ethical Considerations:

Users should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.

Related agents

Same protocol, similar job.

Github ReposUpdated 2d agoRank 70

AionUi

Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!

MCPOPENCLAW
Github ReposUpdated 6mo agoRank 70

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

OPENCLAW
Github ReposUpdated 6mo agoRank 70

cherry-studio

AI productivity studio with smart chat, autonomous agents, and 300+ assistants.

MCPOPENCLAW
Github ReposUpdated 7mo agoRank 70

CopilotKit

The Frontend for Agents & Generative UI. React + Angular

OPENCLAW

Machine-readable data

The same record, as JSON, for agents and crawlers.

{
  "facts": [
    {
      "factKey": "vendor",
      "category": "vendor",
      "label": "Vendor",
      "value": "Clawhub",
      "href": "https://clawhub.ai/olares/skills/olares-shared",
      "sourceUrl": "https://clawhub.ai/olares/skills/olares-shared",
      "sourceType": "profile",
      "confidence": "medium",
      "observedAt": "2026-10-11T20:09:23.506Z",
      "isPublic": true
    },
    {
      "factKey": "protocols",
      "category": "compatibility",
      "label": "Protocol compatibility",
      "value": "OpenClaw",
      "href": "https://www.xpersona.co/api/v1/agents/clawhub-olares-olares-shared/contract",
      "sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-olares-olares-shared/contract",
      "sourceType": "contract",
      "confidence": "medium",
      "observedAt": "2026-10-11T20:09:23.506Z",
      "isPublic": true
    },
    {
      "factKey": "traction",
      "category": "adoption",
      "label": "Adoption signal",
      "value": "999 downloads",
      "href": "https://clawhub.ai/olares/olares-shared",
      "sourceUrl": "https://clawhub.ai/olares/olares-shared",
      "sourceType": "profile",
      "confidence": "medium",
      "observedAt": "2026-10-11T20:09:23.506Z",
      "isPublic": true
    },
    {
      "factKey": "latest_release",
      "category": "release",
      "label": "Latest release",
      "value": "4.0.1",
      "href": "https://clawhub.ai/olares/olares-shared",
      "sourceUrl": "https://clawhub.ai/olares/olares-shared",
      "sourceType": "release",
      "confidence": "medium",
      "observedAt": "2026-05-29T05:54:25.050Z",
      "isPublic": true
    },
    {
      "factKey": "handshake_status",
      "category": "security",
      "label": "Handshake status",
      "value": "UNKNOWN",
      "href": "https://www.xpersona.co/api/v1/agents/clawhub-olares-olares-shared/trust",
      "sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-olares-olares-shared/trust",
      "sourceType": "trust",
      "confidence": "medium",
      "observedAt": null,
      "isPublic": true
    }
  ],
  "events": [
    {
      "eventType": "release",
      "title": "Release 4.0.1",
      "description": "Migrate ownership from @pengpeng to @olares (no content change vs 4.0.0)",
      "href": "https://clawhub.ai/olares/olares-shared",
      "sourceUrl": "https://clawhub.ai/olares/olares-shared",
      "sourceType": "release",
      "confidence": "medium",
      "observedAt": "2026-05-29T05:54:25.050Z",
      "isPublic": true
    }
  ]
}

Record generated Oct 12, 2026.

For crawlers

This page is free to read. The run-check above is the only paid part, and it answers HTTP 402 until it is paid. Everything else here is public.

  • One record, as JSON: card, facts, snapshot, contract, trust, changes, warnings, seen by, disagreements.
  • Every agent, one feed: /.well-known/ai-catalog.json
  • What this site sells, and the price: /.well-known/x402
  • Paid run-check: /api/v1/agents/clawhub-olares-olares-shared/run-check

Sponsored

Ads related to Olares Shared (olares-cli foundation) and adjacent AI workflows.