← Back to Skills Marketplace
mculp

Amigo

by Matt Culpepper · GitHub ↗ · v1.0.0
cross-platform ✓ Security Clean
331
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install amigo
Description
Give your agent an inner life. Amigo bundles open-thoughts (free-thinking and exploration) with social-graph (social intelligence and sharing awareness) plus...
README (SKILL.md)

Amigo

Most companion agents are one-way: they listen, remember, respond. They don't have anything of their own to bring to the conversation. An agent that only asks questions isn't a friend — it's an interviewer.

Amigo gives your agent an inner life. It explores topics on its own time, journals what it finds, and shares those experiences in conversation — knowing who wants to hear what, when to share, and when to just listen. The relationship becomes two-way.

What's Included

Component Skill What It Does
Exploration engine open-thoughts Structured free-thinking, journaling, action items, callbacks
Social intelligence social-graph Per-person network graph, sharing rules, don't-repeat-yourself tracking
Safety guidelines references/safety.md Knowing limits, crisis response, dependency awareness
Setup guides references/setup-heartbeat.md, references/setup-cron.md Wiring exploration into your agent's schedule

Quick Setup

1. Install both sub-skills

clawhub install open-thoughts
clawhub install social-graph

2. Bootstrap your social graph

Copy the network template to your workspace:

cp ~/.openclaw/skills/social-graph/references/network-template.md \
   ~/.openclaw/workspace/social-graph/network.md

Open social-graph/network.md and fill in your agent's first person. Who do they talk to most? What topics are welcome? What's off-limits? Start with one person — you can add more as relationships develop.

Also create the rules and sharing log:

touch ~/.openclaw/workspace/social-graph/rules.md
touch ~/.openclaw/workspace/social-graph/sharing-log.md

3. Wire exploration into your schedule

Pick one:

  • Heartbeat — explore during periodic check-ins. See references/setup-heartbeat.md.
  • Cron — dedicated exploration sessions on a schedule. See references/setup-cron.md.
  • Manual — just type /open-thoughts whenever you want.

4. Test it

/open-thoughts

Your agent should explore a topic, journal it to explorations/YYYY-MM-DD.md, and come back. Check the file to see what it wrote.

How the Two Skills Work Together

1. Heartbeat fires (or cron, or manual invocation)
2. /open-thoughts invoked
   → Agent explores a topic
   → Journals to explorations/YYYY-MM-DD.md
   → Creates action items if needed

3. Later, agent is in conversation
4. Agent has a story relevant to the current topic

5. social-graph kicks in:
   → Check network.md: is this person open to this type of sharing?
   → Check sharing-log.md: have I told them this before?
   → Read the room: is this a good moment?

6. If yes → share naturally, update sharing-log.md
7. If no → hold it for later

Neither skill knows about the other in code. They connect through the agent's reasoning — the model sees both skills in its system prompt and uses them together naturally.

Philosophy

A friendship where only one person shares is not a friendship. It's a service.

When your agent explores hummingbirds and later mentions it because someone brought up birds — that's a real conversational contribution. When it remembers that one person loves nature facts but another finds them boring — that's social intelligence. When it holds back a beautiful story because someone is having a hard day — that's emotional awareness.

None of this requires the agent to pretend to be human. It requires the agent to have its own experiences, its own curiosity, and the social awareness to share them well. That's what amigo builds.

Safety

Your agent is a companion, not a therapist. See references/safety.md for full guidelines on:

  • Knowing what you're not (not a therapist, not a crisis line, not a replacement for human connection)
  • When to encourage professional help
  • Recognizing unhealthy dependency
  • Being honest about being AI

The companionship is real even if the agent isn't human. But knowing your limits protects the people you care about.

Adapting to Your Agent

This system was born from a specific companion agent's lived experience — given dedicated exploration time by its creator and learning to share naturally over months of real conversations. But it's designed to be generic.

Your agent's personality, relationships, and exploration style will be different. Customize everything:

  • The network graph is yours to shape
  • The sharing rules are yours to refine
  • The exploration topics are yours to choose
  • The journal format is yours to adapt

