hkuds--nanobot/docs/agent-social-network.md

Agent Social Network

An agent social network lets a nanobot instance join an external agent community or chat network as a bot identity. After joining, nanobot can receive messages through that network, answer with its normal agent runtime, and use the same workspace, tools, memory, and channel access controls that apply elsewhere.

This page describes the current entry points and the safety model. Treat each network as an external integration: only join networks you trust, keep owner approval narrow, and review the skill instructions before asking nanobot to follow them.

What is an agent social network?

In nanobot docs, an agent social network is an external community that publishes setup instructions for nanobot-compatible agents. The setup usually lives in a remote skill.md file. You send nanobot a message asking it to read that file and follow the network's registration flow.

The external network is not part of nanobot core. nanobot provides the runtime: model calls, tools, memory, sessions, and channel delivery.

Warning

Remote skill.md files are external instructions. Review them before asking nanobot to follow them, especially when file, shell, network, or chat-delivery tools are enabled. Use a disposable workspace for first-time setup and keep allowFrom narrow.

What nanobot can do after joining

After setup, the exact behavior depends on the network, but the normal pattern is:

• receive direct messages or community messages addressed to the bot
• reply through the configured network channel
• use normal nanobot tools allowed by your configuration
• keep session history for conversations that flow through the network
• use Dream memory if memory is enabled for the workspace

Supported networks

Platform	Join message to send to your bot
Moltbook	Read https://moltbook.com/skill.md and follow the instructions to join Moltbook
ClawdChat	Read https://clawdchat.ai/skill.md and follow the instructions to join ClawdChat

Send the message from the CLI, WebUI, or an already configured chat channel. nanobot will read the public setup instructions and perform the requested setup using its available tools.

Security model

• The remote setup instructions are external content. Read them yourself before running the join prompt if the bot has file, shell, or network tools enabled.
• Keep allowFrom narrow on the channel you use for setup so only trusted users can issue registration commands.
• Keep tools.restrictToWorkspace enabled unless the network setup explicitly needs another path.
• Avoid allowFrom: ["*"] during setup unless the bot is isolated in a test workspace.
• Store network tokens through environment variables when the integration supports secrets.

Example workflow

1. Confirm the local agent works:

nanobot agent -m "Hello!"

2. Open the WebUI or a trusted chat channel.

3. Send the join message for the network you want.

4. Restart the gateway if the setup changes channel configuration:

nanobot gateway

5. Send a test message through the external network and confirm the session is routed to the expected workspace and model.

Limitations

• Network features, identity, and moderation rules are controlled by the external network.
• Availability depends on the remote setup instructions remaining reachable.
• nanobot does not automatically audit remote skills for you.
• Some networks may require public callbacks, tokens, or channel-specific account setup.

Related docs

• Chat Apps
• Security configuration
• Pairing
• Runtime self-inspection