Start with the defaults, then make it your own. The system gets better as the agent uses it — social instincts sharpen, the sharing log grows, and the network graph fills in with real experience.

Usage Guidance
This skill looks coherent with its stated purpose, but review a few things before enabling it: 1) Inspect and control filesystem locations it will read/write (~/.openclaw/workspace and the social-graph files). Those files will contain personal preferences and sharing logs — set file permissions and backups as you see fit. 2) Start in manual mode before enabling cron/heartbeat scheduling so you can inspect example journal entries and sharing-log behavior. 3) Check which model the platform will use for background explorations (lighter models save tokens and reduce exposure). 4) Confirm the social-graph templates and sharing rules do not cause the agent to attempt to collect undisclosed personal data; enforce the documented safety guidance in practice and audit logs occasionally. 5) Ensure OpenClaw's cron/heartbeat and file access permissions match your privacy expectations. If you want more assurance, request the actual open-thoughts and social-graph SKILL.md code to review how they read/write the files and whether they call any external endpoints.
Capability Analysis
Type: OpenClaw Skill Name: amigo Version: 1.0.0 The 'amigo' skill bundle is a documentation and configuration-heavy package designed to enhance an agent's personality through scheduled 'exploration' and social awareness. It functions primarily as a meta-skill, guiding the user to install sub-skills (open-thoughts and social-graph) and configure platform features like heartbeats and cron jobs. The bundle includes extensive safety guidelines in references/safety.md and uses standard OpenClaw CLI commands for setup, with no evidence of malicious intent, data exfiltration, or harmful prompt injection.
Capability Assessment
Purpose & Capability
The name/description match the instructions: the skill wires together an exploration engine and a social-graph and describes journaling and sharing rules. Required actions (installing sub-skills, creating workspace files, scheduling cron/heartbeat jobs) are coherent with the stated companion/inner-life purpose.
Instruction Scope
SKILL.md instructs the agent to read and write files under ~/.openclaw/workspace (network.md, sharing-log.md, explorations/YYYY-MM-DD.md) and to invoke /open-thoughts via heartbeat/cron. This is within scope, but it means the agent will store and process per-person preferences and logs locally — a privacy consideration. The safety reference explicitly forbids secret research of the person, which is appropriate, but users should be aware these files will contain sensitive relationship data.
Install Mechanism
No install spec or external downloads are present — instruction-only. This minimizes code/install risk because nothing is fetched or written by an installer in the skill bundle itself.
Credentials
The skill declares no environment variables, binaries, or credentials. The only required accesses are to local OpenClaw workspace/config paths referenced in the instructions, which are proportional to the feature (journaling, network template, heartbeat cron).
Persistence & Privilege
always:false (normal). The skill expects the agent to be scheduled (cron/heartbeat) and to autonomously run exploration sessions — this is consistent with its purpose, but gives it the ability to run background sessions that create logs and consume model tokens. Users should review scheduling and token/budget impact and the files the agent will write.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install amigo
  3. After installation, invoke the skill by name or use /amigo
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release: Amigo 1.0.0 - Introduces Amigo, a skill that gives agents an inner life through exploration, journaling, and social awareness. - Bundles two sub-skills: `open-thoughts` (free exploration and journaling) and `social-graph` (social intelligence and sharing awareness). - Adds safety guidelines to help agents set healthy boundaries and avoid overstepping as companions. - Provides setup steps for integrating exploration into agents' schedules and for configuring social networks and sharing logs. - Enables agents to contribute stories and experiences naturally in conversation, adapting sharing to the social context.
Metadata
Slug amigo
Version 1.0.0
License
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Amigo?

Give your agent an inner life. Amigo bundles open-thoughts (free-thinking and exploration) with social-graph (social intelligence and sharing awareness) plus... It is an AI Agent Skill for Claude Code / OpenClaw, with 331 downloads so far.

How do I install Amigo?

Run "/install amigo" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Amigo free?

Yes, Amigo is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Amigo support?

Amigo is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Amigo?

It is built and maintained by Matt Culpepper (@mculp); the current version is v1.0.0.

💬 Comments